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

`toHaveBeenCalledTimes(0)` means "not called", and `.not.toHaveBeenCalledTimes(0)` is a double negative for "called". `.not.toHaveBeenCalled()` and `toHaveBeenCalled()` say it directly.

The alias `toBeCalledTimes(0)` is reported too. Any other count is fine.

`--fix` rewrites both forms.

{/* 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]
"jest/prefer-to-have-been-called" = "error" # or "warn"
```

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

## Examples

Reported:

{/* bad {"count": 2} */}
```ts
import { expect, jest, test } from "@jest/globals";

test("only notifies on failure", () => {
  const onError = jest.fn();
  const onDone = jest.fn();
  run(task, { onError, onDone });
  expect(onError).toHaveBeenCalledTimes(0);
  expect(onDone).not.toHaveBeenCalledTimes(0);
});
```

Not reported:

{/* good */}
```ts
import { expect, jest, test } from "@jest/globals";

test("only notifies on failure", () => {
  const onError = jest.fn();
  const onDone = jest.fn();
  run(task, { onError, onDone });
  expect(onError).not.toHaveBeenCalled();
  expect(onDone).toHaveBeenCalled();
  expect(onDone).toHaveBeenCalledTimes(1);
});
```