assertion-utilities

What problem does it solve?

Centralizes and standardizes test validations across Playwright projects, reducing duplication and easing maintenance by providing a unified API for both value-based and DOM-based checks.

Core Features & Use Cases

• AssertUtils for value-based validations (strings, numbers, API responses) to ensure consistent error messages.
• ExpectUtils for DOM-based validations (visibility, text, attributes) using Playwright's expect.
• Assertions as a single gateway combining both, with optional soft-assertion mode to collect multiple failures before reporting.
• Designed for easy integration with fixtures and page objects in large test suites.

Quick Start

Install Playwright in your project, then import and instantiate the assertions gateway in your tests:

• const assertions = new Assertions(page);
• assertions.assert().assertEqual(actual, expected);
• await assertions.expect().toBeVisible(someLocator);