`waitFor` doesn't advance time when using `jest` fake timers without injecting globals

• @testing-library/dom version: 9.3.4
• Testing Framework and version: jest@29.7.0
• DOM Environment: jest-environment-jsdom@29.7.0

Relevant Code or Config:

A minimal sandbox to reproduce the issue is available on codesandbox. You can execute tests by opening a terminal and running the yarn test command.

Actions Undertaken:

• Configured jest to not inject globals (--injectGlobals=false); refer to the package.json command from the sandbox above.
• Created tests that rely on waitFor or waitForElementToBeRemoved.

Outcome:

• waitFor never advances timers by time (the default 50ms interval of the loop or any other interval), causing the tests to exceed their timeout.

Reproduction:

You can reproduce this issue via the following codesandbox link.

Problem Description:

When using jest, but without injecting globals, the waitFor logic:

• Fails to identify jest's environment in the jestFakeTimersAreEnabled predicate.
• Assuming the above was passing correctly, it would reference the jest global object, which is undefined when not injecting globals. This would lead to an error when attempting to invoke jest.advanceTimersByTime.

On a broader scope (although I want to keep this issue's focus narrow for the sake of actionability), there might be other unintended implicit assumptions about depending on (a) jest and / or (b) a test environment that injects globals. The following issues are related, although they focus on different manifested problems:

• https://github.com/testing-library/react-testing-library/issues/1240
• https://github.com/testing-library/react-testing-library/issues/1257

Suggested Solution:

• The first part of the issue (i.e., jest environment detection) can be resolved by adding an OR condition to the jestFakeTimersAreEnabled predicate. In my experience, we should add a check for process.env.JEST_WORKER_ID to not be undefined.
• The second issue could be addressed by dynamically attempting to import jest from @jest/globals when (a) we detect a JEST_WORKER_ID and (b) we know fake timers are enabled.
  • I don't believe dom-testing-library should depend on @jest/globals.
  • I'm not completely satisfied with the tentative dynamic import of an optional dependency @jest/globals in this case, but I think it might provide the best developer experience for end users.

Depending on the appetite for this issue to be fixed, I might work on a PR to address the above. I am somewhat surprised this hasn't come up before, but I guess not many people tend to set up jest without injecting globals.

Start with the jestFakeTimersAreEnabled predicate in src/helpers.ts and the timer handling around line 81 of src/wait-for.js. Run the linked CodeSandbox tests with Jest 29.7.0 and --injectGlobals=false to observe the timeout. Done means waitFor and waitForElementToBeRemoved advance fake timers correctly without injected Jest globals, with coverage for the reproduced setup.