Skip to content

Boilerplate repo for quick set up of WebdriverIO test scripts with TravisCI, Sauce Labs and Visual Regression Testing

License

Notifications You must be signed in to change notification settings

jordandlaman/wdio-starter-kit

 
 

Repository files navigation

Build Status js-semistandard-style

WebdriverIO Starter Kit

Boilerplate repo for quick set up of WebdriverIO test scripts with TravisCI, Sauce Labs and Visual Regression Testing

Configuration

  1. Clone the repo and run npm install
  2. Add a valid SAUCE_USERNAME and SAUCE_ACCESS_KEY to your environment variables to enable that integration. (Settting up Sauce)
  3. Update the 'baseUrl' property in wdio.conf.js and wdio.conf.local.js
  4. Create a 'test' folder and place your tests in it

Usage

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

You can also lint your code with npm run lint.

This kit features:

More Details

Starter Test Cases

Because login and registration pages are ubiquitous on websites, I've included two test files with corresponding page objects.

You'll very likely need to replace the selectors used in the page objects.

You'll also want to update the isLoggedIn and isRegistered functions in the page objects to return the proper response.

Folder Structure

Tests and page objects go in the test\ folder, which you'll need to create.

Name tests with a .spec.js extension. For example: mytest.spec.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.

TravisCI Integration

This kit includes a basic .travis.yml file set up to allow easy integration with their service. Simply enable your repo in TravisCI and you'll get it up and running. And be sure to update the badge information at the top of this file.

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 in Sauce Labs testing your production server.

To run the tests entirely locally, run:

npm test -- wdio.conf.local.js

About

Boilerplate repo for quick set up of WebdriverIO test scripts with TravisCI, Sauce Labs and Visual Regression Testing

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%