devtools-protocol 0.0.1651496 → 0.0.1652909

package/json/browser_protocol.json

@@ -608,6 +608,34 @@
                 "Runtime"
             ],
             "types": [
+                {
+                    "id": "AdFrameData",
+                    "description": "Ad frame data.",
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "frameId",
+                            "description": "The DevTools frame token.",
+                            "$ref": "Page.FrameId"
+                        },
+                        {
+                            "name": "initialOrigin",
+                            "description": "The initial origin of the frame. To minimize the payload size, this is\nonly sent once per frame.",
+                            "optional": true,
+                            "type": "string"
+                        },
+                        {
+                            "name": "networkBytes",
+                            "description": "The network bytes of the frame.",
+                            "type": "number"
+                        },
+                        {
+                            "name": "cpuTime",
+                            "description": "The CPU time of the frame, in milliseconds.",
+                            "type": "number"
+                        }
+                    ]
+                },
                 {
                     "id": "AdMetrics",
                     "description": "Ad metrics for a page.",
@@ -642,6 +670,22 @@
                             "name": "totalAdNetworkBytes",
                             "description": "The total ad network bytes.",
                             "type": "number"
+                        },
+                        {
+                            "name": "updateAdFrames",
+                            "description": "The list of ad frames that have been updated since the last event.",
+                            "type": "array",
+                            "items": {
+                                "$ref": "AdFrameData"
+                            }
+                        },
+                        {
+                            "name": "removeAdFrames",
+                            "description": "The list of ad frame IDs that have been removed since the last event.",
+                            "type": "array",
+                            "items": {
+                                "$ref": "Page.FrameId"
+                            }
                         }
                     ]
                 }
@@ -7279,8 +7323,10 @@
                         "file-selector-button",
                         "details-content",
                         "picker",
+                        "select-listbox",
                         "permission-icon",
                         "overscroll-area-parent",
+                        "overscroll-backdrop",
                         "skeleton"
                     ]
                 },
@@ -23644,6 +23690,12 @@
                             "description": "Whether or not universal access should be granted to the isolated world. This is a powerful\noption, use with caution.",
                             "optional": true,
                             "type": "boolean"
+                        },
+                        {
+                            "name": "contentSecurityPolicy",
+                            "description": "An optional content security policy to set for the isolated world.\nIf omitted, any existing CSP for the world will be cleared.\nNote that clearing or updating the CSP does not immediately affect the active\ncontext in the same document because LocalDOMWindow caches the\nContentSecurityPolicy object. The change takes effect on subsequent\nnavigations when a new window context is created.",
+                            "optional": true,
+                            "type": "string"
                         }
                     ],
                     "returns": [
@@ -29302,7 +29354,7 @@
                         },
                         {
                             "name": "focus",
-                            "description": "If specified, the option is used to determine if the new target should\nbe focused or not. By default, the focus behavior depends on the\nvalue of the background field. For example, background=false and focus=false\nwill result in the target tab being opened but the browser window remain\nunchanged (if it was in the background, it will remain in the background)\nand background=false with focus=undefined will result in the window being focused.\nUsing background: true and focus: true is not supported and will result in an error.",
+                            "description": "If specified, determines whether the new target should be focused.\nBy default, the focus behavior depends on the `background` parameter:\n- If `background` is false (default) and `focus` is omitted, the new target is focused and the browser window is brought to the foreground.\n- If `background` is false and `focus` is false, the target is opened but the browser window's focus remains unchanged (e.g., if the window was in the background, it stays there).\n- If `background` is true, setting `focus` to true is not supported and will result in an error.",
                             "experimental": true,
                             "optional": true,
                             "type": "boolean"
@@ -29983,6 +30035,20 @@
                             "experimental": true,
                             "optional": true,
                             "$ref": "TracingBackend"
+                        },
+                        {
+                            "name": "screenshotMaxSize",
+                            "description": "Maximum width and height (in pixels) of each captured screenshot.\nOnly used when the `disabled-by-default-devtools.screenshot` category is\nenabled. Defaults to 500. The combined memory footprint of screenshots\n(`screenshotMaxSize` * `screenshotMaxSize` * 4 * `screenshotMaxCount`)\nis clamped to the existing per-session budget.",
+                            "experimental": true,
+                            "optional": true,
+                            "type": "integer"
+                        },
+                        {
+                            "name": "screenshotMaxCount",
+                            "description": "Maximum number of screenshots captured during a single tracing session.\nOnly used when the `disabled-by-default-devtools.screenshot` category is\nenabled. Defaults to 450. Clamped together with `screenshotMaxSize` to\nstay within the per-session screenshot memory budget.",
+                            "experimental": true,
+                            "optional": true,
+                            "type": "integer"
                         }
                     ]
                 }

package/package.json

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

package/pdl/domains/Ads.pdl

@@ -8,6 +8,19 @@ experimental domain Ads
   depends on Page
   depends on Runtime
 
+  # Ad frame data.
+  type AdFrameData extends object
+    properties
+      # The DevTools frame token.
+      Page.FrameId frameId
+      # The initial origin of the frame. To minimize the payload size, this is
+      # only sent once per frame.
+      optional string initialOrigin
+      # The network bytes of the frame.
+      number networkBytes
+      # The CPU time of the frame, in milliseconds.
+      number cpuTime
+
   # Ad metrics for a page.
   type AdMetrics extends object
     properties
@@ -26,6 +39,10 @@ experimental domain Ads
       number totalAdCpuTime
       # The total ad network bytes.
       number totalAdNetworkBytes
+      # The list of ad frames that have been updated since the last event.
+      array of AdFrameData updateAdFrames
+      # The list of ad frame IDs that have been removed since the last event.
+      array of Page.FrameId removeAdFrames
 
   # Retrieves ad metrics for the current page.
   command getAdMetrics

package/pdl/domains/DOM.pdl

@@ -76,8 +76,10 @@ domain DOM
       file-selector-button
       details-content
       picker
+      select-listbox
       permission-icon
       overscroll-area-parent
+      overscroll-backdrop
       skeleton
 
   # Shadow root type.

package/pdl/domains/Page.pdl

@@ -640,6 +640,13 @@ domain Page
       # Whether or not universal access should be granted to the isolated world. This is a powerful
       # option, use with caution.
       optional boolean grantUniveralAccess
+      # An optional content security policy to set for the isolated world.
+      # If omitted, any existing CSP for the world will be cleared.
+      # Note that clearing or updating the CSP does not immediately affect the active
+      # context in the same document because LocalDOMWindow caches the
+      # ContentSecurityPolicy object. The change takes effect on subsequent
+      # navigations when a new window context is created.
+      optional string contentSecurityPolicy
     returns
       # Execution context of the isolated world.
       Runtime.ExecutionContextId executionContextId

package/pdl/domains/Target.pdl

@@ -173,13 +173,11 @@ domain Target
       # present in the tab UI strip. Cannot be created with `forTab: true`, `newWindow: true` or
       # `background: false`. The life-time of the tab is limited to the life-time of the session.
       experimental optional boolean hidden
-      # If specified, the option is used to determine if the new target should
-      # be focused or not. By default, the focus behavior depends on the
-      # value of the background field. For example, background=false and focus=false
-      # will result in the target tab being opened but the browser window remain
-      # unchanged (if it was in the background, it will remain in the background)
-      # and background=false with focus=undefined will result in the window being focused.
-      # Using background: true and focus: true is not supported and will result in an error.
+      # If specified, determines whether the new target should be focused.
+      # By default, the focus behavior depends on the `background` parameter:
+      # - If `background` is false (default) and `focus` is omitted, the new target is focused and the browser window is brought to the foreground.
+      # - If `background` is false and `focus` is false, the target is opened but the browser window's focus remains unchanged (e.g., if the window was in the background, it stays there).
+      # - If `background` is true, setting `focus` to true is not supported and will result in an error.
       experimental optional boolean focus
     returns
       # The id of the page opened.

package/pdl/domains/Tracing.pdl

@@ -130,6 +130,17 @@ domain Tracing
       experimental optional binary perfettoConfig
       # Backend type (defaults to `auto`)
       experimental optional TracingBackend tracingBackend
+      # Maximum width and height (in pixels) of each captured screenshot.
+      # Only used when the `disabled-by-default-devtools.screenshot` category is
+      # enabled. Defaults to 500. The combined memory footprint of screenshots
+      # (`screenshotMaxSize` * `screenshotMaxSize` * 4 * `screenshotMaxCount`)
+      # is clamped to the existing per-session budget.
+      experimental optional integer screenshotMaxSize
+      # Maximum number of screenshots captured during a single tracing session.
+      # Only used when the `disabled-by-default-devtools.screenshot` category is
+      # enabled. Defaults to 450. Clamped together with `screenshotMaxSize` to
+      # stay within the per-session screenshot memory budget.
+      experimental optional integer screenshotMaxCount
 
   experimental event bufferUsage
     parameters

package/types/protocol.d.ts

@@ -3124,6 +3124,29 @@ export namespace Protocol {
      */
     export namespace Ads {
 
+        /**
+         * Ad frame data.
+         */
+        export interface AdFrameData {
+            /**
+             * The DevTools frame token.
+             */
+            frameId: Page.FrameId;
+            /**
+             * The initial origin of the frame. To minimize the payload size, this is
+             * only sent once per frame.
+             */
+            initialOrigin?: string;
+            /**
+             * The network bytes of the frame.
+             */
+            networkBytes: number;
+            /**
+             * The CPU time of the frame, in milliseconds.
+             */
+            cpuTime: number;
+        }
+
         /**
          * Ad metrics for a page.
          */
@@ -3155,6 +3178,14 @@ export namespace Protocol {
              * The total ad network bytes.
              */
             totalAdNetworkBytes: number;
+            /**
+             * The list of ad frames that have been updated since the last event.
+             */
+            updateAdFrames: AdFrameData[];
+            /**
+             * The list of ad frame IDs that have been removed since the last event.
+             */
+            removeAdFrames: Page.FrameId[];
         }
 
         export interface GetAdMetricsResponse {
@@ -7020,7 +7051,7 @@ export namespace Protocol {
         /**
          * Pseudo element type.
          */
-        export type PseudoType = ('first-line' | 'first-letter' | 'checkmark' | 'before' | 'after' | 'expand-icon' | 'picker-icon' | 'interest-button' | 'marker' | 'backdrop' | 'column' | 'selection' | 'search-text' | 'target-text' | 'spelling-error' | 'grammar-error' | 'highlight' | 'first-line-inherited' | 'scroll-marker' | 'scroll-marker-group' | 'scroll-button' | 'scrollbar' | 'scrollbar-thumb' | 'scrollbar-button' | 'scrollbar-track' | 'scrollbar-track-piece' | 'scrollbar-corner' | 'resizer' | 'input-list-button' | 'view-transition' | 'view-transition-group' | 'view-transition-image-pair' | 'view-transition-group-children' | 'view-transition-old' | 'view-transition-new' | 'placeholder' | 'file-selector-button' | 'details-content' | 'picker' | 'permission-icon' | 'overscroll-area-parent' | 'skeleton');
+        export type PseudoType = ('first-line' | 'first-letter' | 'checkmark' | 'before' | 'after' | 'expand-icon' | 'picker-icon' | 'interest-button' | 'marker' | 'backdrop' | 'column' | 'selection' | 'search-text' | 'target-text' | 'spelling-error' | 'grammar-error' | 'highlight' | 'first-line-inherited' | 'scroll-marker' | 'scroll-marker-group' | 'scroll-button' | 'scrollbar' | 'scrollbar-thumb' | 'scrollbar-button' | 'scrollbar-track' | 'scrollbar-track-piece' | 'scrollbar-corner' | 'resizer' | 'input-list-button' | 'view-transition' | 'view-transition-group' | 'view-transition-image-pair' | 'view-transition-group-children' | 'view-transition-old' | 'view-transition-new' | 'placeholder' | 'file-selector-button' | 'details-content' | 'picker' | 'select-listbox' | 'permission-icon' | 'overscroll-area-parent' | 'overscroll-backdrop' | 'skeleton');
 
         /**
          * Shadow root type.
@@ -17645,6 +17676,15 @@ export namespace Protocol {
              * option, use with caution.
              */
             grantUniveralAccess?: boolean;
+            /**
+             * An optional content security policy to set for the isolated world.
+             * If omitted, any existing CSP for the world will be cleared.
+             * Note that clearing or updating the CSP does not immediately affect the active
+             * context in the same document because LocalDOMWindow caches the
+             * ContentSecurityPolicy object. The change takes effect on subsequent
+             * navigations when a new window context is created.
+             */
+            contentSecurityPolicy?: string;
         }
 
         export interface CreateIsolatedWorldResponse {
@@ -21147,13 +21187,11 @@ export namespace Protocol {
              */
             hidden?: boolean;
             /**
-             * If specified, the option is used to determine if the new target should
-             * be focused or not. By default, the focus behavior depends on the
-             * value of the background field. For example, background=false and focus=false
-             * will result in the target tab being opened but the browser window remain
-             * unchanged (if it was in the background, it will remain in the background)
-             * and background=false with focus=undefined will result in the window being focused.
-             * Using background: true and focus: true is not supported and will result in an error.
+             * If specified, determines whether the new target should be focused.
+             * By default, the focus behavior depends on the `background` parameter:
+             * - If `background` is false (default) and `focus` is omitted, the new target is focused and the browser window is brought to the foreground.
+             * - If `background` is false and `focus` is false, the target is opened but the browser window's focus remains unchanged (e.g., if the window was in the background, it stays there).
+             * - If `background` is true, setting `focus` to true is not supported and will result in an error.
              * @experimental
              */
             focus?: boolean;
@@ -21622,6 +21660,23 @@ export namespace Protocol {
              * @experimental
              */
             tracingBackend?: TracingBackend;
+            /**
+             * Maximum width and height (in pixels) of each captured screenshot.
+             * Only used when the `disabled-by-default-devtools.screenshot` category is
+             * enabled. Defaults to 500. The combined memory footprint of screenshots
+             * (`screenshotMaxSize` * `screenshotMaxSize` * 4 * `screenshotMaxCount`)
+             * is clamped to the existing per-session budget.
+             * @experimental
+             */
+            screenshotMaxSize?: integer;
+            /**
+             * Maximum number of screenshots captured during a single tracing session.
+             * Only used when the `disabled-by-default-devtools.screenshot` category is
+             * enabled. Defaults to 450. Clamped together with `screenshotMaxSize` to
+             * stay within the per-session screenshot memory budget.
+             * @experimental
+             */
+            screenshotMaxCount?: integer;
         }
 
         /**