devtools-protocol 0.0.1591319 → 0.0.1593706

package/json/browser_protocol.json

@@ -11068,6 +11068,13 @@
                                 "overlay",
                                 "default"
                             ]
+                        },
+                        {
+                            "name": "screenOrientationLockEmulation",
+                            "description": "If set to true, enables screen orientation lock emulation, which\nintercepts screen.orientation.lock() calls from the page and reports\norientation changes via screenOrientationLockChanged events. This is\nuseful for emulating mobile device orientation lock behavior in\nresponsive design mode.",
+                            "experimental": true,
+                            "optional": true,
+                            "type": "boolean"
                         }
                     ]
                 },
@@ -11681,6 +11688,84 @@
                         }
                     ]
                 },
+                {
+                    "name": "updateScreen",
+                    "description": "Updates specified screen parameters. Only supported in headless mode.",
+                    "experimental": true,
+                    "parameters": [
+                        {
+                            "name": "screenId",
+                            "description": "Target screen identifier.",
+                            "$ref": "ScreenId"
+                        },
+                        {
+                            "name": "left",
+                            "description": "Offset of the left edge of the screen in pixels.",
+                            "optional": true,
+                            "type": "integer"
+                        },
+                        {
+                            "name": "top",
+                            "description": "Offset of the top edge of the screen in pixels.",
+                            "optional": true,
+                            "type": "integer"
+                        },
+                        {
+                            "name": "width",
+                            "description": "The width of the screen in pixels.",
+                            "optional": true,
+                            "type": "integer"
+                        },
+                        {
+                            "name": "height",
+                            "description": "The height of the screen in pixels.",
+                            "optional": true,
+                            "type": "integer"
+                        },
+                        {
+                            "name": "workAreaInsets",
+                            "description": "Specifies the screen's work area.",
+                            "optional": true,
+                            "$ref": "WorkAreaInsets"
+                        },
+                        {
+                            "name": "devicePixelRatio",
+                            "description": "Specifies the screen's device pixel ratio.",
+                            "optional": true,
+                            "type": "number"
+                        },
+                        {
+                            "name": "rotation",
+                            "description": "Specifies the screen's rotation angle. Available values are 0, 90, 180 and 270.",
+                            "optional": true,
+                            "type": "integer"
+                        },
+                        {
+                            "name": "colorDepth",
+                            "description": "Specifies the screen's color depth in bits.",
+                            "optional": true,
+                            "type": "integer"
+                        },
+                        {
+                            "name": "label",
+                            "description": "Specifies the descriptive label for the screen.",
+                            "optional": true,
+                            "type": "string"
+                        },
+                        {
+                            "name": "isInternal",
+                            "description": "Indicates whether the screen is internal to the device or external, attached to the device. Default is false.",
+                            "optional": true,
+                            "type": "boolean"
+                        }
+                    ],
+                    "returns": [
+                        {
+                            "name": "screenInfo",
+                            "$ref": "ScreenInfo"
+                        }
+                    ]
+                },
                 {
                     "name": "removeScreen",
                     "description": "Remove screen from the device. Only supported in headless mode.",
@@ -11709,6 +11794,24 @@
                     "name": "virtualTimeBudgetExpired",
                     "description": "Notification sent after the virtual time budget for the current VirtualTimePolicy has run out.",
                     "experimental": true
+                },
+                {
+                    "name": "screenOrientationLockChanged",
+                    "description": "Fired when a page calls screen.orientation.lock() or screen.orientation.unlock()\nwhile device emulation is enabled. This allows the DevTools frontend to update the\nemulated device orientation accordingly.",
+                    "experimental": true,
+                    "parameters": [
+                        {
+                            "name": "locked",
+                            "description": "Whether the screen orientation is currently locked.",
+                            "type": "boolean"
+                        },
+                        {
+                            "name": "orientation",
+                            "description": "The orientation lock type requested by the page. Only set when locked is true.",
+                            "optional": true,
+                            "$ref": "ScreenOrientation"
+                        }
+                    ]
                 }
             ]
         },
@@ -15514,7 +15617,7 @@
                 },
                 {
                     "id": "RenderBlockingBehavior",
-                    "description": "The render blocking behavior of a resource request.",
+                    "description": "The render-blocking behavior of a resource request.",
                     "experimental": true,
                     "type": "string",
                     "enum": [
@@ -19024,7 +19127,7 @@
                         },
                         {
                             "name": "renderBlockingBehavior",
-                            "description": "The render blocking behavior of the request.",
+                            "description": "The render-blocking behavior of the request.",
                             "experimental": true,
                             "optional": true,
                             "$ref": "RenderBlockingBehavior"

package/package.json

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

package/pdl/domains/Emulation.pdl

@@ -306,6 +306,12 @@ domain Emulation
         # classic (occupying space within the layout) or overlay, depending
         # on the platform. Note: if `mobile` is `true`, the default scrollbar type is `overlay`.
         default
+      # If set to true, enables screen orientation lock emulation, which
+      # intercepts screen.orientation.lock() calls from the page and reports
+      # orientation changes via screenOrientationLockChanged events. This is
+      # useful for emulating mobile device orientation lock behavior in
+      # responsive design mode.
+      experimental optional boolean screenOrientationLockEmulation
 
   # Start reporting the given posture value to the Device Posture API.
   # This override can also be set in setDeviceMetricsOverride().
@@ -530,6 +536,16 @@ domain Emulation
   # Notification sent after the virtual time budget for the current VirtualTimePolicy has run out.
   experimental event virtualTimeBudgetExpired
 
+  # Fired when a page calls screen.orientation.lock() or screen.orientation.unlock()
+  # while device emulation is enabled. This allows the DevTools frontend to update the
+  # emulated device orientation accordingly.
+  experimental event screenOrientationLockChanged
+    parameters
+      # Whether the screen orientation is currently locked.
+      boolean locked
+      # The orientation lock type requested by the page. Only set when locked is true.
+      optional ScreenOrientation orientation
+
   # Enum of image types that can be disabled.
   experimental type DisabledImageType extends string
     enum
@@ -613,6 +629,34 @@ domain Emulation
     returns
       ScreenInfo screenInfo
 
+  # Updates specified screen parameters. Only supported in headless mode.
+  experimental command updateScreen
+    parameters
+      # Target screen identifier.
+      ScreenId screenId
+      # Offset of the left edge of the screen in pixels.
+      optional integer left
+      # Offset of the top edge of the screen in pixels.
+      optional integer top
+      # The width of the screen in pixels.
+      optional integer width
+      # The height of the screen in pixels.
+      optional integer height
+      # Specifies the screen's work area.
+      optional WorkAreaInsets workAreaInsets
+      # Specifies the screen's device pixel ratio.
+      optional number devicePixelRatio
+      # Specifies the screen's rotation angle. Available values are 0, 90, 180 and 270.
+      optional integer rotation
+      # Specifies the screen's color depth in bits.
+      optional integer colorDepth
+      # Specifies the descriptive label for the screen.
+      optional string label
+      # Indicates whether the screen is internal to the device or external, attached to the device. Default is false.
+      optional boolean isInternal
+    returns
+      ScreenInfo screenInfo
+
   # Remove screen from the device. Only supported in headless mode.
   experimental command removeScreen
     parameters

package/pdl/domains/Network.pdl

@@ -166,7 +166,7 @@ domain Network
       High
       VeryHigh
 
-  # The render blocking behavior of a resource request.
+  # The render-blocking behavior of a resource request.
   experimental type RenderBlockingBehavior extends string
     enum
       Blocking
@@ -1477,7 +1477,7 @@ domain Network
       optional Page.FrameId frameId
       # Whether the request is initiated by a user gesture. Defaults to false.
       optional boolean hasUserGesture
-      # The render blocking behavior of the request.
+      # The render-blocking behavior of the request.
       experimental optional RenderBlockingBehavior renderBlockingBehavior
 
   # Fired when resource loading priority is changed

package/types/protocol-mapping.d.ts

@@ -306,6 +306,13 @@ export namespace ProtocolMapping {
          * @experimental
          */
         'Emulation.virtualTimeBudgetExpired': [];
+        /**
+         * Fired when a page calls screen.orientation.lock() or screen.orientation.unlock()
+         * while device emulation is enabled. This allows the DevTools frontend to update the
+         * emulated device orientation accordingly.
+         * @experimental
+         */
+        'Emulation.screenOrientationLockChanged': [Protocol.Emulation.ScreenOrientationLockChangedEvent];
         'FedCm.dialogShown': [Protocol.FedCm.DialogShownEvent];
         /**
          * Triggered when a dialog is closed, either by user action, JS abort,
@@ -3583,6 +3590,14 @@ export namespace ProtocolMapping {
             paramsType: [Protocol.Emulation.AddScreenRequest];
             returnType: Protocol.Emulation.AddScreenResponse;
         };
+        /**
+         * Updates specified screen parameters. Only supported in headless mode.
+         * @experimental
+         */
+        'Emulation.updateScreen': {
+            paramsType: [Protocol.Emulation.UpdateScreenRequest];
+            returnType: Protocol.Emulation.UpdateScreenResponse;
+        };
         /**
          * Remove screen from the device. Only supported in headless mode.
          * @experimental

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

@@ -2384,6 +2384,12 @@ export namespace ProtocolProxyApi {
          */
         addScreen(params: Protocol.Emulation.AddScreenRequest): Promise<Protocol.Emulation.AddScreenResponse>;
 
+        /**
+         * Updates specified screen parameters. Only supported in headless mode.
+         * @experimental
+         */
+        updateScreen(params: Protocol.Emulation.UpdateScreenRequest): Promise<Protocol.Emulation.UpdateScreenResponse>;
+
         /**
          * Remove screen from the device. Only supported in headless mode.
          * @experimental
@@ -2405,6 +2411,14 @@ export namespace ProtocolProxyApi {
          */
         on(event: 'virtualTimeBudgetExpired', listener: () => void): void;
 
+        /**
+         * Fired when a page calls screen.orientation.lock() or screen.orientation.unlock()
+         * while device emulation is enabled. This allows the DevTools frontend to update the
+         * emulated device orientation accordingly.
+         * @experimental
+         */
+        on(event: 'screenOrientationLockChanged', listener: (params: Protocol.Emulation.ScreenOrientationLockChangedEvent) => void): void;
+
     }
 
     export interface EventBreakpointsApi {

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

@@ -2522,6 +2522,12 @@ export namespace ProtocolTestsProxyApi {
          */
         addScreen(params: Protocol.Emulation.AddScreenRequest): Promise<{id: number, result: Protocol.Emulation.AddScreenResponse, sessionId: string}>;
 
+        /**
+         * Updates specified screen parameters. Only supported in headless mode.
+         * @experimental
+         */
+        updateScreen(params: Protocol.Emulation.UpdateScreenRequest): Promise<{id: number, result: Protocol.Emulation.UpdateScreenResponse, sessionId: string}>;
+
         /**
          * Remove screen from the device. Only supported in headless mode.
          * @experimental
@@ -2545,6 +2551,16 @@ export namespace ProtocolTestsProxyApi {
         offVirtualTimeBudgetExpired(listener: () => void): void;
         onceVirtualTimeBudgetExpired(eventMatcher?: () => boolean): Promise<void>;
 
+        /**
+         * Fired when a page calls screen.orientation.lock() or screen.orientation.unlock()
+         * while device emulation is enabled. This allows the DevTools frontend to update the
+         * emulated device orientation accordingly.
+         * @experimental
+         */
+        onScreenOrientationLockChanged(listener: (event: { params: Protocol.Emulation.ScreenOrientationLockChangedEvent }) => void): void;
+        offScreenOrientationLockChanged(listener: (event: { params: Protocol.Emulation.ScreenOrientationLockChangedEvent }) => void): void;
+        onceScreenOrientationLockChanged(eventMatcher?: (event: { params: Protocol.Emulation.ScreenOrientationLockChangedEvent }) => boolean): Promise<{ params: Protocol.Emulation.ScreenOrientationLockChangedEvent }>;
+
     }
 
     export interface EventBreakpointsApi {

package/types/protocol.d.ts

@@ -9522,6 +9522,15 @@ export namespace Protocol {
              * @experimental
              */
             scrollbarType?: ('overlay' | 'default');
+            /**
+             * If set to true, enables screen orientation lock emulation, which
+             * intercepts screen.orientation.lock() calls from the page and reports
+             * orientation changes via screenOrientationLockChanged events. This is
+             * useful for emulating mobile device orientation lock behavior in
+             * responsive design mode.
+             * @experimental
+             */
+            screenOrientationLockEmulation?: boolean;
         }
 
         export interface SetDevicePostureOverrideRequest {
@@ -9865,6 +9874,57 @@ export namespace Protocol {
             screenInfo: ScreenInfo;
         }
 
+        export interface UpdateScreenRequest {
+            /**
+             * Target screen identifier.
+             */
+            screenId: ScreenId;
+            /**
+             * Offset of the left edge of the screen in pixels.
+             */
+            left?: integer;
+            /**
+             * Offset of the top edge of the screen in pixels.
+             */
+            top?: integer;
+            /**
+             * The width of the screen in pixels.
+             */
+            width?: integer;
+            /**
+             * The height of the screen in pixels.
+             */
+            height?: integer;
+            /**
+             * Specifies the screen's work area.
+             */
+            workAreaInsets?: WorkAreaInsets;
+            /**
+             * Specifies the screen's device pixel ratio.
+             */
+            devicePixelRatio?: number;
+            /**
+             * Specifies the screen's rotation angle. Available values are 0, 90, 180 and 270.
+             */
+            rotation?: integer;
+            /**
+             * Specifies the screen's color depth in bits.
+             */
+            colorDepth?: integer;
+            /**
+             * Specifies the descriptive label for the screen.
+             */
+            label?: string;
+            /**
+             * Indicates whether the screen is internal to the device or external, attached to the device. Default is false.
+             */
+            isInternal?: boolean;
+        }
+
+        export interface UpdateScreenResponse {
+            screenInfo: ScreenInfo;
+        }
+
         export interface RemoveScreenRequest {
             screenId: ScreenId;
         }
@@ -9872,6 +9932,23 @@ export namespace Protocol {
         export interface SetPrimaryScreenRequest {
             screenId: ScreenId;
         }
+
+        /**
+         * Fired when a page calls screen.orientation.lock() or screen.orientation.unlock()
+         * while device emulation is enabled. This allows the DevTools frontend to update the
+         * emulated device orientation accordingly.
+         * @experimental
+         */
+        export interface ScreenOrientationLockChangedEvent {
+            /**
+             * Whether the screen orientation is currently locked.
+             */
+            locked: boolean;
+            /**
+             * The orientation lock type requested by the page. Only set when locked is true.
+             */
+            orientation?: ScreenOrientation;
+        }
     }
 
     /**
@@ -12424,7 +12501,7 @@ export namespace Protocol {
         export type ResourcePriority = ('VeryLow' | 'Low' | 'Medium' | 'High' | 'VeryHigh');
 
         /**
-         * The render blocking behavior of a resource request.
+         * The render-blocking behavior of a resource request.
          * @experimental
          */
         export type RenderBlockingBehavior = ('Blocking' | 'InBodyParserBlocking' | 'NonBlocking' | 'NonBlockingDynamic' | 'PotentiallyBlocking');
@@ -14822,7 +14899,7 @@ export namespace Protocol {
              */
             hasUserGesture?: boolean;
             /**
-             * The render blocking behavior of the request.
+             * The render-blocking behavior of the request.
              * @experimental
              */
             renderBlockingBehavior?: RenderBlockingBehavior;