---
url: /docs/guide/usage/linter/rules/vitest/prefer-to-have-been-called-times.md
---

### 作用

为了获得更好的失败信息，应该使用 [`toHaveBeenCalledTimes`，而不是直接检查 `mock.calls` 的长度](https://github.com/jest-community/eslint-plugin-jest/blob/v29.5.0/docs/rules/prefer-to-have-been-called-times.md)。

### 为什么这不好？

当使用 `toHaveLength` 来断言 mock 被调用的次数时，此规则会触发警告。

### 示例

以下是此规则的**错误**代码示例：

```js
expect(someFunction.mock.calls).toHaveLength(1);
expect(someFunction.mock.calls).toHaveLength(0);
expect(someFunction.mock.calls).not.toHaveLength(1);
```

以下是此规则的**正确**代码示例：

```js
expect(someFunction).toHaveBeenCalledTimes(1);
expect(someFunction).toHaveBeenCalledTimes(0);
expect(someFunction).not.toHaveBeenCalledTimes(0);
expect(uncalledFunction).not.toBeCalled();
expect(method.mock.calls[0][0]).toStrictEqual(value);
```

## 如何使用

## 版本

此规则已在 v1.34.0 中添加。

## 参考资料