2020-08-25 23:57:08 +00:00
|
|
|
# Suggest using `toBeCalledWith()` or `toHaveBeenCalledWith()` (`prefer-called-with`)
|
|
|
|
|
2022-11-10 10:43:16 +00:00
|
|
|
<!-- end auto-generated rule header -->
|
|
|
|
|
2020-08-25 23:57:08 +00:00
|
|
|
The `toBeCalled()` matcher is used to assert that a mock function has been
|
|
|
|
called one or more times, without checking the arguments passed. The assertion
|
|
|
|
is stronger when arguments are also validated using the `toBeCalledWith()`
|
|
|
|
matcher. When some arguments are difficult to check, using generic match like
|
|
|
|
`expect.anything()` at least enforces number and position of arguments.
|
|
|
|
|
|
|
|
This rule warns if the form without argument checking is used, except for `.not`
|
|
|
|
enforcing a function has never been called.
|
|
|
|
|
|
|
|
## Rule details
|
|
|
|
|
|
|
|
The following patterns are warnings:
|
|
|
|
|
|
|
|
```js
|
|
|
|
expect(someFunction).toBeCalled();
|
|
|
|
|
|
|
|
expect(someFunction).toHaveBeenCalled();
|
|
|
|
```
|
|
|
|
|
|
|
|
The following patterns are not warnings:
|
|
|
|
|
|
|
|
```js
|
|
|
|
expect(noArgsFunction).toBeCalledWith();
|
|
|
|
|
|
|
|
expect(roughArgsFunction).toBeCalledWith(expect.anything(), expect.any(Date));
|
|
|
|
|
|
|
|
expect(anyArgsFunction).toBeCalledTimes(1);
|
|
|
|
|
|
|
|
expect(uncalledFunction).not.toBeCalled();
|
|
|
|
```
|