@sa11y/assert

@sa11y/assert

Provides assertAccessible API to check DOM for accessibility issues

• Usage

Usage

import { assertAccessible } from '@sa11y/assert';
import { full } from '@sa11y/preset-rules';

// Setup DOM in the state to be tested for accessibility
// ...
// Assert that the current dom has no a11y issues
// Defaults to using
//  - default document context e.g. JSDOM in Jest
//  - base ruleset from @sa11y/preset-rules and
//  - A11yError.checkAndThrow from @sa11y/format
await assertAccessible();

// Can be used to test accessibility of a specific HTML element
const elem = document.getElementById('foo');
await assertAccessible(elem);

// Can be overridden to use custom dom, ruleset or formatter
//  - Specifying null for formatter will result in using JSON stringify
await assertAccessible(document, full, null);

Changelog

3.0.2 (2021-11-02)

Reverts

• filtering of non-a11y results introduced in 3.0.1
  • as it is causing issues with certain CI workflows that produce no test results file