@gr2m/frontend-test-setup

frontend-test-setup

reusable test setup for mocha, chai, browserify, webdriver, saucelabs & travis

Install

npm install --save @gr2m/frontend-test-setup

Usage

Add a "frontend-test-setup" key to your package.json

  "frontend-test-setup": {
    "server": {
      // path to static files
      "cwd": "demo",
      // browserify: path: module
      "browserify": {
        "/bundle.js": "demo/vendor.js",
        "/smartdate-input.js": "index.js"
      }
    }
    // see more options below
  }

Set your scripts to

  "scripts": {
    "start": "frontend-test-server",
    "test": "frontend-test-background mocha test/*.js",
  }

Replace mocha test/*.js in "test" with whatever your mocha test command.

You must require '@gr2m/frontend-test-setup' in your tests

require('@gr2m/frontend-test-setup')

describe('my demo page', function () {
  this.timeout(90000)

  it('loads successfully', function () {
    return this.client
      .url('/')
      .getTitle().should.eventually.equal('foo')
  })
})

frontend-test-setup plays nicely with Travis. If you want to test using selenium, make sure to only test in Firefox as it's the only supported browser, and add the following lines:

before_install:
  - export DISPLAY=:99.0
  - sh -e /etc/init.d/xvfb start

Set SAUCELABS_USERNAME & SAUCELABS_ACCESS_KEY as env variables, and test as many different browser configurations using the env.matrix setting, e.g.

env:
  matrix:
  - CLIENT=selenium:firefox
  - CLIENT=saucelabs:chrome
  - CLIENT="saucelabs:internet explorer:10:Windows 8"
  - CLIENT="saucelabs:iphone:8.4:OS X 10.11"

Options

frontend-test-setup can be configured in your package.json, simply add a "frontend-test-setup" with the options below. Options with a . delimiter are nested, e.g. log.level means log: {level: '...'}.

All settings in package.json can be overwritten using ENV variables, listed below the option name.

Setting (ENV)

Default / Example

client (CLIENT) (saucelabs|selenium):browserName:browserVerion:platform, e.g. 'saucelabs:internet explorer:10:win10' </td> <td><code>'selenium:chrome'</code></td> </tr> <tr> <td> <strong>timeout</strong><br> (<code>TIMEOUT</code>)<br><br> mocha test timeout in milli seconds </td> <td><code>180000</code></td> </tr> <tr> <td> <strong>log.level</strong><br> (<code>LOG_LEVEL</code>)<br><br> one of the following: <code>error</code>, <code>warn</code>, <code>info</code>, <code>verbose</code>, <code>silly</code> </td> <td><code>'error'</code></td> </tr> <tr> <td> <strong>server.host</strong><br> (<code>SERVER_HOST</code>)<br><br> hostname for test server </td> <td><code>'0.0.0.0'</code></td> </tr> <tr> <td> <strong>server.port</strong><br> (<code>SERVER_HOST</code>)<br><br> port number for test server </td> <td><code>8080</code></td> </tr> <tr> <td> <strong>server.cwd</strong><br><br> path from where to server static assets. If <code>server.cmd</code> is set, it runs the command in the given path (relative to repository’s root) </td> <td><code>'.'</code></td> </tr> <tr> <td> <strong>server.browserify</strong><br><br> Map of assets to be browserified. The example below will browserify <code>index.js</code> and at <code>http://&lt;server.host&gt;:&lt;server.port&gt;/my-lib.js&lt;/server&gt;</code> "browserify": { "/my-lib.js": "index.js" } </td> <td><code>{}</code></td> </tr> <tr> <td> <strong>server.cmd</strong><br> (<code>SERVER_CMD</code>)<br><br> Command to start custom server </td> <td>e.g. <code>'npm start'</code></td> </tr> <tr> <td> <strong>selenium.hub</strong><br> (<code>SELENIUM_HUB</code>)<br><br> Url to selenium hub </td> <td><code>'http://localhost:4444/wd/hub/status'</code></td> </tr> <tr> <td> <strong>saucelabs.username</strong><br> (<code>SAUCELABS_USERNAME</code>)<br><br> Saucelabs username for authentication </td> <td>e.g. <code>'pat'</code></td> </tr> <tr> <td> <strong>saucelabs.accessKey</strong><br> (<code>SAUCELABS_ACCESS_KEY</code>)<br><br> Saucelabs access key for authentication </td> <td>e.g. <code>'abcd5678-1234-1234-1234-abcd5678abcd'</code></td> </tr> <tr> <td> <strong>saucelabs.desiredCapabilities.idle-timeout</strong><br> (<code>SAUCELABS_IDLE_TIMEOUT</code>)<br><br> <a href="https://docs.saucelabs.com/reference/test-configuration/#idle-test-timeout">SauceLabs Idle Test Timeout</a> </td> <td><code>90</code>, allowed maximum is <code>1000</code></td> </tr> <tr> <td> <strong>saucelabs.desiredCapabilities.max-duration</strong><br> (<code>SAUCELABS_MAX_DURATION</code>)<br><br> <a href="https://docs.saucelabs.com/reference/test-configuration/#maximum-test-duration">SauceLabs Maximum Test Duration</a> </td> <td><code>1800</code>, allowed maximum is <code>10800</code></td> </tr> <tr> <td> <strong>saucelabs.desiredCapabilities.max-duration</strong><br> (<code>SAUCELABS_COMMAND_TIMEOUT</code>)<br><br> <a href="https://docs.saucelabs.com/reference/test-configuration/#command-timeout">SauceLabs Command Timeout</a> </td> <td><code>300</code>, allowed maximum is <code>600</code></td> </tr>

License

MIT