#prefer-to-have-been-called-times

#Configuration

import { defineConfig, jestPlugin } from '@rslint/core';

export default defineConfig([
  jestPlugin.configs.recommended,
  {
    rules: {
      'jest/prefer-to-have-been-called-times': 'error',
    },
  },
]);

#Rule Details

In order to have a better failure message, toHaveBeenCalledTimes() should be used instead of directly checking the length of mock.calls.

This rule triggers a warning if toHaveLength is used to assert the number of times a mock has been called.

This rule is often used together with prefer-to-have-length.

Examples of incorrect code for this rule:

expect(someFunction.mock.calls).toHaveLength(1);
expect(someFunction.mock.calls).toHaveLength(0);

expect(someFunction.mock.calls).not.toHaveLength(1);

Examples of correct code for this rule:

expect(someFunction).toHaveBeenCalledTimes(1);
expect(someFunction).toHaveBeenCalledTimes(0);

expect(someFunction).not.toHaveBeenCalledTimes(0);

expect(uncalledFunction).not.toBeCalled();

expect(method.mock.calls[0][0]).toStrictEqual(value);

#Original Documentation

• eslint-plugin-jest: prefer-to-have-been-called-times
• Source code