react · potomak · Sep 30, 2026
diff --git a/packages/react-native/ReactCommon/react/runtime/platform/ios/ReactCommon/RCTHost.h b/packages/react-native/ReactCommon/react/runtime/platform/ios/ReactCommon/RCTHost.h
@@ -110,6 +110,14 @@ typedef std::shared_ptr<facebook::react::JSRuntimeFactory> (^RCTHostJSEngineProv
 
 - (void)callFunctionOnJSModule:(NSString *)moduleName method:(NSString *)method args:(NSArray *)args;
 
+/**
+ * The CallInvoker of the current React instance, the same one its TurboModules receive. It schedules work on the JS
+ * thread with a priority. The returned invoker can be used from any thread. Null before `start` and while a reload
+ * replaces the instance; every reload creates a new invoker, so read it again after `hostDidStart:`. Holding it past a
+ * reload or past the host's lifetime is safe: work sent to an invoker whose instance is gone is dropped.
+ */
+- (std::shared_ptr<facebook::react::CallInvoker>)jsCallInvoker;
+
 // Renderer API
 
 - (RCTFabricSurface *)createSurfaceWithModuleName:(NSString *)moduleName

diff --git a/packages/react-native/ReactCommon/react/runtime/platform/ios/ReactCommon/RCTHost.mm b/packages/react-native/ReactCommon/react/runtime/platform/ios/ReactCommon/RCTHost.mm
@@ -466,6 +466,12 @@ - (void)callFunctionOnJSModule:(NSString *)moduleName method:(NSString *)method
   [_instance callFunctionOnJSModule:moduleName method:method args:args];
 }
 
+- (std::shared_ptr<facebook::react::CallInvoker>)jsCallInvoker
+{
+  RCTInstance *instance = _instance;
+  return instance ? instance.jsCallInvoker : nullptr;
+}
+
 #pragma mark - RCTReloadListener
 
 - (void)didReceiveReloadCommand

diff --git a/packages/react-native/ReactCommon/react/runtime/platform/ios/ReactCommon/RCTInstance.h b/packages/react-native/ReactCommon/react/runtime/platform/ios/ReactCommon/RCTInstance.h
@@ -11,6 +11,7 @@
 
 #import <React/RCTDefines.h>
 #import <React/RCTJavaScriptLoader.h>
+#import <ReactCommon/CallInvoker.h>
 #import <jsinspector-modern/ReactCdp.h>
 #import <react/runtime/JSRuntimeFactory.h>
 
@@ -85,6 +86,12 @@ NS_ASSUME_NONNULL_BEGIN
 
 @property (nonatomic, readonly, strong) RCTSurfacePresenter *surfacePresenter;
 
+/**
+ * The CallInvoker this instance hands to TurboModules. Schedules work on the JS thread with a priority, and can be
+ * called from any thread. Set during init; null once the instance is invalidated.
+ */
+@property (nonatomic, readonly) std::shared_ptr<facebook::react::CallInvoker> jsCallInvoker;
+
 @end
 
 NS_ASSUME_NONNULL_END
diff --git a/packages/react-native/ReactCommon/react/runtime/platform/ios/ReactCommon/RCTInstance.mm b/packages/react-native/ReactCommon/react/runtime/platform/ios/ReactCommon/RCTInstance.mm
@@ -74,6 +74,7 @@ @implementation RCTInstance {
   RCTDisplayLink *_displayLink;
   RCTTurboModuleManager *_turboModuleManager;
   RCTBridgeProxy *_bridgeProxy;
+  std::shared_ptr<CallInvoker> _jsCallInvoker;
   std::mutex _invalidationMutex;
   std::atomic<bool> _valid;
   RCTJSThreadManager *_jsThreadManager;
@@ -207,6 +208,11 @@ - (void)invalidate
   }];
 }
 
+- (std::shared_ptr<CallInvoker>)jsCallInvoker
+{
+  return _valid ? _jsCallInvoker : nullptr;
+}
+
 - (void)registerSegmentWithId:(NSNumber *)segmentId path:(NSString *)path
 {
   if (_valid) {
@@ -290,6 +296,7 @@ - (void)_start
   timerManager->setRuntimeExecutor(bufferedRuntimeExecutor);
 
   auto jsCallInvoker = _reactInstance->createJSCallInvoker();
+  _jsCallInvoker = jsCallInvoker;
   RCTBridgeProxy *bridgeProxy =
       [[RCTBridgeProxy alloc] initWithViewRegistry:_bridgeModuleDecorator.viewRegistry_DEPRECATED
           moduleRegistry:_bridgeModuleDecorator.moduleRegistry

diff --git a/scripts/cxx-api/api-snapshots/ReactAppleDebugCxx.api b/scripts/cxx-api/api-snapshots/ReactAppleDebugCxx.api
@@ -1159,6 +1159,7 @@ interface RCTHost : public NSObject {
   public virtual instancetype initWithBundleURL:hostDelegate:turboModuleManagerDelegate:jsEngineProvider:launchOptions:(NSURL* bundleURL, id<RCTHostDelegate> hostDelegate, id<RCTTurboModuleManagerDelegate> turboModuleManagerDelegate, RCTHostJSEngineProvider jsEngineProvider, _Nullable NSDictionary* launchOptions);
   public virtual instancetype initWithBundleURLProvider:hostDelegate:turboModuleManagerDelegate:jsEngineProvider:launchOptions:(RCTHostBundleURLProvider provider, id<RCTHostDelegate> hostDelegate, id<RCTTurboModuleManagerDelegate> turboModuleManagerDelegate, RCTHostJSEngineProvider jsEngineProvider, _Nullable NSDictionary* launchOptions);
   public virtual instancetype initWithBundleURLProvider:hostDelegate:turboModuleManagerDelegate:jsEngineProvider:launchOptions:bundleConfiguration:devMenuConfiguration:(RCTHostBundleURLProvider provider, id<RCTHostDelegate> hostDelegate, id<RCTTurboModuleManagerDelegate> turboModuleManagerDelegate, RCTHostJSEngineProvider jsEngineProvider, _Nullable NSDictionary* launchOptions, RCTBundleConfiguration* bundleConfiguration, RCTDevMenuConfiguration* devMenuConfiguration);
+  public virtual std::shared_ptr<facebook::react::CallInvoker> jsCallInvoker();
   public virtual void callFunctionOnJSModule:method:args:(NSString* moduleName, NSString* method, NSArray* args);
   public virtual void start();
 }
@@ -1258,6 +1259,7 @@ interface RCTInspectorWebSocketReporter : public NSObject {
 }
 
 interface RCTInstance : public NSObject {
+  public @property (assign, readonly) std::shared_ptr<facebook::react::CallInvoker> jsCallInvoker;
   public @property (strong, readonly) RCTSurfacePresenter* surfacePresenter;
   public virtual instancetype initWithDelegate:jsRuntimeFactory:bundleManager:turboModuleManagerDelegate:moduleRegistry:parentInspectorTarget:launchOptions:(id<RCTInstanceDelegate> delegate, std::shared_ptr<facebook::react::JSRuntimeFactory> jsRuntimeFactory, RCTBundleManager* bundleManager, id<RCTTurboModuleManagerDelegate> turboModuleManagerDelegate, RCTModuleRegistry* moduleRegistry, facebook::react::jsinspector_modern::HostTarget* parentInspectorTarget, _Nullable NSDictionary* launchOptions);
   public virtual instancetype initWithDelegate:jsRuntimeFactory:bundleManager:turboModuleManagerDelegate:moduleRegistry:parentInspectorTarget:launchOptions:devMenuConfiguration:(id<RCTInstanceDelegate> delegate, std::shared_ptr<facebook::react::JSRuntimeFactory> jsRuntimeFactory, RCTBundleManager* bundleManager, id<RCTTurboModuleManagerDelegate> turboModuleManagerDelegate, RCTModuleRegistry* moduleRegistry, facebook::react::jsinspector_modern::HostTarget* parentInspectorTarget, _Nullable NSDictionary* launchOptions, RCTDevMenuConfiguration* _Nullable devMenuConfiguration);

diff --git a/scripts/cxx-api/api-snapshots/ReactAppleNewarchCxx.api b/scripts/cxx-api/api-snapshots/ReactAppleNewarchCxx.api
@@ -1159,6 +1159,7 @@ interface RCTHost : public NSObject {
   public virtual instancetype initWithBundleURL:hostDelegate:turboModuleManagerDelegate:jsEngineProvider:launchOptions:(NSURL* bundleURL, id<RCTHostDelegate> hostDelegate, id<RCTTurboModuleManagerDelegate> turboModuleManagerDelegate, RCTHostJSEngineProvider jsEngineProvider, _Nullable NSDictionary* launchOptions);
   public virtual instancetype initWithBundleURLProvider:hostDelegate:turboModuleManagerDelegate:jsEngineProvider:launchOptions:(RCTHostBundleURLProvider provider, id<RCTHostDelegate> hostDelegate, id<RCTTurboModuleManagerDelegate> turboModuleManagerDelegate, RCTHostJSEngineProvider jsEngineProvider, _Nullable NSDictionary* launchOptions);
   public virtual instancetype initWithBundleURLProvider:hostDelegate:turboModuleManagerDelegate:jsEngineProvider:launchOptions:bundleConfiguration:devMenuConfiguration:(RCTHostBundleURLProvider provider, id<RCTHostDelegate> hostDelegate, id<RCTTurboModuleManagerDelegate> turboModuleManagerDelegate, RCTHostJSEngineProvider jsEngineProvider, _Nullable NSDictionary* launchOptions, RCTBundleConfiguration* bundleConfiguration, RCTDevMenuConfiguration* devMenuConfiguration);
+  public virtual std::shared_ptr<facebook::react::CallInvoker> jsCallInvoker();
   public virtual void callFunctionOnJSModule:method:args:(NSString* moduleName, NSString* method, NSArray* args);
   public virtual void start();
 }
@@ -1258,6 +1259,7 @@ interface RCTInspectorWebSocketReporter : public NSObject {
 }
 
 interface RCTInstance : public NSObject {
+  public @property (assign, readonly) std::shared_ptr<facebook::react::CallInvoker> jsCallInvoker;
   public @property (strong, readonly) RCTSurfacePresenter* surfacePresenter;
   public virtual instancetype initWithDelegate:jsRuntimeFactory:bundleManager:turboModuleManagerDelegate:moduleRegistry:parentInspectorTarget:launchOptions:(id<RCTInstanceDelegate> delegate, std::shared_ptr<facebook::react::JSRuntimeFactory> jsRuntimeFactory, RCTBundleManager* bundleManager, id<RCTTurboModuleManagerDelegate> turboModuleManagerDelegate, RCTModuleRegistry* moduleRegistry, facebook::react::jsinspector_modern::HostTarget* parentInspectorTarget, _Nullable NSDictionary* launchOptions);
   public virtual instancetype initWithDelegate:jsRuntimeFactory:bundleManager:turboModuleManagerDelegate:moduleRegistry:parentInspectorTarget:launchOptions:devMenuConfiguration:(id<RCTInstanceDelegate> delegate, std::shared_ptr<facebook::react::JSRuntimeFactory> jsRuntimeFactory, RCTBundleManager* bundleManager, id<RCTTurboModuleManagerDelegate> turboModuleManagerDelegate, RCTModuleRegistry* moduleRegistry, facebook::react::jsinspector_modern::HostTarget* parentInspectorTarget, _Nullable NSDictionary* launchOptions, RCTDevMenuConfiguration* _Nullable devMenuConfiguration);

diff --git a/scripts/cxx-api/api-snapshots/ReactAppleReleaseCxx.api b/scripts/cxx-api/api-snapshots/ReactAppleReleaseCxx.api
@@ -1159,6 +1159,7 @@ interface RCTHost : public NSObject {
   public virtual instancetype initWithBundleURL:hostDelegate:turboModuleManagerDelegate:jsEngineProvider:launchOptions:(NSURL* bundleURL, id<RCTHostDelegate> hostDelegate, id<RCTTurboModuleManagerDelegate> turboModuleManagerDelegate, RCTHostJSEngineProvider jsEngineProvider, _Nullable NSDictionary* launchOptions);
   public virtual instancetype initWithBundleURLProvider:hostDelegate:turboModuleManagerDelegate:jsEngineProvider:launchOptions:(RCTHostBundleURLProvider provider, id<RCTHostDelegate> hostDelegate, id<RCTTurboModuleManagerDelegate> turboModuleManagerDelegate, RCTHostJSEngineProvider jsEngineProvider, _Nullable NSDictionary* launchOptions);
   public virtual instancetype initWithBundleURLProvider:hostDelegate:turboModuleManagerDelegate:jsEngineProvider:launchOptions:bundleConfiguration:devMenuConfiguration:(RCTHostBundleURLProvider provider, id<RCTHostDelegate> hostDelegate, id<RCTTurboModuleManagerDelegate> turboModuleManagerDelegate, RCTHostJSEngineProvider jsEngineProvider, _Nullable NSDictionary* launchOptions, RCTBundleConfiguration* bundleConfiguration, RCTDevMenuConfiguration* devMenuConfiguration);
+  public virtual std::shared_ptr<facebook::react::CallInvoker> jsCallInvoker();
   public virtual void callFunctionOnJSModule:method:args:(NSString* moduleName, NSString* method, NSArray* args);
   public virtual void start();
 }
@@ -1258,6 +1259,7 @@ interface RCTInspectorWebSocketReporter : public NSObject {
 }
 
 interface RCTInstance : public NSObject {
+  public @property (assign, readonly) std::shared_ptr<facebook::react::CallInvoker> jsCallInvoker;
   public @property (strong, readonly) RCTSurfacePresenter* surfacePresenter;
   public virtual instancetype initWithDelegate:jsRuntimeFactory:bundleManager:turboModuleManagerDelegate:moduleRegistry:parentInspectorTarget:launchOptions:(id<RCTInstanceDelegate> delegate, std::shared_ptr<facebook::react::JSRuntimeFactory> jsRuntimeFactory, RCTBundleManager* bundleManager, id<RCTTurboModuleManagerDelegate> turboModuleManagerDelegate, RCTModuleRegistry* moduleRegistry, facebook::react::jsinspector_modern::HostTarget* parentInspectorTarget, _Nullable NSDictionary* launchOptions);
   public virtual instancetype initWithDelegate:jsRuntimeFactory:bundleManager:turboModuleManagerDelegate:moduleRegistry:parentInspectorTarget:launchOptions:devMenuConfiguration:(id<RCTInstanceDelegate> delegate, std::shared_ptr<facebook::react::JSRuntimeFactory> jsRuntimeFactory, RCTBundleManager* bundleManager, id<RCTTurboModuleManagerDelegate> turboModuleManagerDelegate, RCTModuleRegistry* moduleRegistry, facebook::react::jsinspector_modern::HostTarget* parentInspectorTarget, _Nullable NSDictionary* launchOptions, RCTDevMenuConfiguration* _Nullable devMenuConfiguration);