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
.