interface TestOptions | Node.js node:test module | Bun

If a number is provided, then that many tests would run in parallel. If truthy, it would run (number of cpu cores - 1) tests in parallel. For subtests, it will be Infinity tests in parallel. If falsy, it would only run one test at a time. If unspecified, subtests inherit this value from their parent.

If truthy, the test is expected to fail. If a non-empty string is provided, that string is displayed in the test results as the reason why the test is expected to fail. If a RegExp, Function, Object, or Error is provided directly (without wrapping in { match: … }), the test passes only if the thrown error matches, following the behavior of assert.throws. To provide both a reason and validation, pass an object with label (string) and match (RegExp, Function, Object, or Error).

If truthy, and the test context is configured to run only tests, then this test will be run. Otherwise, the test is skipped.

The number of assertions and subtests expected to be run in the test. If the number of assertions run in the test does not match the number specified in the plan, the test will fail.

Allows aborting an in-progress test.

If truthy, the test is skipped. If a string is provided, that string is displayed in the test results as the reason for skipping the test.

A number of milliseconds the test will fail after. If unspecified, subtests inherit this value from their parent.

If truthy, the test marked as TODO. If a string is provided, that string is displayed in the test results as the reason why the test is TODO.