avajs/ava
55.6
Adequate · 15 November 2026
15.1k
lines of production code
JavaScript
primary language
4
measurements over time
What this system is
Features
Add project logo asset
The media directory now includes a new SVG logo file (media/logo.svg) featuring the project's visual identity with animated opacity effects, providing a branded asset for documentation and display purposes.
media · high confidence
Introduce experimental shared workers and improve worker lifecycle stability
The worker subsystem now supports experimental shared workers, allowing test files to register a single worker instance that persists across multiple test files via \registerSharedWorker\ (enabled only when \workerThreads\ is true). To address worker thread termination crashes, the worker lifecycle has been hardened: the worker is kept alive until explicitly freed, \process.exit()\ calls from tests are intercepted and reported rather than causing silent crashes, and unhandled promise rejections are properly surfaced. Additionally, line-number selection now fully supports source maps, correctly handling null maps and missing original values to ensure accurate test selection in transpiled environments.
lib/worker · high confidence
Introduce shared workers for plugin communication
Added shared worker support to the plugin system, allowing plugins to communicate with test workers via a shared worker thread rather than individual ports. This change introduces \lib/plugin-support/shared-workers.js\ and \lib/plugin-support/shared-worker-loader.js\ to manage worker lifecycle, message routing, and deregistration, enabling more efficient inter-process communication for plugins that require persistent state or high-frequency messaging.
lib/plugin-support · high confidence
New StackBlitz examples for AVA features
Added new interactive StackBlitz examples demonstrating endpoint testing, test macros, test timeouts, TypeScript usage (including basic setup and typing t.context), command-line features like matching titles and specific line numbers, and custom TAP reporters. These examples provide ready-to-run templates for users to explore AVA's capabilities directly in the browser.
examples · high confidence
New TypeScript type definitions for assertions, test context, and state events
The package now ships with a comprehensive set of TypeScript declaration files (types/assertions.d.ts, types/test-fn.d.ts, types/state-change-events.d.ts, etc.) that define the shapes of the assertion API (including throws/throwsAsync expectations), the test execution context (ExecutionContext, TeardownFn), and internal state-change events. This enables strict type-checking for test code, ensuring that assertion methods, test hooks, and worker communication interfaces are used correctly.
types · high confidence
Architecture
Complete rewrite of AVA core to a modular, ESM-native architecture
The AVA test runner has been completely rewritten from the ground up, replacing the previous monolithic structure with a modular, ESM-first codebase. This change introduces a new public API (\lib/api.js\) that exposes test execution as an event stream, allowing for better integration and programmatic control. The internal architecture has been split into distinct, focused modules: \lib/assert.js\ now handles all assertion logic and error formatting using Concordance, \lib/create-chain.js\ manages the test and hook chaining syntax (e.g., \test.serial\, \test.skip\), and \lib/globs.js\ handles test file discovery with improved pattern matching. The CLI (\lib/cli.js\) has been rebuilt on Yargs, and worker management (\lib/fork.js\) now supports both Node.js worker threads and child processes with advanced IPC flow control. This refactor removes legacy Babel integration, drops support for older Node.js versions, and establishes a foundation for future features like shared workers and experimental assertions.
lib · high confidence
Behavioural changes
1 commit (0 fixes) modifying (repo-wide)
A change to existing behaviour in (repo-wide) — 1 commit, 21 files: “Update TypeScript documentation (\#3489)” (refs \#3489).
examples/typescript-build, examples/typescript-loader, examples/typescript-native · low confidence · unverified
Introduce ESM entrypoints and dedicated CLI module
The project now exposes explicit ESM entrypoints for its public API and tooling. The CLI is now invoked via a dedicated \entrypoints/cli.js\ module that imports and runs the core logic, replacing previous entry mechanisms. The main test API (\entrypoints/main.js\) and its TypeScript definitions (\entrypoints/main.d.ts\) are re-exported from internal worker modules, maintaining the \test\ function and adding a \registerCompletionHandler\ for run-completion callbacks. Additionally, a new \entrypoints/eslint-plugin-helper.js\ provides a synchronous, worker-based helper for classifying files and imports for ESLint integration, and \entrypoints/plugin.js\ exposes the \registerSharedWorker\ API for plugin development.
entrypoints · high confidence
Introduce dedicated CI and local test execution scripts
Added \scripts/ci.sh\ and \scripts/test.sh\ to standardize test execution. The CI script configures AVA to skip watch-mode tests in the main run and executes them serially to reduce flakiness, while also restricting reporter tests to Linux environments. The local test script runs the linter, TypeScript checks, and all test suites.
scripts · high confidence
Migrate to ESM and modernize project configuration
The project has switched its internal implementation to ES Modules, replacing the previous CommonJS entry points (cli.js, index.js) with new ESM entrypoints and configuration files (ava.config.js, xo.config.js). This change introduces a new \.c8rc.json\ for code coverage settings, a \.taprc\ for TAP test isolation, and a \pnpm-workspace.yaml\ to manage build dependencies. Additionally, legacy tooling and CI configurations such as \.jshintrc\ and \.travis.yml\ have been removed in favor of modern standards like XO for linting and GitHub Actions for CI.
(repo-wide) · high confidence
New default and TAP reporters with improved error formatting and stack trace cleaning
The \lib/reporters\ directory has been rewritten to introduce a new default reporter and an updated TAP reporter. The default reporter now uses a dedicated \colors.js\ module for consistent styling and a new \beautify-stack.js\ utility that filters out AVA internals and Node.js internal frames from stack traces, making error output more readable. The TAP reporter has been refactored to use the \supertap\ library, which enables reporting hook failures as test failures, including logs from successful hooks, and properly handling process exits and timeouts. Additionally, ANSI escape codes are now stripped from TAP output using \node:util.stripVTControlCharacters\, and the TAP reporter correctly restores original error names when possible.
lib/reporters · high confidence
Test coverage
1 commit adding/updating tests in test; Added AVA snapshot tests for the snapshot workflow; Added AVA test fixtures for assertion validation; Added AVA-based integration tests for assertion behavior; Added TypeScript test fixtures for watch mode; Added comprehensive test suite for the test runner API; Added new test fixtures for reporter and assertion output; Added snapshot and stdout test fixtures for normalized test titles; Added snapshot reports for environment variables and line number selection tests; Added snapshot test fixtures for sourcemap verification; Added snapshot test for AVA timeout assertion validation; Added snapshot test for deterministic ordering of random test cases; Added snapshot test reports for corruption handling and formatting; Added snapshot tests for AVA snapshot removal logic; Added snapshot tests for configuration loading and validation; Added snapshot tests for extensions validation errors; Added snapshot tests for globs configuration validation; Added snapshot tests for shared worker plugin behavior; Added snapshot tests for the feature module; Added snapshot tests for unsupported shared worker protocols; Added test coverage for child process execution stability; Added test coverage for shared worker timeout behavior; Added test fixture for Node.js assert failure; Added test fixture for environment variable handling; Added test fixture for large binary snapshot data; Added test fixture for snapshot corruption detection; Added test fixtures for AVA runner behavior and configuration; Added test fixtures for assertion failure scenarios; Added test fixtures for configuration loading and error handling; Added test fixtures for deterministic snapshot ordering; Added test fixtures for globs directory and file filtering; Added test fixtures for line-number selection with source map support; Added test fixtures for snapshot location verification; Added test fixtures for snapshot removal scenarios; Added test fixtures for t.timeout() message validation; Added test for multiline snapshot labels; Added test helper for snapshot pruning verification; Added test helper for watch mode assertions; Added test helper macros for snapshot workflow assertions; Added test helpers and fixtures for process exit interception; Added tests for AVA macro functionality; Added tests for AVA meta properties in ESM contexts; Added tests for Node.js assertion failure reporting; Added tests for concurrency flag validation and line-number test selection; Added tests for conditional chain modifiers; Added tests for environment variable handling and extension configuration validation; Added tests for external assertion error snapshots; Added tests for globs configuration validation and file filtering; Added tests for hook restrictions on t.snapshot() and t.try(); Added tests for idle timeout behavior with console output; Added tests for internal event emission; Added tests for loading multiple shared workers; Added tests for multiple implementation validation; Added tests for node argument filtering in worker threads; Added tests for node argument handling in worker threads; Added tests for shared worker error handling and lifecycle; Added tests for shared worker lifecycle; Added tests for shared worker lifecycle and teardown; Added tests for shared worker loading behavior; Added tests for shared worker plugin error handling and protocol negotiation; Added tests for shared worker protocol fixtures; Added tests for shared worker thread restriction; Added tests for snapshot corruption handling, multiline labels, and large data encoding; Added tests for snapshot pruning behavior; Added tests for snapshot report regeneration; Added tests for snapshot workflow behaviors; Added tests for t.timeout() assertion message support; Added tests for the config require feature; Added tests for the new ESM-based configuration loading system; Added tests for the new watch mode implementation; Added tests for the test scheduler behavior; Added tests for worker thread execution behavior; Comprehensive TypeScript type tests for assertions, macros, and control flow; New integration tests for AVA CLI behavior and snapshot management; New test infrastructure helpers for reporter and CLI testing; Self-hosted test suite for AVA; Tests for deterministic snapshot ordering and report sorting; Updated reporter test snapshots for Node.js 22, 24, and 26; Updated test snapshots for AVA assertion behavior; Updated test snapshots for Node.js 22, 24, and 26 assertion outputs.
Dependencies
AVA 8.0.1 release with Node.js 26 support and pnpm 12 tooling
This release updates the AVA test runner to version 8.0.1, raising the minimum supported Node.js versions to 22.20, 24.12, and 26. It introduces official support for Node.js 26 in the test matrix and engine requirements. The project has migrated its development tooling to pnpm 12, which is now enforced via devEngines and reflected in the new pnpm-lock.yaml. Additionally, the package structure has been modernized with explicit CJS/ESM entrypoints, and the TypeScript provider dependency has been bumped to @ava/typescript 7.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 55 → 56 (+0.1)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 51 → 50 (-0.9)
- Architecture 98 → 98 (-0.3)
- Maturity 55 → 62 (+7.1)
- Readiness 55 → 54 (-0.2)
- Security 81 → 74 (-6.8)
- Performance 60 → 60 (+0.0)
Resolved (5)
- High secret: WD-SECRET-0005 (package-lock.json)
- No ADRs found
- Off-boarding risk: anonymized user #1
- Rotate the exposed credentials — git history can't be un-committed
- Test project verifies nothing: test/test-timeouts/fixtures (test/test-timeouts/fixtures/custom-message.js)
New (11)
- Further sole-owners (lower concentration)
- Hotspot: lib/reporters/default.js (lib/reporters/default.js)
- Hotspot: lib/run-status.js (lib/run-status.js)
- Medium CVE: [GHSA redacted] (pnpm-lock.yaml)
- Medium CVE: [GHSA redacted] (pnpm-lock.yaml)
- No ADRs found (package.json)
- Off-boarding risk: anonymized user #1
- Outdated (npm): @vercel/nft
- Outdated (npm): ci-info
- Outdated (npm): cli-truncate
- RunStatus.emitStateChange (cognitive 18) (lib/run-status.js)
Changes since last survey
- 9 commits — 9 feature/other, 0 fixes
By area
- (root) — 2 commits
- docs/04-snapshot-testing.md — 1 commit
- examples/typescript-build — 1 commit
- lib/load-config.js — 1 commit
- lib/reporters — 1 commit
- test-tap/reporters — 1 commit
- test/meta — 1 commit
- test/test-duration — 1 commit
Notable commits
- change: Avoid finish retry, ensuring teardowns run only once (#3488)
- change: Don't confuse ENOENT thrown by config code with the config file not existing
- change: Expose debugging state in test.meta.debugMode
- change: Make timeout work for synchronous tests (#3495)
- change: Only strip a leading test- from file names in test title prefixes (#3494)
- change: Report how many snapshots were updated or removed
- change: Update TypeScript documentation (#3489)
- change: v8.3.0
- change: v8.4.0
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
avajs/ava was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 15 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit a4fb2094052078faca5094fbe8cab7cbf18c785b — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-3c33c1882dc1.