---
url: /docs/guide/usage/linter/rules/vitest/prefer-expect-resolves.md
---

### 它的作用

在测试 promise 时，优先使用 `await expect(...).resolves`，而不是 `expect(await ...)`。

### 为什么这不好？

在处理 promise 时，测试其解析值主要有两种方式：

1. 在 `expect` 上使用 `resolve` 修饰符
   （`await expect(...).resolves.<matcher>` 风格）
2. 对 promise 使用 `await`，并断言其结果
   （`expect(await ...).<matcher>` 风格）

虽然第二种风格在某种程度上对 `jest` 的依赖更少，但如果
promise 被拒绝，它会被视为一般错误，从而导致 `jest` 的行为和输出
更不可预测。

此外，优先使用第一种风格还能确保与其
`rejects` 对应风格保持一致，因为没有办法“await”一个拒绝。

### 示例

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

```javascript
it("passes", async () => {
  expect(await someValue()).toBe(true);
});
it("is true", async () => {
  const myPromise = Promise.resolve(true);
  expect(await myPromise).toBe(true);
});
```

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

```javascript
it("passes", async () => {
  await expect(someValue()).resolves.toBe(true);
});
it("is true", async () => {
  const myPromise = Promise.resolve(true);

  await expect(myPromise).resolves.toBe(true);
});
it("errors", async () => {
  await expect(Promise.reject(new Error("oh noes!"))).rejects.toThrowError("oh noes!");
});
```

## 如何使用

## 版本

此规则在 v0.2.14 中添加。

## 参考资料