Skip to content

Add unit tests for enableMainQueueCoordinatorOnIOS#56934

Closed
javache wants to merge 4 commits into
facebook:mainfrom
javache:export-D105972787
Closed

Add unit tests for enableMainQueueCoordinatorOnIOS#56934
javache wants to merge 4 commits into
facebook:mainfrom
javache:export-D105972787

Conversation

@javache
Copy link
Copy Markdown
Member

@javache javache commented May 22, 2026

Summary:
The enableMainQueueCoordinatorOnIOS flag swaps two non-trivial threading primitives — RCTUnsafeExecuteOnMainQueueSync uses either dispatch_sync(main, ...) or unsafeExecuteOnMainThreadSync, and executeSynchronouslyOnSameThread_CAN_DEADLOCK switches between saferExecuteSynchronouslyOnSameThread_CAN_DEADLOCK and the legacy variant. There was zero in-tree test coverage for either branch.

Adds three characterization tests:

  • testRCTUnsafeExecuteOnMainQueueSync_flagOff_runsBlockOnMainFromBG and ..._flagOn_... pin the basic contract for both branches: from a background thread, the block runs on the main queue and the call returns synchronously.
  • testExecuteSynchronouslyOnSameThread_flagOn_pumpsUITasksWhileWaitingForJS is the coordinator's signature property: while the main thread is blocked in the safer impl's wait loop, a UI task posted from a background thread is pumped before the runtime work resumes. The test wires a deliberately slow RuntimeExecutor (300ms sleep before invoking its callback) so a BG thread can post a RCTUnsafeExecuteOnMainQueueSync work item during the window, then asserts the ordering via a monotonic sequence counter.
  • basicUIThreadExecution (in RuntimeSchedulerTest.cpp) mirrors the existing basicSameThreadExecution for the production call pattern: the caller is the GTest test body (main NSThread on Apple), so executeNowOnTheSameThread routes through the coordinator path. An off-main driver thread ticks the stub queue so main can wake up.

Changelog: [Internal]

Differential Revision: D105972787

javache and others added 4 commits May 22, 2026 02:55
Summary:
Replace the `std::mutex` + `std::condition_variable` + `std::shared_ptr<bool>` trio that gates the JS thread on main-queue module construction with a single `dispatch_semaphore_t`. The wait block is invoked exactly once (from `_loadScriptFromSource:`'s `beforeLoad` lambda), so single-shot semaphore semantics fit the contract directly — no condition predicate, no shared state captured by three independent `shared_ptr`s.

Net: 12 lines deleted, 1 captured object instead of 3, no behavior change.

Changelog: [Internal]

Differential Revision: D105953979
…always-on

Summary:
The `enableEagerMainQueueModulesOnIOS` runtime gate has finished rollout and is no longer needed. Drop the flag from the feature-flag config, regenerate the per-language accessors, and inline the previously-gated body in `RCTInstance._start` so the eager main-queue module setup always runs. Also drops the now-dead override and trims the test that exercised the flag-off branch.

After this change, when `RCTInstance` starts up, it always consults `RCTInstanceDelegate.unstableModulesRequiringMainQueueSetup`, initializes the returned modules on the main queue, and blocks the JS thread on that completion before evaluating the bundle.

Changelog:
[iOS][Changed] - Native modules listed in `unstableModulesRequiringMainQueueSetup` are now always initialized eagerly on the main queue during React Native init; the previous `enableEagerMainQueueModulesOnIOS` opt-in flag has been removed.

Differential Revision: D105954235
Summary:
The `enableVirtualViewDebugFeatures` feature flag was effectively dead — its only MobileConfig backing param (`rn_fling.fling_debug`) hadn't been updated in 365+ days, and the codemod-tracking diff D105936405 was already queued to remove the three native overrides. Rather than carry the FF + JS overlay surface forward, delete the whole stack: the FF, the overrides, the BUCK dep, the JS overlay components (`FlingItemOverlay`, `FlingDebugItemOverlay`, `FlingDebugOverlay`), the debug-log helpers in the native ScrollView/VirtualView implementations on both iOS and Android, and the now-orphaned references in `VirtualCollectionView`.

Net: 4 files deleted, the FF removed from the cross-language codegen, native debug logging dropped from 5 files (1 ObjC++, 4 Kotlin), and consumer code in `VirtualCollectionView` simplified.

Changelog:
[General][Removed] - Remove unused `enableVirtualViewDebugFeatures` feature flag and the associated `FlingItemOverlay` / `FlingDebugItemOverlay` debug surfaces.

Differential Revision: D105959433
Summary:
The `enableMainQueueCoordinatorOnIOS` flag swaps two non-trivial threading primitives — `RCTUnsafeExecuteOnMainQueueSync` uses either `dispatch_sync(main, ...)` or `unsafeExecuteOnMainThreadSync`, and `executeSynchronouslyOnSameThread_CAN_DEADLOCK` switches between `saferExecuteSynchronouslyOnSameThread_CAN_DEADLOCK` and the legacy variant. There was zero in-tree test coverage for either branch.

Adds three characterization tests:

- `testRCTUnsafeExecuteOnMainQueueSync_flagOff_runsBlockOnMainFromBG` and `..._flagOn_...` pin the basic contract for both branches: from a background thread, the block runs on the main queue and the call returns synchronously.
- `testExecuteSynchronouslyOnSameThread_flagOn_pumpsUITasksWhileWaitingForJS` is the coordinator's signature property: while the main thread is blocked in the safer impl's wait loop, a UI task posted from a background thread is pumped before the runtime work resumes. The test wires a deliberately slow `RuntimeExecutor` (300ms sleep before invoking its callback) so a BG thread can post a `RCTUnsafeExecuteOnMainQueueSync` work item during the window, then asserts the ordering via a monotonic sequence counter.
- `basicUIThreadExecution` (in `RuntimeSchedulerTest.cpp`) mirrors the existing `basicSameThreadExecution` for the production call pattern: the caller is the GTest test body (main NSThread on Apple), so `executeNowOnTheSameThread` routes through the coordinator path. An off-main `driver` thread ticks the stub queue so main can wake up.

Changelog: [Internal]

Differential Revision: D105972787
@meta-cla meta-cla Bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label May 22, 2026
@meta-codesync
Copy link
Copy Markdown

meta-codesync Bot commented May 22, 2026

@javache has exported this pull request. If you are a Meta employee, you can view the originating Diff in D105972787.

@meta-codesync meta-codesync Bot closed this in 1632b74 May 22, 2026
@react-native-bot
Copy link
Copy Markdown
Collaborator

This pull request was successfully merged by @javache in 1632b74

When will my fix make it into a release? | How to file a pick request?

@react-native-bot react-native-bot added the Merged This PR has been merged. label May 22, 2026
@meta-codesync
Copy link
Copy Markdown

meta-codesync Bot commented May 22, 2026

This pull request has been merged in 1632b74.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. fb-exported Merged This PR has been merged. meta-exported p: Facebook Partner: Facebook Partner

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants