testing-and-linting.md

Testing and linting

The CI lints SASS and JavaScript, and runs unit and functional tests with Node.

Running all tests locally

To check the whole codebase, run:

npm test

This will trigger standard and sass-lint for linting, and Jest for unit and functional tests.

See Tasks for details of what npm test does.

SASS linting

See CSS Coding Standards for details.

Javascript linting

See JavaScript Coding Standards for details.

Unit and functional tests with Node.js

We use Jest for testing individual Components (see [component-name].test.js inside component directory) and global Sass files.

Running individual tests

You can run a subset of the test suite that only tests components by running:

`npm test -- src/components/button`

Note: There's a watch mode that keeps a testing session open waiting for changes that can be used with:

`npm test -- --watch src/components/button`

Updating component snapshots

Snapshot tests are used for preventing unintended changes - when the snapshot test runs, it compares the previously captured snapshot to the current markup. For components, the snapshots are stored in [component-name directory]/_snapshots_.

If a snapshot test fails, review the difference in the console. If the change is the correct change to make, run:

npm test -- -u src/components/button

This will update the snapshot file. Commit this file separately with a commit message that explains you're updating the snapshot file and an explanation of what caused the change.