ava 5.3.1

AVA is a powerful test runner for Node.js projects. It provides a concise API and detailed error output, embracing new language features and process isolation. This enables developers to write tests in an efficient and confident manner. AVA runs tests concurrently, enforces the writing of atomic tests, and provides no implicit globals. This results is minimal, fast tests and outputs that are simple to understand, allowing developers to troubleshoot and resolve errors quickly. AVA also includes TypeScript definitions and features such as Magic Assert for clearer, focused assertion messages, and an isolated environment for each test file for better control.

To use AVA effectively, first, install it to your Node.js project. You can easily setup AVA by running npm init ava in your console. This configures AVA in your package.json file. Alternatively, if you prefer Yarn, use yarn add ava --dev, or install AVA manually via npm install --save-dev ava.

Once installed, create a test file at the project root directory, for example test.js, and import the test module:

import test from 'ava';
test('foo', t => {
    t.pass();
});

test('bar', async t => {
    const bar = Promise.resolve('bar');
    t.is(await bar, 'bar');
});

Now you can run your tests with the command npm test, or if you're using npx, with the command npx ava. To run your tests in watch mode, use the command npx ava --watch.

The documentation for AVA is located in the "docs" directory of the AVA repository on GitHub. The documentation provides thorough information on various aspects of AVA, including writing tests, execution context, assertions, snapshot testing, command line (CLI) interface, and configuration. AVA also has a list of common pitfalls that developers may encounter while using AVA, as well as a diverse collection of useful recipes for specific situations. Ava's documentation can be found via this link. Feel free to explore these resources to get a better understanding of AVA and how to make the most of its features and capabilities.