International waste shipments training acceptance tests

Acceptance tests for the International waste shipments training service

Pre-requisites

• Node 8
• Chrome driver (http://chromedriver.chromium.org/home)

Configuration

1. Clone the repo and run npm install
2. Add a valid BROWSERSTACK_USERNAME and BROWSERSTACK_AUTH_KEY to your environment variables to enable that integration.
3. Add a valid IWS_SERVICE_URL value to your environment variables unless running tests locally.

Usage

By default, it is set up to run tests using the npm test command.

You can also lint your code with npm run lint or npm run lint-fix to auto correct.

This repo includes:

• Chai with expect global
• Chai WebdriverIO
• Browserstack integration
• Visual Regression Tests
• ESLint using [Standard style]
• [WebdriverIO tuned Gitignore file]

Folder Structure

Cucumber features go in the src\features folder with .feature extension.

Tests and page objects go in the \spec\js\step_definitions\ folder and \spec\js\pages respectivly, which you'll need to create.

Name tests with a .step.js extension. For example: mytest.step.js

Name Page Object files with a .page.js extention. For example: mypageobject.page.js

Visual regression screenshots will be saved to the screenshots folder.

Debug Command Line Flag to adjust timeout

By setting the 'DEBUG' environment variable to true, the test timeout with be essentially removed, allowing you to run the debug command without your tests timing out.

DEBUG=true npm test

Configuration file flavors

By default, tests will run locally: npm test

To run the tests using Browserstack, run:

npm run bstest

Configurations

WebdriverIO configurations can be passed in via a double-dash (i.e. --).

For example, to run a single test file, use the WDIO spec flag: npm test -- --spec=login

The double dash indicates that the remaining options should be sent to the command that NPM is running, not NPM itself.

In the previous example everything after -- goes to WDIO.

A few more examples:

To change the log level, pass in a --logLevel flag: npm test -- --logLevel=verbose

To specify a certain web server, pass in a baseUrl flag: npm test -- --baseUrl=http://url.of.server

License

THIS INFORMATION IS LICENSED UNDER THE CONDITIONS OF THE OPEN GOVERNMENT LICENCE found at:

http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3

The following attribution statement MUST be cited in your products and applications when using this information.

Contains public sector information licensed under the Open Government license v3

About the license

The Open Government Licence (OGL) was developed by the Controller of Her Majesty's Stationery Office (HMSO) to enable information providers in the public sector to license the use and re-use of their information under a common open licence.

It is designed to encourage use and re-use of information freely and flexibly, with only a few conditions.