uvu Test Runner for Node.js and Browsers
github.com · checked 8 Oct 2026
A free, lightweight test runner for Node.js and browser projects.
How it plugs in
Signal on JavaScript Testing Frameworks6.3#8 of 23
uvu runs JavaScript tests in Node.js or a browser. It supports separate test files, async callbacks, native ES modules, named suites, snapshots, and a familiar test interface. Its optional command-line tool finds suites by directory or regular-expression pattern and can preload modules. The project is MIT licensed and installed with npm.

Review
In a line
uvu is a test runner for Node.js and browser projects. It is free software under the MIT license.
What it does
uvu runs JavaScript test suites, including tests that use async callbacks or return promises. Tests can be kept in separate files and run on their own with Node.js.
You can group tests into named suites or use the simpler test interface. Snapshot testing is included, and native ES modules are supported.
How it connects
Install uvu as a development package with npm. It runs in Node.js and in browsers, and the project shows Node.js use with esm preloaded for older Node.js versions.
The optional command-line tool collects and runs suites. It can stop after the first failure, ignore matching files, preload modules, change the working folder, and colorize output. When you pass a directory, it uses a regular-expression pattern rather than glob patterns.
The assertion helper is optional. You can replace uvu/assert with another library, including Node.js's built-in assert module. The source is MIT licensed.
Good fit
uvu suits people writing tests for Node.js or browser code who want individually runnable files, async test support, and native ES modules.
It is also a fit when you want named suites, snapshots, or a command-line runner with controls for file selection and setup.
Watch for
Check that your project meets the package requirement of Node.js 8 or newer. The command-line tool does not use glob patterns, so directory-based selection requires a regular-expression pattern.
The command-line tool is optional, and the assertion module can be swapped out. Decide whether those choices match your preferred test setup before adopting it.
Pricing
uvu is free, with a free plan and no free trial. It is MIT licensed.
Verdict
Choose uvu if your project runs in Node.js or a browser and you want a small runner that handles async tests, separate files, ES modules, suites, and snapshots. Its optional CLI adds file filtering and setup controls without requiring you to use it.
Look elsewhere if your workflow depends on glob-based file matching or needs a paid support tier, since those options are not part of the offering.
Our take
uvu is a sensible choice for JavaScript projects that need a free runner across Node.js and browsers. Separate files, promise-based tests, ES modules, suites, and snapshots cover common testing work, while the assertion helper can be replaced. The optional CLI gives control over selection and setup, but its regular-expression matching may not suit teams built around glob patterns. Confirm the Node.js 8-or-newer requirement and whether the MIT-licensed, no-trial model fits your project before switching.
- Runs in Node.js and browsers
- Supports async tests and native ES modules
- Test files can run independently
- Includes snapshots and named suites
- Optional CLI offers selection and setup controls
- Directory selection uses regular expressions, not glob patterns
- The CLI is optional rather than required
- No free trial is offered
- Pick it ifNode.js and browser projects needing a free test runner; Teams using separate test files, async tests, or ES modules; Projects wanting optional CLI controls and snapshots
- Skip it ifYou require glob-based file matching for directory test selection; You are looking for a paid plan or free trial
Pricing
uvu is free under an MIT license. There is a free plan and no free trial.
- uvuMIT-licensed test runner for Node.js and the browserFree
As github.com lists them, checked 8 Oct 2026.
Questions
What is uvu?
uvu is a free test runner for projects that run in Node.js or a browser.
Can uvu run browser tests?
Yes. The project describes uvu and its assertion module as browser-compatible.
Does uvu support async tests?
Yes. Test callbacks may be asynchronous or return a promise.
How does uvu choose test files?
Its optional CLI accepts directories and regular-expression patterns. It intentionally does not rely on glob patterns.
Can I use another assertion library?
Yes. The optional uvu/assert module can be replaced, including with Node.js's native assert module.
How do I install uvu?
The README gives npm install --save-dev uvu as the installation command.
What Node.js version does uvu require?
The package metadata specifies Node.js version 8 or newer.