← Back to rules

jest/no-standalone-expect 正确性

它的作用

禁止在 test 或 it 块外部使用 expect 语句。在辅助函数中（但不在 test 或 it 块内）的 expect 将不会触发此规则。

像 expect.hasAssertions() 这样的语句不会触发此规则，因为这些调用即使不在测试块中也会执行。

为什么这是个问题？

在测试块外部的 expect 语句不会被 Jest 测试运行器执行，这意味着它们实际上不会测试任何内容。这可能导致对测试覆盖率的错误信心，并可能隐藏本应通过正确测试发现的缺陷。

示例

此规则的 错误 代码示例：

describe("一个测试", () => {
  expect(1).toBe(1);
});

该规则与 eslint-plugin-vitest 兼容。要使用它，请将以下配置添加到你的 .oxlintrc.json 文件中：

{
  "rules": {
    "vitest/no-standalone-expect": "error"
  }
}

配置

此规则接受一个配置对象，包含以下属性：

additionalTestBlockFunctions

type: string[]

default: []

一个函数名称数组，这些函数也应被视为测试块。

如何使用

要通过配置文件或 CLI 启用 此规则，可以使用：

配置文件 (.oxlintrc.json)

{
  "plugins": ["jest"],
  "rules": {
    "jest/no-standalone-expect": "error"
  }
}

CLI

oxlint --deny jest/no-standalone-expect --jest-plugin

参考资料

• 规则源码