QUnitX
github.com
- Free plan
- Windows
- macOS
- Linux
- Web
What QUnitX is
QUnitX is a free, open-source testing tool for JavaScript and TypeScript. It lets a team keep one test file and run it with Node.js, Deno, or a browser, using each environment’s native runner where applicable. The project describes a setup with no configuration files, transform pipeline, injected globals, or runtime dependencies, and runs TypeScript as-is. Its assertion API covers deep and partial equality, error matching, ordered steps, assertion counts, and per-test timeouts. Nested modules support before, beforeEach, afterEach, and after hooks. The browser interface filters tests, shares filtered views by URL, reruns individual tests, and displays assertion differences. The linked CLI runs tests in headless Chromium, Firefox, or WebKit, streams TAP output, and supports esbuild plugins, GitHub annotations, JUnit XML, V8 coverage reports, and a JavaScript API. QUnitX supports parallel execution and is listed under the MIT license.
Who it suits
QUnitX suits JavaScript or TypeScript teams that want one test file across Node.js, Deno, and browser environments. It also fits projects needing browser runners, reporting, and coverage options.
Good to know, and what to watch
- Runs JavaScript and TypeScript across three environments
- No configuration files or runtime dependencies
- Detailed assertions, hooks, and timeouts
- Browser filtering and assertion diffs
- CLI supports multiple browsers and report formats
- Requires Node.js 22+ or Deno 2+
- CLI requires newer Node.js or Deno versions
- Browser coverage loses source mapping through esbuild
- Ships as ESM only
The verdict
QUnitX combines a minimal setup with broad JavaScript and TypeScript execution options. Check its runtime requirements and browser coverage limitation before adopting it.
What the maker publishes
- Assertions
- The assertion API includes deep and partial equality checks, error matching, ordered steps, assertion-count checks, and per-test timeouts. source
- Assertions
- Assertions include structural and partial equality, error matching, execution-order checks, assertion counts, and per-test timeouts. source
- Browser options
- The documented browser runner supports Chromium, Firefox, and WebKit, plus watch mode, fail-fast, timeout, and lifecycle hooks. source
- Browser runner
- The linked qunitx-cli runs JavaScript and TypeScript tests in headless Chromium, Firefox, or WebKit and streams TAP output to the terminal. source
- Browser runner
- The separate qunitx-cli bundles tests for a real browser and streams TAP to the terminal, with an optional live QUnit UI. source
- Browser UI
- The browser UI supports filtering tests, sharing filtered views by URL, rerunning individual tests, and viewing assertion diffs. source
- Browser UI
- The browser UI can filter by module or test, preserve filters in shareable URLs, rerun individual tests, and show assertion diffs. source
- Compatibility limits
- QUnitX requires Node.js 22 or later or Deno 2 or later, and ships as ESM only. source
- Coverage
- The README documents coverage with c8 for Node.js and Deno and identifies browser coverage as a limitation because bundling with esbuild loses source mapping. source
- Coverage limit
- The QUnitX README says browser coverage has a source-map limitation because qunitx-cli bundles test files with esbuild. source
- Hooks
- Tests can be grouped in nested modules with before, beforeEach, afterEach, and after hooks. source
- Hooks
- Nested modules support before, beforeEach, afterEach, and after hooks, with outer-first setup and inner-first teardown ordering. source
- Install
- The README gives npm and Deno installation commands and requires Node.js 22 or later or Deno 2 or later. source
- Integrations
- The CLI supports esbuild plugins for custom loaders and provides GitHub-annotated output, JUnit XML, V8 coverage reports, and a JavaScript API. source
- Integrations
- The README documents installation through npm and Deno, and describes a JSR package published from CI with provenance. source
- License
- The GitHub repository lists an MIT license. source
- License
- The repository identifies its license as MIT. source
- Maker
- The repository identifies izelnakri as its owner and describes QUnitX as a project by its maker; it provides no headquarters or founding date in the opened pages. source
- No configuration
- The README says QUnitX requires no config or setup files, runs TypeScript as-is, and has zero runtime dependencies. source
- Platforms
- The CLI README lists standalone binaries for Linux x64, macOS arm64, and Windows x64. source
- Purpose
- QUnitX lets teams write one JavaScript or TypeScript test file and run it with Node.js, Deno, or in a browser. source
- Purpose
- QUnitX lets teams write one JavaScript or TypeScript test file and run it unchanged with Node.js, Deno, or in a browser. source
- Requirements
- The CLI requires Node.js 24 or later or Deno 2.7 or later; its default Chromium browser mode also requires system Chrome or CHROME_BIN when using the standalone binary. source
- Runners
- Node.js and Deno use their native test runners, while the browser path re-exports QUnit. source
Checked against the maker's pages on 8 Oct 2026.