Support light/dark mode toggling via Emulation.setEmulatedMedia (#56510)

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

Implements the `Emulation.setEmulatedMedia` CDP method in `jsinspector-modern`, scoped to `prefers-color-scheme` emulation. This allows CDP clients to toggle the app color scheme for debugging and visual verification.

**Implementation notes**

Adds a new `EmulationAgent` CDP domain agent that validates the `features` param, rejects unsupported media features/types, and delegates to `HostTargetDelegate::onSetEmulatedMedia`. Platform delegates:

- **Android**: Calls `AppCompatDelegate.setDefaultNightMode()` on the UI thread via JNI through `ReactHostImpl`.
- **iOS**: Sets `overrideUserInterfaceStyle` on the key `UIWindow`.

Both platforms trigger their existing `Appearance` change event propagation to JS automatically.

Changelog:
[General][Added] - **React Native DevTools**: Add support for light/dark mode emulation via `Emulation.setEmulatedMedia`

Reviewed By: hoxyq

Differential Revision: D101624433

fbshipit-source-id: e795bf22327142bae0a7275ee92f7f778736541f
This commit is contained in:
Alex Hunt authored and meta-codesync[bot] committed 2026-04-21 05:21:12 -07:00
1 parent bedf33ff64
commit 11a5432cb2
14 files changed
+328 -1

No files matched your search

@@ -2821,6 +2821,7 @@ class facebook::react::JReactHostInspectorTarget : public jni::HybridClass<faceb
public static constexpr auto kJavaDescriptor;
public static jni::local_ref<JReactHostInspectorTarget::jhybriddata> initHybrid(jni::alias_ref<JReactHostInspectorTarget::jhybridobject> jobj, jni::alias_ref<facebook::react::JReactHostImpl> reactHost, jni::alias_ref<JExecutor::javaobject> javaExecutor);
public static void registerNatives();
public virtual bool onSetEmulatedMedia(const facebook::react::jsinspector_modern::HostTargetDelegate::SetEmulatedMediaRequest&) override;
public virtual facebook::react::jsinspector_modern::HostTargetMetadata getMetadata() override;
public virtual facebook::react::jsinspector_modern::HostTargetTracingDelegate* getTracingDelegate() override;
public virtual std::optional<std::string> captureScreenshot(const facebook::react::jsinspector_modern::HostTargetDelegate::PageCaptureScreenshotRequest&) override;
@@ -7278,6 +7279,7 @@ struct facebook::react::JReactHostImpl : public facebook::jni::JavaClass<faceboo
public jni::local_ref<jni::JString> captureScreenshot(const std::string& format, int quality) const;
public static constexpr auto kJavaDescriptor;
public void loadNetworkResource(const std::string& url, jni::local_ref<InspectorNetworkRequestListener::javaobject> listener) const;
public void setEmulatedMedia(const std::string& colorScheme);
public void setPausedInDebuggerMessage(std::optional<std::string> message);
}
@@ -10320,6 +10322,11 @@ class facebook::react::jsinspector_modern::ConsoleTaskOrchestrator {
public ~ConsoleTaskOrchestrator() = default;
}
class facebook::react::jsinspector_modern::EmulationAgent {
public EmulationAgent(facebook::react::jsinspector_modern::FrontendChannel frontendChannel, facebook::react::jsinspector_modern::HostTargetController& hostTargetController);
public bool handleRequest(const facebook::react::jsinspector_modern::cdp::PreparsedRequest& req);
}
class facebook::react::jsinspector_modern::ExecutionContextManager {
public int32_t allocateExecutionContextId();
}
@@ -10417,6 +10424,7 @@ class facebook::react::jsinspector_modern::HostTargetDelegate : public facebook:
public HostTargetDelegate(facebook::react::jsinspector_modern::HostTargetDelegate&&) = delete;
public facebook::react::jsinspector_modern::HostTargetDelegate& operator=(const facebook::react::jsinspector_modern::HostTargetDelegate&) = delete;
public facebook::react::jsinspector_modern::HostTargetDelegate& operator=(facebook::react::jsinspector_modern::HostTargetDelegate&&) = delete;
public virtual bool onSetEmulatedMedia(const facebook::react::jsinspector_modern::HostTargetDelegate::SetEmulatedMediaRequest&);
public virtual facebook::react::jsinspector_modern::HostTargetMetadata getMetadata() = 0;
public virtual facebook::react::jsinspector_modern::HostTargetTracingDelegate* getTracingDelegate();
public virtual std::optional<std::string> captureScreenshot(const facebook::react::jsinspector_modern::HostTargetDelegate::PageCaptureScreenshotRequest&);
@@ -10442,6 +10450,11 @@ struct facebook::react::jsinspector_modern::HostTargetDelegate::PageReloadReques
public std::optional<std::string> scriptToEvaluateOnLoad;
}
struct facebook::react::jsinspector_modern::HostTargetDelegate::SetEmulatedMediaRequest {
public bool operator==(const facebook::react::jsinspector_modern::HostTargetDelegate::SetEmulatedMediaRequest& rhs) const;
public std::string colorScheme;
}
class facebook::react::jsinspector_modern::HostTargetTraceRecording {
public HostTargetTraceRecording(facebook::react::jsinspector_modern::HostTarget& hostTarget, facebook::react::jsinspector_modern::tracing::Mode tracingMode, std::set<facebook::react::jsinspector_modern::tracing::Category> enabledCategories, std::optional<facebook::react::HighResDuration> windowSize = std::nullopt);
public bool isBackgroundInitiated() const;
@@ -2818,6 +2818,7 @@ class facebook::react::JReactHostInspectorTarget : public jni::HybridClass<faceb
public static constexpr auto kJavaDescriptor;
public static jni::local_ref<JReactHostInspectorTarget::jhybriddata> initHybrid(jni::alias_ref<JReactHostInspectorTarget::jhybridobject> jobj, jni::alias_ref<facebook::react::JReactHostImpl> reactHost, jni::alias_ref<JExecutor::javaobject> javaExecutor);
public static void registerNatives();
public virtual bool onSetEmulatedMedia(const facebook::react::jsinspector_modern::HostTargetDelegate::SetEmulatedMediaRequest&) override;
public virtual facebook::react::jsinspector_modern::HostTargetMetadata getMetadata() override;
public virtual facebook::react::jsinspector_modern::HostTargetTracingDelegate* getTracingDelegate() override;
public virtual std::optional<std::string> captureScreenshot(const facebook::react::jsinspector_modern::HostTargetDelegate::PageCaptureScreenshotRequest&) override;
@@ -7269,6 +7270,7 @@ struct facebook::react::JReactHostImpl : public facebook::jni::JavaClass<faceboo
public jni::local_ref<jni::JString> captureScreenshot(const std::string& format, int quality) const;
public static constexpr auto kJavaDescriptor;
public void loadNetworkResource(const std::string& url, jni::local_ref<InspectorNetworkRequestListener::javaobject> listener) const;
public void setEmulatedMedia(const std::string& colorScheme);
public void setPausedInDebuggerMessage(std::optional<std::string> message);
}
@@ -10176,6 +10178,11 @@ class facebook::react::jsinspector_modern::ConsoleTaskOrchestrator {
public ~ConsoleTaskOrchestrator() = default;
}
class facebook::react::jsinspector_modern::EmulationAgent {
public EmulationAgent(facebook::react::jsinspector_modern::FrontendChannel frontendChannel, facebook::react::jsinspector_modern::HostTargetController& hostTargetController);
public bool handleRequest(const facebook::react::jsinspector_modern::cdp::PreparsedRequest& req);
}
class facebook::react::jsinspector_modern::ExecutionContextManager {
public int32_t allocateExecutionContextId();
}
@@ -10273,6 +10280,7 @@ class facebook::react::jsinspector_modern::HostTargetDelegate : public facebook:
public HostTargetDelegate(facebook::react::jsinspector_modern::HostTargetDelegate&&) = delete;
public facebook::react::jsinspector_modern::HostTargetDelegate& operator=(const facebook::react::jsinspector_modern::HostTargetDelegate&) = delete;
public facebook::react::jsinspector_modern::HostTargetDelegate& operator=(facebook::react::jsinspector_modern::HostTargetDelegate&&) = delete;
public virtual bool onSetEmulatedMedia(const facebook::react::jsinspector_modern::HostTargetDelegate::SetEmulatedMediaRequest&);
public virtual facebook::react::jsinspector_modern::HostTargetMetadata getMetadata() = 0;
public virtual facebook::react::jsinspector_modern::HostTargetTracingDelegate* getTracingDelegate();
public virtual std::optional<std::string> captureScreenshot(const facebook::react::jsinspector_modern::HostTargetDelegate::PageCaptureScreenshotRequest&);
@@ -10298,6 +10306,11 @@ struct facebook::react::jsinspector_modern::HostTargetDelegate::PageReloadReques
public std::optional<std::string> scriptToEvaluateOnLoad;
}
struct facebook::react::jsinspector_modern::HostTargetDelegate::SetEmulatedMediaRequest {
public bool operator==(const facebook::react::jsinspector_modern::HostTargetDelegate::SetEmulatedMediaRequest& rhs) const;
public std::string colorScheme;
}
class facebook::react::jsinspector_modern::HostTargetTraceRecording {
public HostTargetTraceRecording(facebook::react::jsinspector_modern::HostTarget& hostTarget, facebook::react::jsinspector_modern::tracing::Mode tracingMode, std::set<facebook::react::jsinspector_modern::tracing::Category> enabledCategories, std::optional<facebook::react::HighResDuration> windowSize = std::nullopt);
public bool isBackgroundInitiated() const;
@@ -12603,6 +12603,11 @@ class facebook::react::jsinspector_modern::ConsoleTaskOrchestrator {
public ~ConsoleTaskOrchestrator() = default;
}
class facebook::react::jsinspector_modern::EmulationAgent {
public EmulationAgent(facebook::react::jsinspector_modern::FrontendChannel frontendChannel, facebook::react::jsinspector_modern::HostTargetController& hostTargetController);
public bool handleRequest(const facebook::react::jsinspector_modern::cdp::PreparsedRequest& req);
}
class facebook::react::jsinspector_modern::ExecutionContextManager {
public int32_t allocateExecutionContextId();
}
@@ -12700,6 +12705,7 @@ class facebook::react::jsinspector_modern::HostTargetDelegate : public facebook:
public HostTargetDelegate(facebook::react::jsinspector_modern::HostTargetDelegate&&) = delete;
public facebook::react::jsinspector_modern::HostTargetDelegate& operator=(const facebook::react::jsinspector_modern::HostTargetDelegate&) = delete;
public facebook::react::jsinspector_modern::HostTargetDelegate& operator=(facebook::react::jsinspector_modern::HostTargetDelegate&&) = delete;
public virtual bool onSetEmulatedMedia(const facebook::react::jsinspector_modern::HostTargetDelegate::SetEmulatedMediaRequest&);
public virtual facebook::react::jsinspector_modern::HostTargetMetadata getMetadata() = 0;
public virtual facebook::react::jsinspector_modern::HostTargetTracingDelegate* getTracingDelegate();
public virtual std::optional<std::string> captureScreenshot(const facebook::react::jsinspector_modern::HostTargetDelegate::PageCaptureScreenshotRequest&);
@@ -12725,6 +12731,11 @@ struct facebook::react::jsinspector_modern::HostTargetDelegate::PageReloadReques
public std::optional<std::string> scriptToEvaluateOnLoad;
}
struct facebook::react::jsinspector_modern::HostTargetDelegate::SetEmulatedMediaRequest {
public bool operator==(const facebook::react::jsinspector_modern::HostTargetDelegate::SetEmulatedMediaRequest& rhs) const;
public std::string colorScheme;
}
class facebook::react::jsinspector_modern::HostTargetTraceRecording {
public HostTargetTraceRecording(facebook::react::jsinspector_modern::HostTarget& hostTarget, facebook::react::jsinspector_modern::tracing::Mode tracingMode, std::set<facebook::react::jsinspector_modern::tracing::Category> enabledCategories, std::optional<facebook::react::HighResDuration> windowSize = std::nullopt);
public bool isBackgroundInitiated() const;
@@ -12469,6 +12469,11 @@ class facebook::react::jsinspector_modern::ConsoleTaskOrchestrator {
public ~ConsoleTaskOrchestrator() = default;
}
class facebook::react::jsinspector_modern::EmulationAgent {
public EmulationAgent(facebook::react::jsinspector_modern::FrontendChannel frontendChannel, facebook::react::jsinspector_modern::HostTargetController& hostTargetController);
public bool handleRequest(const facebook::react::jsinspector_modern::cdp::PreparsedRequest& req);
}
class facebook::react::jsinspector_modern::ExecutionContextManager {
public int32_t allocateExecutionContextId();
}
@@ -12566,6 +12571,7 @@ class facebook::react::jsinspector_modern::HostTargetDelegate : public facebook:
public HostTargetDelegate(facebook::react::jsinspector_modern::HostTargetDelegate&&) = delete;
public facebook::react::jsinspector_modern::HostTargetDelegate& operator=(const facebook::react::jsinspector_modern::HostTargetDelegate&) = delete;
public facebook::react::jsinspector_modern::HostTargetDelegate& operator=(facebook::react::jsinspector_modern::HostTargetDelegate&&) = delete;
public virtual bool onSetEmulatedMedia(const facebook::react::jsinspector_modern::HostTargetDelegate::SetEmulatedMediaRequest&);
public virtual facebook::react::jsinspector_modern::HostTargetMetadata getMetadata() = 0;
public virtual facebook::react::jsinspector_modern::HostTargetTracingDelegate* getTracingDelegate();
public virtual std::optional<std::string> captureScreenshot(const facebook::react::jsinspector_modern::HostTargetDelegate::PageCaptureScreenshotRequest&);
@@ -12591,6 +12597,11 @@ struct facebook::react::jsinspector_modern::HostTargetDelegate::PageReloadReques
public std::optional<std::string> scriptToEvaluateOnLoad;
}
struct facebook::react::jsinspector_modern::HostTargetDelegate::SetEmulatedMediaRequest {
public bool operator==(const facebook::react::jsinspector_modern::HostTargetDelegate::SetEmulatedMediaRequest& rhs) const;
public std::string colorScheme;
}
class facebook::react::jsinspector_modern::HostTargetTraceRecording {
public HostTargetTraceRecording(facebook::react::jsinspector_modern::HostTarget& hostTarget, facebook::react::jsinspector_modern::tracing::Mode tracingMode, std::set<facebook::react::jsinspector_modern::tracing::Category> enabledCategories, std::optional<facebook::react::HighResDuration> windowSize = std::nullopt);
public bool isBackgroundInitiated() const;
@@ -7430,6 +7430,11 @@ class facebook::react::jsinspector_modern::ConsoleTaskOrchestrator {
public ~ConsoleTaskOrchestrator() = default;
}
class facebook::react::jsinspector_modern::EmulationAgent {
public EmulationAgent(facebook::react::jsinspector_modern::FrontendChannel frontendChannel, facebook::react::jsinspector_modern::HostTargetController& hostTargetController);
public bool handleRequest(const facebook::react::jsinspector_modern::cdp::PreparsedRequest& req);
}
class facebook::react::jsinspector_modern::ExecutionContextManager {
public int32_t allocateExecutionContextId();
}
@@ -7527,6 +7532,7 @@ class facebook::react::jsinspector_modern::HostTargetDelegate : public facebook:
public HostTargetDelegate(facebook::react::jsinspector_modern::HostTargetDelegate&&) = delete;
public facebook::react::jsinspector_modern::HostTargetDelegate& operator=(const facebook::react::jsinspector_modern::HostTargetDelegate&) = delete;
public facebook::react::jsinspector_modern::HostTargetDelegate& operator=(facebook::react::jsinspector_modern::HostTargetDelegate&&) = delete;
public virtual bool onSetEmulatedMedia(const facebook::react::jsinspector_modern::HostTargetDelegate::SetEmulatedMediaRequest&);
public virtual facebook::react::jsinspector_modern::HostTargetMetadata getMetadata() = 0;
public virtual facebook::react::jsinspector_modern::HostTargetTracingDelegate* getTracingDelegate();
public virtual std::optional<std::string> captureScreenshot(const facebook::react::jsinspector_modern::HostTargetDelegate::PageCaptureScreenshotRequest&);
@@ -7552,6 +7558,11 @@ struct facebook::react::jsinspector_modern::HostTargetDelegate::PageReloadReques
public std::optional<std::string> scriptToEvaluateOnLoad;
}
struct facebook::react::jsinspector_modern::HostTargetDelegate::SetEmulatedMediaRequest {
public bool operator==(const facebook::react::jsinspector_modern::HostTargetDelegate::SetEmulatedMediaRequest& rhs) const;
public std::string colorScheme;
}
class facebook::react::jsinspector_modern::HostTargetTraceRecording {
public HostTargetTraceRecording(facebook::react::jsinspector_modern::HostTarget& hostTarget, facebook::react::jsinspector_modern::tracing::Mode tracingMode, std::set<facebook::react::jsinspector_modern::tracing::Category> enabledCategories, std::optional<facebook::react::HighResDuration> windowSize = std::nullopt);
public bool isBackgroundInitiated() const;
@@ -7421,6 +7421,11 @@ class facebook::react::jsinspector_modern::ConsoleTaskOrchestrator {
public ~ConsoleTaskOrchestrator() = default;
}
class facebook::react::jsinspector_modern::EmulationAgent {
public EmulationAgent(facebook::react::jsinspector_modern::FrontendChannel frontendChannel, facebook::react::jsinspector_modern::HostTargetController& hostTargetController);
public bool handleRequest(const facebook::react::jsinspector_modern::cdp::PreparsedRequest& req);
}
class facebook::react::jsinspector_modern::ExecutionContextManager {
public int32_t allocateExecutionContextId();
}
@@ -7518,6 +7523,7 @@ class facebook::react::jsinspector_modern::HostTargetDelegate : public facebook:
public HostTargetDelegate(facebook::react::jsinspector_modern::HostTargetDelegate&&) = delete;
public facebook::react::jsinspector_modern::HostTargetDelegate& operator=(const facebook::react::jsinspector_modern::HostTargetDelegate&) = delete;
public facebook::react::jsinspector_modern::HostTargetDelegate& operator=(facebook::react::jsinspector_modern::HostTargetDelegate&&) = delete;
public virtual bool onSetEmulatedMedia(const facebook::react::jsinspector_modern::HostTargetDelegate::SetEmulatedMediaRequest&);
public virtual facebook::react::jsinspector_modern::HostTargetMetadata getMetadata() = 0;
public virtual facebook::react::jsinspector_modern::HostTargetTracingDelegate* getTracingDelegate();
public virtual std::optional<std::string> captureScreenshot(const facebook::react::jsinspector_modern::HostTargetDelegate::PageCaptureScreenshotRequest&);
@@ -7543,6 +7549,11 @@ struct facebook::react::jsinspector_modern::HostTargetDelegate::PageReloadReques
public std::optional<std::string> scriptToEvaluateOnLoad;
}
struct facebook::react::jsinspector_modern::HostTargetDelegate::SetEmulatedMediaRequest {
public bool operator==(const facebook::react::jsinspector_modern::HostTargetDelegate::SetEmulatedMediaRequest& rhs) const;
public std::string colorScheme;
}
class facebook::react::jsinspector_modern::HostTargetTraceRecording {
public HostTargetTraceRecording(facebook::react::jsinspector_modern::HostTarget& hostTarget, facebook::react::jsinspector_modern::tracing::Mode tracingMode, std::set<facebook::react::jsinspector_modern::tracing::Category> enabledCategories, std::optional<facebook::react::HighResDuration> windowSize = std::nullopt);
public bool isBackgroundInitiated() const;