@cxl/spec

This library provides a comprehensive testing framework tailored for browser environments, offering utilities for defining tests, assertions, DOM manipulations, event handling, mocking, spying, and accessibility checks.

Project Details

• Branch Version: 1.0.1
• License: Apache-2.0
• Documentation: Link
• Report Issues: Github

Installation

npm install @cxl/spec

Features

• Define synchronous and asynchronous tests and test suites with Test and TestApi.
• Assertions for equality, partial matching, buffer comparison, throwing errors, and custom assertions.
• DOM manipulation helpers and connected test DOM containers.
• Event expectation and testing utilities with promise-based APIs.
• Mocking and spying of functions and properties.
• Accessibility testing integration.
• Advanced time mocking for setTimeout, setInterval, and requestAnimationFrame.
• Actions like hover, tap, click, type, and press with runner command integration.
• Figure-based visual testing support.
• Structured JSON result output for tests.

Defining Tests

import { spec } from '@cxl/spec';

spec('Example test', async test => {
	test.ok(true, 'This test should pass');
	test.equal(1 + 1, 2, 'Math works');

	await test.testElement('test a DOM element', async a => {
		const el = a.element('div');
		a.ok(el instanceof HTMLElement, 'Element created');
	});
});