webhook/node_modules/eslint-plugin-jest/docs/rules/prefer-called-with.md
Joel Male 1ada95e04a
v2.0.0 (#12)
- Convert project to Javascript/Typescript
- Allow custom headers to be passed in (optional)
- Allow body to be optional
2020-08-26 10:52:47 +10:00

998 B

Suggest using toBeCalledWith() or toHaveBeenCalledWith() (prefer-called-with)

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:

expect(someFunction).toBeCalled();

expect(someFunction).toHaveBeenCalled();

The following patterns are not warnings:

expect(noArgsFunction).toBeCalledWith();

expect(roughArgsFunction).toBeCalledWith(expect.anything(), expect.any(Date));

expect(anyArgsFunction).toBeCalledTimes(1);

expect(uncalledFunction).not.toBeCalled();