feat: add advanceTimers option

src/__tests__/config.js

@@ -42,9 +42,11 @@ describe('configuration API', () => {
 
   describe('RTL options', () => {
     test('configure can set by a plain JS object', () => {
-      configure({reactStrictMode: true})
+      const advanceTimers = jest.fn()
+      configure({reactStrictMode: true, advanceTimers})
 
       expect(getConfig().reactStrictMode).toBe(true)
+      expect(getConfig().advanceTimers).toBe(advanceTimers)
     })
 
     test('configure can set by a function', () => {

src/config.js

@@ -3,8 +3,29 @@ import {
   configure as configureDTL,
 } from '@testing-library/dom'
 
+function jestFakeTimersAreEnabled() {
+  /* istanbul ignore else */
+  if (typeof jest !== 'undefined' && jest !== null) {
+    return (
+      // legacy timers
+      setTimeout._isMockFunction === true || // modern timers
+      // eslint-disable-next-line prefer-object-has-own -- No Object.hasOwn in all target environments we support.
+      Object.prototype.hasOwnProperty.call(setTimeout, 'clock')
+    )
+  } // istanbul ignore next
+
+  return false
+}
+
+function maybeAdvanceJestTimers(delay) {
+  if (jestFakeTimersAreEnabled()) {
+    jest.advanceTimersByTime(delay)
+  }
+}
+
 let configForRTL = {
   reactStrictMode: false,
+  advanceTimers: maybeAdvanceJestTimers,
 }
 
 function getConfig() {
@@ -21,13 +42,14 @@ function configure(newConfig) {
     newConfig = newConfig(getConfig())
   }
 
-  const {reactStrictMode, ...configForDTL} = newConfig
+  const {reactStrictMode, advanceTimers, ...configForDTL} = newConfig
 
   configureDTL(configForDTL)
 
   configForRTL = {
     ...configForRTL,
     reactStrictMode,
+    advanceTimers,
   }
 }
 

src/pure.js

@@ -13,20 +13,6 @@ import act, {
 import {fireEvent} from './fire-event'
 import {getConfig, configure} from './config'
 
-function jestFakeTimersAreEnabled() {
-  /* istanbul ignore else */
-  if (typeof jest !== 'undefined' && jest !== null) {
-    return (
-      // legacy timers
-      setTimeout._isMockFunction === true || // modern timers
-      // eslint-disable-next-line prefer-object-has-own -- No Object.hasOwn in all target environments we support.
-      Object.prototype.hasOwnProperty.call(setTimeout, 'clock')
-    )
-  } // istanbul ignore next
-
-  return false
-}
-
 configureDTL({
   unstable_advanceTimersWrapper: cb => {
     return act(cb)
@@ -42,14 +28,12 @@ configureDTL({
       // Drain microtask queue.
       // Otherwise we'll restore the previous act() environment, before we resolve the `waitFor` call.
       // The caller would have no chance to wrap the in-flight Promises in `act()`
-      await new Promise(resolve => {
+      await new Promise(async resolve => {
         setTimeout(() => {
           resolve()
         }, 0)
 
-        if (jestFakeTimersAreEnabled()) {
-          jest.advanceTimersByTime(0)
-        }
+        await getConfig().advanceTimers(0)
       })
 
       return result

types/index.d.ts

@@ -15,6 +15,12 @@ export * from '@testing-library/dom'
 
 export interface Config extends ConfigDTL {
   reactStrictMode: boolean
+  /**
+   * A function to be called internally to advance your fake timers (if applicable)
+   *
+   * @example jest.advanceTimersByTime
+   */
+  advanceTimers?: ((delay: number) => Promise<void>) | ((delay: number) => void)
 }
 
 export interface ConfigFn {