← Back to rules

vitest/require-test-timeout Restriction

What it does

Requires every test to have a timeout specified, either as a numeric third argument, a { timeout } option, or via vi.setConfig({ testTimeout: ... }).

Why is this bad?

Tests without an explicit timeout rely on the default, which may be too generous to catch performance regressions or too short for slow CI environments, leading to flaky failures.

Examples

Examples of incorrect code for this rule:

it("slow test", async () => {
  await doSomethingSlow();
});

Examples of correct code for this rule:

// good (numeric timeout)
test("slow test", async () => {
  await doSomethingSlow();
}, 1000);

// good (options object)
test("slow test", { timeout: 1000 }, async () => {
  await doSomethingSlow();
});

// good (file-level)
vi.setConfig({ testTimeout: 1000 });

test("slow test", async () => {
  await doSomethingSlow();
});

How to use

To enable this rule using the config file or in the CLI, you can use:

Config (.oxlintrc.json)

{
  "plugins": ["vitest"],
  "rules": {
    "vitest/require-test-timeout": "error"
  }
}

Config (oxlint.config.ts)

import { defineConfig } from "oxlint";

export default defineConfig({
  plugins: ["vitest"],
  rules: {
    "vitest/require-test-timeout": "error",
  },
});

CLI

oxlint --deny vitest/require-test-timeout --vitest-plugin

Version

This rule was added in v1.58.0.

References

• Rule Source
• Open rule in Oxc Playground