---
title: "vitest/prefer-called-times"
description: "Require `toHaveBeenCalledTimes(1)` instead of `toHaveBeenCalledOnce()`"
# Generated by src/codegen/lint-rule-docs.ts. Do not edit below this line.
plugin: "vitest"
aliases: []
kind: "suggestion"
category: "style"
default: "off"
fixable: "yes"
typeAware: false
deprecated: false
---

`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.