# vitest/prefer-called-times

> Require `toHaveBeenCalledTimes(1)` instead of `toHaveBeenCalledOnce()`

`toHaveBeenCalledOnce()` and `toHaveBeenCalledTimes(1)` assert the same thing. With `toHaveBeenCalledTimes()`, every call count is written the same way, and changing the expected count means changing one number. The aliases are covered too, so `toBeCalledOnce()` becomes `toBeCalledTimes(1)`.

`--fix` rewrites the matcher.

{/* Generated by src/codegen/lint-rule-docs.ts. Do not edit this section. */}

## Configure

Off by default. To turn it on:

```toml bunfig.toml
[lint.rules]
"vitest/prefer-called-times" = "error" # or "warn"
```

{/* End of the generated section. */}

## Examples

Reported:

{/* bad */}
```ts
import { expect, test, vi } from "vitest";

test("does not retry after a success", () => {
  const request = vi.fn();
  retryFetch(request);
  expect(request).toHaveBeenCalledOnce();
});
```

Not reported:

{/* good */}
```ts
import { expect, test, vi } from "vitest";

test("does not retry after a success", () => {
  const request = vi.fn();
  retryFetch(request);
  expect(request).toHaveBeenCalledTimes(1);
});
```

## When not to use it

`vitest/prefer-called-once` asks for the opposite. Turn on one of the two, not both.