timetraveler90 / snaptest-harness

Snaptests nightwatch harness.

SnapTEST NightwatchJS Harness

1. Install dependencies

(MacOS)

• Install NodeJS. ( via homebrew or https://nodejs.org ).
• Clone this repo git clone <url>
• Run npm install in the cloned repository
• Download chromedriver and copy to /usr/local/bin (or any folder that makes it available on your path)

(Windows)

• Install NodeJS. ( via https://nodejs.org ).
• Clone this repo git clone <url>
• Run npm install in the cloned repository
• Download chromedriver and copy to %systemroot%\System32 (or any folder that makes it available on your ENV path)

2. Add the test

• Copy and paste the SnapTEST generated code into the tests/harness.js file.

3. Run the test

• Kick off the test by running npm test.

---

Advanced usage

Adding multiple tests

Any file within the tests/ folder is available to be run as a test. Add more tests to this folder, eg. /tests/login.js, and build your test library. To run all the tests in the tests/ folder, use npm test.

Organizing and scaling execution of tests

If you're working on a larger project, you will need to work on organizing your test files. the tests/ folder supports one folder deep, so you can do the following:

`tests/newuser/registerandonboard.js`
`tests/returninguser/changepassword.js`

For further abstraction, you can add a scripts entry in the package.json, create a separate nightwatch.js/on config that points to a different folder than test/.

Example: Setting up seperate job between development(build tests) and production(smoke tests):

package.json:

"scripts": {
    "test-dev": "./node_modules/.bin/nightwatch -c nightwatch-dev.js"
    "test-prod": "./node_modules/.bin/nightwatch -c nightwatch-prod.js"
}

nightwatch-dev.js:

{
  "src_folders" : ["tests/dev/"],
  ...
}

nightwatch-dev.js:

{
  "src_folders" : ["tests/prod/"],
  ...
}

For more configuration options, please visit Nightwatch's documentation

Running single tests

After you've built a lot of tests, you may want to run only one to save time. Use this command: ./node_modules/.bin/nightwatch -t test/harness.js

Test setup/teardown advice

Making QA tests is complicated in many ways which SnapTEST tries to solve. Unfortunately, we can't solve them all, and one is that setting up and tearing down test data can be tricky. This is complicated because each project has unique challenges in this area. You will need to solve the issue for your case, or just be careful to make tests that always start inherently fresh (like registering a new user).

eg: Your test logs in and changes a users password. The second time it runs, the password will be changed and not be able to log in and fail.

Tests need to start "fresh". Setting up and tearing down a user every time you run the test is the way to solve the issue. For prehook and posthooks of your nightwatch tests, use these helper methods:

  before : function(browser, done) {
    // setup your test data
    done();
  },
  after : function(browser, done) {
    // tear down your test data
    done();
  },
  beforeEach : function(browser, done) {},
  afterEach : function(browser, done) {},