devtools-protocol 0.0.1427544 → 0.0.1428127

package/json/browser_protocol.json

@@ -9386,6 +9386,61 @@
                 "Runtime"
             ],
             "types": [
+                {
+                    "id": "SafeAreaInsets",
+                    "experimental": true,
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "top",
+                            "description": "Overrides safe-area-inset-top.",
+                            "optional": true,
+                            "type": "integer"
+                        },
+                        {
+                            "name": "topMax",
+                            "description": "Overrides safe-area-max-inset-top.",
+                            "optional": true,
+                            "type": "integer"
+                        },
+                        {
+                            "name": "left",
+                            "description": "Overrides safe-area-inset-left.",
+                            "optional": true,
+                            "type": "integer"
+                        },
+                        {
+                            "name": "leftMax",
+                            "description": "Overrides safe-area-max-inset-left.",
+                            "optional": true,
+                            "type": "integer"
+                        },
+                        {
+                            "name": "bottom",
+                            "description": "Overrides safe-area-inset-bottom.",
+                            "optional": true,
+                            "type": "integer"
+                        },
+                        {
+                            "name": "bottomMax",
+                            "description": "Overrides safe-area-max-inset-bottom.",
+                            "optional": true,
+                            "type": "integer"
+                        },
+                        {
+                            "name": "right",
+                            "description": "Overrides safe-area-inset-right.",
+                            "optional": true,
+                            "type": "integer"
+                        },
+                        {
+                            "name": "rightMax",
+                            "description": "Overrides safe-area-max-inset-right.",
+                            "optional": true,
+                            "type": "integer"
+                        }
+                    ]
+                },
                 {
                     "id": "ScreenOrientation",
                     "description": "Screen orientation.",
@@ -9781,6 +9836,17 @@
                         }
                     ]
                 },
+                {
+                    "name": "setSafeAreaInsetsOverride",
+                    "description": "Overrides the values for env(safe-area-inset-*) and env(safe-area-max-inset-*). Unset values will cause the\nrespective variables to be undefined, even if previously overridden.",
+                    "experimental": true,
+                    "parameters": [
+                        {
+                            "name": "insets",
+                            "$ref": "SafeAreaInsets"
+                        }
+                    ]
+                },
                 {
                     "name": "setDeviceMetricsOverride",
                     "description": "Overrides the values of device screen dimensions (window.screen.width, window.screen.height,\nwindow.innerWidth, window.innerHeight, and \"device-width\"/\"device-height\"-related CSS media\nquery results).",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devtools-protocol",
-  "version": "0.0.1427544",
+  "version": "0.0.1428127",
   "description": "The Chrome DevTools Protocol JSON",
   "repository": "https://github.com/ChromeDevTools/devtools-protocol",
   "author": "The Chromium Authors",

package/pdl/browser_protocol.pdl

@@ -4346,6 +4346,25 @@ domain Emulation
   depends on Page
   depends on Runtime
 
+  experimental type SafeAreaInsets extends object
+    properties
+      # Overrides safe-area-inset-top.
+      optional integer top
+      # Overrides safe-area-max-inset-top.
+      optional integer topMax
+      # Overrides safe-area-inset-left.
+      optional integer left
+      # Overrides safe-area-max-inset-left.
+      optional integer leftMax
+      # Overrides safe-area-inset-bottom.
+      optional integer bottom
+      # Overrides safe-area-max-inset-bottom.
+      optional integer bottomMax
+      # Overrides safe-area-inset-right.
+      optional integer right
+      # Overrides safe-area-max-inset-right.
+      optional integer rightMax
+
   # Screen orientation.
   type ScreenOrientation extends object
     properties
@@ -4516,6 +4535,12 @@ domain Emulation
       # cleared.
       optional DOM.RGBA color
 
+  # Overrides the values for env(safe-area-inset-*) and env(safe-area-max-inset-*). Unset values will cause the
+  # respective variables to be undefined, even if previously overridden.
+  experimental command setSafeAreaInsetsOverride
+    parameters
+      SafeAreaInsets insets
+
   # Overrides the values of device screen dimensions (window.screen.width, window.screen.height,
   # window.innerWidth, window.innerHeight, and "device-width"/"device-height"-related CSS media
   # query results).

package/types/protocol-mapping.d.ts

@@ -2752,6 +2752,14 @@ export namespace ProtocolMapping {
             paramsType: [Protocol.Emulation.SetDefaultBackgroundColorOverrideRequest?];
             returnType: void;
         };
+        /**
+         * Overrides the values for env(safe-area-inset-*) and env(safe-area-max-inset-*). Unset values will cause the
+         * respective variables to be undefined, even if previously overridden.
+         */
+        'Emulation.setSafeAreaInsetsOverride': {
+            paramsType: [Protocol.Emulation.SetSafeAreaInsetsOverrideRequest];
+            returnType: void;
+        };
         /**
          * Overrides the values of device screen dimensions (window.screen.width, window.screen.height,
          * window.innerWidth, window.innerHeight, and "device-width"/"device-height"-related CSS media

package/types/protocol-proxy-api.d.ts

@@ -1891,6 +1891,12 @@ export namespace ProtocolProxyApi {
          */
         setDefaultBackgroundColorOverride(params: Protocol.Emulation.SetDefaultBackgroundColorOverrideRequest): Promise<void>;
 
+        /**
+         * Overrides the values for env(safe-area-inset-*) and env(safe-area-max-inset-*). Unset values will cause the
+         * respective variables to be undefined, even if previously overridden.
+         */
+        setSafeAreaInsetsOverride(params: Protocol.Emulation.SetSafeAreaInsetsOverrideRequest): Promise<void>;
+
         /**
          * Overrides the values of device screen dimensions (window.screen.width, window.screen.height,
          * window.innerWidth, window.innerHeight, and "device-width"/"device-height"-related CSS media

package/types/protocol-tests-proxy-api.d.ts

@@ -2015,6 +2015,12 @@ export namespace ProtocolTestsProxyApi {
          */
         setDefaultBackgroundColorOverride(params: Protocol.Emulation.SetDefaultBackgroundColorOverrideRequest): Promise<{id: number, result: void, sessionId: string}>;
 
+        /**
+         * Overrides the values for env(safe-area-inset-*) and env(safe-area-max-inset-*). Unset values will cause the
+         * respective variables to be undefined, even if previously overridden.
+         */
+        setSafeAreaInsetsOverride(params: Protocol.Emulation.SetSafeAreaInsetsOverrideRequest): Promise<{id: number, result: void, sessionId: string}>;
+
         /**
          * Overrides the values of device screen dimensions (window.screen.width, window.screen.height,
          * window.innerWidth, window.innerHeight, and "device-width"/"device-height"-related CSS media

package/types/protocol.d.ts

@@ -8395,6 +8395,41 @@ export namespace Protocol {
      */
     export namespace Emulation {
 
+        export interface SafeAreaInsets {
+            /**
+             * Overrides safe-area-inset-top.
+             */
+            top?: integer;
+            /**
+             * Overrides safe-area-max-inset-top.
+             */
+            topMax?: integer;
+            /**
+             * Overrides safe-area-inset-left.
+             */
+            left?: integer;
+            /**
+             * Overrides safe-area-max-inset-left.
+             */
+            leftMax?: integer;
+            /**
+             * Overrides safe-area-inset-bottom.
+             */
+            bottom?: integer;
+            /**
+             * Overrides safe-area-max-inset-bottom.
+             */
+            bottomMax?: integer;
+            /**
+             * Overrides safe-area-inset-right.
+             */
+            right?: integer;
+            /**
+             * Overrides safe-area-max-inset-right.
+             */
+            rightMax?: integer;
+        }
+
         export const enum ScreenOrientationType {
             PortraitPrimary = 'portraitPrimary',
             PortraitSecondary = 'portraitSecondary',
@@ -8580,6 +8615,10 @@ export namespace Protocol {
             color?: DOM.RGBA;
         }
 
+        export interface SetSafeAreaInsetsOverrideRequest {
+            insets: SafeAreaInsets;
+        }
+
         export interface SetDeviceMetricsOverrideRequest {
             /**
              * Overriding width value in pixels (minimum 0, maximum 10000000). 0 disables the override.