Lint for setting advanceTimers with user-event when using jest.useFakeTimers

Name for new rule

advance-timers-with-fake-timers

Description of the new rule

Enforce using the advanceTimers option for user-event when using jest's useFakeTimers in order to prevent testing timeouts

Testing Library feature

user-event's advanceTimers option when using fake timers

Testing Library framework(s)

user-event (across any Testing Library framework that can use it)

What category of rule is this?

Warns about a potential error

Optional: other category of rule

No response

Code examples

Using fake timers within a test directly:

jest.useFakeTimers();
const user = userEvent.setup(); // Warn - advanceTimers not set

beforeEach(() => {
  jest.useFakeTimers()
});

test('some behavior with user action', async () => {
  const user = userEvent.setup(); // Warn - advanceTimers not set
  // Test behavior
})

Anything else?

No response

Do you want to submit a pull request to make the new rule?

No

Start with the issue's examples of jest.useFakeTimers and userEvent.setup, and inspect the repository's existing rule entry points and tests for conventions. Define the rule's handling of fake timers and the advanceTimers option across supported Testing Library frameworks; done means the supplied examples are reported correctly and valid configurations are accepted.