QA Suite

QA suite for running automated tests on websites, powered by Docksal.

Features:

Behat 3.x
BackstopJS 2.x
PhantomJS, SlimerJS (with Firefox ESR), CasperJS

Setup instructions

Step #1: Docksal environment setup

This is a one time setup - skip this if you already have a working Docksal environment.

Follow Docksal environment setup instructions

Step #2: Project setup

Clone this repo into your Projects directory

git clone git@github.com:docksal/qa-suite.git qa-suite
cd qa-suite

Initialize the stack
```
fin init
```
Make sure to follow on-screen directions.

Usage

Behat

Run all features under tests/behat/features

fin behat

Run a particular feature

fin behat features/blackbox.feature

BackstopJS

Take reference screenshots

fin backstop reference --config=backstop-example.json

Take test screenshots and compare

fin backstop test --config=backstop-example.json

By default, BackstopJS is using PhantomJS to take screenshots.
You can also use SlimerJS/Firefox by setting "engine": "slimerjs" in the configuration file.

Pre-configured sample commands

Pre-configured commands are in .docksal/commands.
They can be used as shortcuts/alternative to typing long lists of arguments every time.

Run sample BDD (behavior-driven development) tests with Behat

fin behat-example

Open http://qa-suite.docksal/tests/behat/reports/html/

Run sample VRT (visual regression testing) tests with BackstopJS

fin backstop-example

Open http://qa-suite.docksal/tests/backstop/data/example/reports/html/

Debugging

For tests that utilize Chrome/Firefox via Selenium (@javascript tests), you can watch the browser in real time inside the container with VNC Viewer.

Connect to 192.168.64.100:5900, password: secret.