Add deterministic timer mock to Fantom (#57274)

Summary:
Pull Request resolved: https://github.com/react/react-native/pull/57274

Fantom could not deterministically fire delayed JS timers: the timer registry it used scheduled timers on a real background thread with real wall-clock delays, so `setTimeout(fn, 100)`/`setInterval` callbacks never fired within a synchronous test. This adds a mockable timer registry and a public Fantom API to control it from JS, similar to `installHighResTimeStampMock`.

- New `Fantom.installTimerMock()` returns a controller with `advanceTimersByTime(ms)`, `runAllTimers()`, `getPendingTimerCount()`, and `uninstall()` (jest fake-timer style). While installed, `setTimeout`/`setInterval` callbacks only fire when the virtual clock is advanced.
- New deterministic `FantomTimerRegistry` (no background thread) keyed off a virtual clock, injected via a new optional `platformTimerRegistryFactory` seam on `ReactInstanceConfig` (the default registry is unchanged for all other consumers).
- `PlatformTimerRegistry` gains a virtual `setTimerManager` (default no-op) so the registry can be wired polymorphically.
- Control flows from JS through new `NativeFantom` methods, the same way the high-res timestamp mock works.

Default (non-mock) behavior is preserved: zero-delay `setTimeout` still fires on the next work loop, and existing tests are unaffected.

Changelog: [Internal]

Reviewed By: christophpurrer

Differential Revision: D109017304

fbshipit-source-id: 8afe6fb2a39f470ae293038f6592c46535442dc2
This commit is contained in:
Rubén Norte authored and meta-codesync[bot] committed 2026-06-19 05:13:56 -07:00
1 parent ad2cf4d1d7
commit 2d491c0c75
26 files changed
+730 -7

No files matched your search

@@ -4095,6 +4095,7 @@ class facebook::react::PlatformTimerRegistry {
public virtual void createTimer(uint32_t timerID, double delayMS) = 0;
public virtual void deleteTimer(uint32_t timerID) = 0;
public virtual void quit();
public virtual void setTimerManager(std::weak_ptr<facebook::react::TimerManager>);
public virtual ~PlatformTimerRegistry() noexcept = default;
}
@@ -3949,6 +3949,7 @@ class facebook::react::PlatformTimerRegistry {
public virtual void createTimer(uint32_t timerID, double delayMS) = 0;
public virtual void deleteTimer(uint32_t timerID) = 0;
public virtual void quit();
public virtual void setTimerManager(std::weak_ptr<facebook::react::TimerManager>);
public virtual ~PlatformTimerRegistry() noexcept = default;
}
@@ -4092,6 +4092,7 @@ class facebook::react::PlatformTimerRegistry {
public virtual void createTimer(uint32_t timerID, double delayMS) = 0;
public virtual void deleteTimer(uint32_t timerID) = 0;
public virtual void quit();
public virtual void setTimerManager(std::weak_ptr<facebook::react::TimerManager>);
public virtual ~PlatformTimerRegistry() noexcept = default;
}
@@ -319,7 +319,7 @@ class ObjCTimerRegistry : public facebook::react::PlatformTimerRegistry {
public virtual void createRecurringTimer(uint32_t timerID, double delayMS) override;
public virtual void createTimer(uint32_t timerID, double delayMS) override;
public virtual void deleteTimer(uint32_t timerID) override;
public void setTimerManager(std::weak_ptr<facebook::react::TimerManager> timerManager);
public virtual void setTimerManager(std::weak_ptr<facebook::react::TimerManager> timerManager) override;
}
class RCTComponentViewClassDescriptor {
@@ -6282,6 +6282,7 @@ class facebook::react::PlatformTimerRegistry {
public virtual void createTimer(uint32_t timerID, double delayMS) = 0;
public virtual void deleteTimer(uint32_t timerID) = 0;
public virtual void quit();
public virtual void setTimerManager(std::weak_ptr<facebook::react::TimerManager>);
public virtual ~PlatformTimerRegistry() noexcept = default;
}
@@ -319,7 +319,7 @@ class ObjCTimerRegistry : public facebook::react::PlatformTimerRegistry {
public virtual void createRecurringTimer(uint32_t timerID, double delayMS) override;
public virtual void createTimer(uint32_t timerID, double delayMS) override;
public virtual void deleteTimer(uint32_t timerID) override;
public void setTimerManager(std::weak_ptr<facebook::react::TimerManager> timerManager);
public virtual void setTimerManager(std::weak_ptr<facebook::react::TimerManager> timerManager) override;
}
class RCTComponentViewClassDescriptor {
@@ -6164,6 +6164,7 @@ class facebook::react::PlatformTimerRegistry {
public virtual void createTimer(uint32_t timerID, double delayMS) = 0;
public virtual void deleteTimer(uint32_t timerID) = 0;
public virtual void quit();
public virtual void setTimerManager(std::weak_ptr<facebook::react::TimerManager>);
public virtual ~PlatformTimerRegistry() noexcept = default;
}
@@ -319,7 +319,7 @@ class ObjCTimerRegistry : public facebook::react::PlatformTimerRegistry {
public virtual void createRecurringTimer(uint32_t timerID, double delayMS) override;
public virtual void createTimer(uint32_t timerID, double delayMS) override;
public virtual void deleteTimer(uint32_t timerID) override;
public void setTimerManager(std::weak_ptr<facebook::react::TimerManager> timerManager);
public virtual void setTimerManager(std::weak_ptr<facebook::react::TimerManager> timerManager) override;
}
class RCTComponentViewClassDescriptor {
@@ -6279,6 +6279,7 @@ class facebook::react::PlatformTimerRegistry {
public virtual void createTimer(uint32_t timerID, double delayMS) = 0;
public virtual void deleteTimer(uint32_t timerID) = 0;
public virtual void quit();
public virtual void setTimerManager(std::weak_ptr<facebook::react::TimerManager>);
public virtual ~PlatformTimerRegistry() noexcept = default;
}
@@ -2700,6 +2700,7 @@ class facebook::react::PlatformTimerRegistry {
public virtual void createTimer(uint32_t timerID, double delayMS) = 0;
public virtual void deleteTimer(uint32_t timerID) = 0;
public virtual void quit();
public virtual void setTimerManager(std::weak_ptr<facebook::react::TimerManager>);
public virtual ~PlatformTimerRegistry() noexcept = default;
}
@@ -2594,6 +2594,7 @@ class facebook::react::PlatformTimerRegistry {
public virtual void createTimer(uint32_t timerID, double delayMS) = 0;
public virtual void deleteTimer(uint32_t timerID) = 0;
public virtual void quit();
public virtual void setTimerManager(std::weak_ptr<facebook::react::TimerManager>);
public virtual ~PlatformTimerRegistry() noexcept = default;
}
@@ -2697,6 +2697,7 @@ class facebook::react::PlatformTimerRegistry {
public virtual void createTimer(uint32_t timerID, double delayMS) = 0;
public virtual void deleteTimer(uint32_t timerID) = 0;
public virtual void quit();
public virtual void setTimerManager(std::weak_ptr<facebook::react::TimerManager>);
public virtual ~PlatformTimerRegistry() noexcept = default;
}