Skip to content

Latest commit

 

History

History
70 lines (44 loc) · 2.49 KB

EXPLANATION-end-to-end-tests.md

File metadata and controls

70 lines (44 loc) · 2.49 KB
Raw

Summary

Selenium

End to end tests use Selenium, which is a framework which drives the WebDriver API exposed by browsers. A test script can therefore be executed at the UI level which is as close to a manual test as possible.

Sauce Labs

Sauce Labs is a cloud service which provides access to test clients on which automated tests are run.

In order to run tests on Sauce Labs, environment variables need to get set on your environment:

The access keys SAUCE_USERNAME and SAUCE_ACCESS_KEY is set in the "Environment Variables" section of Travis-CI

To run tests against your localhost on Sauce Labs clients, you must first setup Sauce Labs Connect.

Reporting is setup between Sauce Labs and Travis CI using a Jasmine custom reporter and console stdout in the tests.

Test Writing

Jest / Jasmine

Jest is the test runner which locates, runs and summarizes the tests.

Reference: Jest 22.4 docs

Jasmine is the BDD test framework used by many test harnesses including Jest.

Example of a Jasmine block:

describe('test description', () => {
  it('step description', async () => {
    // Operations
  })
})

A note on this: Arrow functions lexically bind the this keyword. This interferes with how the test runner wants to use the this keyword for context. More information is available online.

Reference: Jasmine 2.0 docs

Example of a validation statement:

const url = await driver.getCurrentUrl()
expect(url).toContain('www.example.com')

Selectors

Example of an attribute for end to end selectors:

import { dataTest } from '../lib/attributes'
<Control
  {...dataTest('someValue')}
  ...
/>

This adds a data-test attribute to the non-production rendered HTML and indicates to future developers that this control is used in automated tests.

Helpers

In ./Spoke/__test__/e2e/util/helpers.js you'll find a helper named wait. This is an important collection of methods for interactive commands like click.

await wait.andClick(driver, <locator>)