# jest/no-alias-methods

> Disallow matcher aliases such as `toBeCalled` in favor of `toHaveBeenCalled`

Some matchers have two names. For example, `toBeCalled` is the same matcher as `toHaveBeenCalled`. If a project uses both, searching for one name misses the tests that use the other. Jest 30 removed the aliases, so a test that uses one fails after the upgrade.

`--fix` renames 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]
"jest/no-alias-methods" = "error" # or "warn"
```

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

## Examples

Reported:

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

test("saves the draft", () => {
  const save = jest.fn();
  save("draft");
  expect(save).toBeCalledWith("draft");
});
```

Not reported:

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

test("saves the draft", () => {
  const save = jest.fn();
  save("draft");
  expect(save).toHaveBeenCalledWith("draft");
});
```

The full list:

| Reported | Write instead |
| --- | --- |
| `toBeCalled` | `toHaveBeenCalled` |
| `toBeCalledTimes` | `toHaveBeenCalledTimes` |
| `toBeCalledWith` | `toHaveBeenCalledWith` |
| `lastCalledWith` | `toHaveBeenLastCalledWith` |
| `nthCalledWith` | `toHaveBeenNthCalledWith` |
| `toReturn` | `toHaveReturned` |
| `toReturnTimes` | `toHaveReturnedTimes` |
| `toReturnWith` | `toHaveReturnedWith` |
| `lastReturnedWith` | `toHaveLastReturnedWith` |
| `nthReturnedWith` | `toHaveNthReturnedWith` |
| `toThrowError` | `toThrow` |