devtools-protocol 0.0.1589152 → 0.0.1591319

package/json/browser_protocol.json

@@ -1004,7 +1004,8 @@
             "description": "Audits domain allows investigation of page violations and possible improvements.",
             "experimental": true,
             "dependencies": [
-                "Network"
+                "Network",
+                "Runtime"
             ],
             "types": [
                 {
@@ -2261,6 +2262,72 @@
                         }
                     ]
                 },
+                {
+                    "id": "AdScriptIdentifier",
+                    "description": "Metadata about the ad script that was on the stack that caused the current\nscript in the `AdAncestry` to be considered ad related.",
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "scriptId",
+                            "description": "The script's v8 identifier.",
+                            "$ref": "Runtime.ScriptId"
+                        },
+                        {
+                            "name": "debuggerId",
+                            "description": "v8's debugging id for the v8::Context.",
+                            "$ref": "Runtime.UniqueDebuggerId"
+                        },
+                        {
+                            "name": "name",
+                            "description": "The script's url (or generated name based on id if inline script).",
+                            "type": "string"
+                        }
+                    ]
+                },
+                {
+                    "id": "AdAncestry",
+                    "description": "Providence about how an ad script was determined to be such. It is an ad\nbecause its url matched a filterlist rule, or because some other ad script\nwas on the stack when this script was loaded.",
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "adAncestryChain",
+                            "description": "The ad-script in the stack when the offending script was loaded. This is\nrecursive down to the root script that was tagged due to the filterlist\nrule.",
+                            "type": "array",
+                            "items": {
+                                "$ref": "AdScriptIdentifier"
+                            }
+                        },
+                        {
+                            "name": "rootScriptFilterlistRule",
+                            "description": "The filterlist rule that caused the root (last) script in\n`adAncestry` to be ad-tagged.",
+                            "optional": true,
+                            "type": "string"
+                        }
+                    ]
+                },
+                {
+                    "id": "SelectivePermissionsInterventionIssueDetails",
+                    "description": "The issue warns about blocked calls to privacy sensitive APIs via the\nSelective Permissions Intervention.",
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "apiName",
+                            "description": "Which API was intervened on.",
+                            "type": "string"
+                        },
+                        {
+                            "name": "adAncestry",
+                            "description": "Why the ad script using the API is considered an ad.",
+                            "$ref": "AdAncestry"
+                        },
+                        {
+                            "name": "stackTrace",
+                            "description": "The stack trace at the time of the intervention.",
+                            "optional": true,
+                            "$ref": "Runtime.StackTrace"
+                        }
+                    ]
+                },
                 {
                     "id": "InspectorIssueCode",
                     "description": "A unique identifier for the type of issue. Each type may use one of the\noptional fields in InspectorIssueDetails to convey more specific\ninformation about the kind of issue.",
@@ -2294,7 +2361,8 @@
                         "ConnectionAllowlistIssue",
                         "UserReidentificationIssue",
                         "PermissionElementIssue",
-                        "PerformanceIssue"
+                        "PerformanceIssue",
+                        "SelectivePermissionsInterventionIssue"
                     ]
                 },
                 {
@@ -2447,6 +2515,11 @@
                             "name": "performanceIssueDetails",
                             "optional": true,
                             "$ref": "PerformanceIssueDetails"
+                        },
+                        {
+                            "name": "selectivePermissionsInterventionIssueDetails",
+                            "optional": true,
+                            "$ref": "SelectivePermissionsInterventionIssueDetails"
                         }
                     ]
                 },
@@ -10984,6 +11057,17 @@
                             "deprecated": true,
                             "optional": true,
                             "$ref": "DevicePosture"
+                        },
+                        {
+                            "name": "scrollbarType",
+                            "description": "Scrollbar type. Default: `default`.",
+                            "experimental": true,
+                            "optional": true,
+                            "type": "string",
+                            "enum": [
+                                "overlay",
+                                "default"
+                            ]
                         }
                     ]
                 },
@@ -11607,6 +11691,17 @@
                             "$ref": "ScreenId"
                         }
                     ]
+                },
+                {
+                    "name": "setPrimaryScreen",
+                    "description": "Set primary screen. Only supported in headless mode.\nNote that this changes the coordinate system origin to the top-left\nof the new primary screen, updating the bounds and work areas\nof all existing screens accordingly.",
+                    "experimental": true,
+                    "parameters": [
+                        {
+                            "name": "screenId",
+                            "$ref": "ScreenId"
+                        }
+                    ]
                 }
             ],
             "events": [
@@ -11665,6 +11760,38 @@
                         "sync",
                         "managed"
                     ]
+                },
+                {
+                    "id": "ExtensionInfo",
+                    "description": "Detailed information about an extension.",
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "id",
+                            "description": "Extension id.",
+                            "type": "string"
+                        },
+                        {
+                            "name": "name",
+                            "description": "Extension name.",
+                            "type": "string"
+                        },
+                        {
+                            "name": "version",
+                            "description": "Extension version.",
+                            "type": "string"
+                        },
+                        {
+                            "name": "path",
+                            "description": "The path from which the extension was loaded.",
+                            "type": "string"
+                        },
+                        {
+                            "name": "enabled",
+                            "description": "Extension enabled status.",
+                            "type": "boolean"
+                        }
+                    ]
                 }
             ],
             "commands": [
@@ -11708,6 +11835,19 @@
                         }
                     ]
                 },
+                {
+                    "name": "getExtensions",
+                    "description": "Gets a list of all unpacked extensions.\nAvailable if the client is connected using the --remote-debugging-pipe flag\nand the --enable-unsafe-extension-debugging flag is set.",
+                    "returns": [
+                        {
+                            "name": "extensions",
+                            "type": "array",
+                            "items": {
+                                "$ref": "ExtensionInfo"
+                            }
+                        }
+                    ]
+                },
                 {
                     "name": "uninstall",
                     "description": "Uninstalls an unpacked extension (others not supported) from the profile.\nAvailable if the client is connected using the --remote-debugging-pipe flag\nand the --enable-unsafe-extension-debugging.",

package/package.json

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

package/pdl/domains/Audits.pdl

@@ -7,6 +7,7 @@
 # Audits domain allows investigation of page violations and possible improvements.
 experimental domain Audits
   depends on Network
+  depends on Runtime
 
   # Information about a cookie that is affected by an inspector issue.
   type AffectedCookie extends object
@@ -696,6 +697,41 @@ experimental domain Audits
       # Used for messages about activation disabled reason
       optional string disableReason
 
+  # Metadata about the ad script that was on the stack that caused the current
+  # script in the `AdAncestry` to be considered ad related.
+  type AdScriptIdentifier extends object
+    properties
+      # The script's v8 identifier.
+      Runtime.ScriptId scriptId
+      # v8's debugging id for the v8::Context.
+      Runtime.UniqueDebuggerId debuggerId
+      # The script's url (or generated name based on id if inline script).
+      string name
+
+  # Providence about how an ad script was determined to be such. It is an ad
+  # because its url matched a filterlist rule, or because some other ad script
+  # was on the stack when this script was loaded.
+  type AdAncestry extends object
+    properties
+      # The ad-script in the stack when the offending script was loaded. This is
+      # recursive down to the root script that was tagged due to the filterlist
+      # rule.
+      array of AdScriptIdentifier adAncestryChain
+      # The filterlist rule that caused the root (last) script in
+      # `adAncestry` to be ad-tagged.
+      optional string rootScriptFilterlistRule
+
+  # The issue warns about blocked calls to privacy sensitive APIs via the
+  # Selective Permissions Intervention.
+  type SelectivePermissionsInterventionIssueDetails extends object
+    properties
+      # Which API was intervened on.
+      string apiName
+      # Why the ad script using the API is considered an ad.
+      AdAncestry adAncestry
+      # The stack trace at the time of the intervention.
+      optional Runtime.StackTrace stackTrace
+
   # A unique identifier for the type of issue. Each type may use one of the
   # optional fields in InspectorIssueDetails to convey more specific
   # information about the kind of issue.
@@ -731,6 +767,7 @@ experimental domain Audits
       UserReidentificationIssue
       PermissionElementIssue
       PerformanceIssue
+      SelectivePermissionsInterventionIssue
 
   # This struct holds a list of optional fields with additional information
   # specific to the kind of issue. When adding a new issue code, please also
@@ -766,6 +803,7 @@ experimental domain Audits
       optional UserReidentificationIssueDetails userReidentificationIssueDetails
       optional PermissionElementIssueDetails permissionElementIssueDetails
       optional PerformanceIssueDetails performanceIssueDetails
+      optional SelectivePermissionsInterventionIssueDetails selectivePermissionsInterventionIssueDetails
 
   # A unique id for a DevTools inspector issue. Allows other entities (e.g.
   # exceptions, CDP message, console messages, etc.) to reference an issue.

package/pdl/domains/Emulation.pdl

@@ -297,6 +297,15 @@ domain Emulation
       # to continuous.
       # Deprecated, use Emulation.setDevicePostureOverride.
       experimental deprecated optional DevicePosture devicePosture
+      # Scrollbar type. Default: `default`.
+      experimental optional enum scrollbarType
+        # Emulates scrollbars that float over the content, typically appearing
+        # only when scrolling.
+        overlay
+        # Restores the platform's default scrollbar behavior, which might be
+        # classic (occupying space within the layout) or overlay, depending
+        # on the platform. Note: if `mobile` is `true`, the default scrollbar type is `overlay`.
+        default
 
   # Start reporting the given posture value to the Device Posture API.
   # This override can also be set in setDeviceMetricsOverride().
@@ -608,3 +617,11 @@ domain Emulation
   experimental command removeScreen
     parameters
       ScreenId screenId
+
+  # Set primary screen. Only supported in headless mode.
+  # Note that this changes the coordinate system origin to the top-left
+  # of the new primary screen, updating the bounds and work areas
+  # of all existing screens accordingly.
+  experimental command setPrimaryScreen
+    parameters
+      ScreenId screenId

package/pdl/domains/Extensions.pdl

@@ -38,6 +38,28 @@ experimental domain Extensions
     returns
       # Extension id.
       string id
+
+  # Detailed information about an extension.
+  type ExtensionInfo extends object
+    properties
+      # Extension id.
+      string id
+      # Extension name.
+      string name
+      # Extension version.
+      string version
+      # The path from which the extension was loaded.
+      string path
+      # Extension enabled status.
+      boolean enabled
+
+  # Gets a list of all unpacked extensions.
+  # Available if the client is connected using the --remote-debugging-pipe flag
+  # and the --enable-unsafe-extension-debugging flag is set.
+  command getExtensions
+    returns
+      array of ExtensionInfo extensions
+
   # Uninstalls an unpacked extension (others not supported) from the profile.
   # Available if the client is connected using the --remote-debugging-pipe flag
   # and the --enable-unsafe-extension-debugging.

package/types/protocol-mapping.d.ts

@@ -3591,6 +3591,17 @@ export namespace ProtocolMapping {
             paramsType: [Protocol.Emulation.RemoveScreenRequest];
             returnType: void;
         };
+        /**
+         * Set primary screen. Only supported in headless mode.
+         * Note that this changes the coordinate system origin to the top-left
+         * of the new primary screen, updating the bounds and work areas
+         * of all existing screens accordingly.
+         * @experimental
+         */
+        'Emulation.setPrimaryScreen': {
+            paramsType: [Protocol.Emulation.SetPrimaryScreenRequest];
+            returnType: void;
+        };
         /**
          * Sets breakpoint on particular native event.
          */
@@ -3632,6 +3643,15 @@ export namespace ProtocolMapping {
             paramsType: [Protocol.Extensions.LoadUnpackedRequest];
             returnType: Protocol.Extensions.LoadUnpackedResponse;
         };
+        /**
+         * Gets a list of all unpacked extensions.
+         * Available if the client is connected using the --remote-debugging-pipe flag
+         * and the --enable-unsafe-extension-debugging flag is set.
+         */
+        'Extensions.getExtensions': {
+            paramsType: [];
+            returnType: Protocol.Extensions.GetExtensionsResponse;
+        };
         /**
          * Uninstalls an unpacked extension (others not supported) from the profile.
          * Available if the client is connected using the --remote-debugging-pipe flag

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

@@ -2390,6 +2390,15 @@ export namespace ProtocolProxyApi {
          */
         removeScreen(params: Protocol.Emulation.RemoveScreenRequest): Promise<void>;
 
+        /**
+         * Set primary screen. Only supported in headless mode.
+         * Note that this changes the coordinate system origin to the top-left
+         * of the new primary screen, updating the bounds and work areas
+         * of all existing screens accordingly.
+         * @experimental
+         */
+        setPrimaryScreen(params: Protocol.Emulation.SetPrimaryScreenRequest): Promise<void>;
+
         /**
          * Notification sent after the virtual time budget for the current VirtualTimePolicy has run out.
          * @experimental
@@ -2433,6 +2442,13 @@ export namespace ProtocolProxyApi {
          */
         loadUnpacked(params: Protocol.Extensions.LoadUnpackedRequest): Promise<Protocol.Extensions.LoadUnpackedResponse>;
 
+        /**
+         * Gets a list of all unpacked extensions.
+         * Available if the client is connected using the --remote-debugging-pipe flag
+         * and the --enable-unsafe-extension-debugging flag is set.
+         */
+        getExtensions(): Promise<Protocol.Extensions.GetExtensionsResponse>;
+
         /**
          * Uninstalls an unpacked extension (others not supported) from the profile.
          * Available if the client is connected using the --remote-debugging-pipe flag

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

@@ -2528,6 +2528,15 @@ export namespace ProtocolTestsProxyApi {
          */
         removeScreen(params: Protocol.Emulation.RemoveScreenRequest): Promise<{id: number, result: void, sessionId: string}>;
 
+        /**
+         * Set primary screen. Only supported in headless mode.
+         * Note that this changes the coordinate system origin to the top-left
+         * of the new primary screen, updating the bounds and work areas
+         * of all existing screens accordingly.
+         * @experimental
+         */
+        setPrimaryScreen(params: Protocol.Emulation.SetPrimaryScreenRequest): Promise<{id: number, result: void, sessionId: string}>;
+
         /**
          * Notification sent after the virtual time budget for the current VirtualTimePolicy has run out.
          * @experimental
@@ -2573,6 +2582,13 @@ export namespace ProtocolTestsProxyApi {
          */
         loadUnpacked(params: Protocol.Extensions.LoadUnpackedRequest): Promise<{id: number, result: Protocol.Extensions.LoadUnpackedResponse, sessionId: string}>;
 
+        /**
+         * Gets a list of all unpacked extensions.
+         * Available if the client is connected using the --remote-debugging-pipe flag
+         * and the --enable-unsafe-extension-debugging flag is set.
+         */
+        getExtensions(): Promise<{id: number, result: Protocol.Extensions.GetExtensionsResponse, sessionId: string}>;
+
         /**
          * Uninstalls an unpacked extension (others not supported) from the profile.
          * Available if the client is connected using the --remote-debugging-pipe flag

package/types/protocol.d.ts

@@ -3936,12 +3936,69 @@ export namespace Protocol {
             disableReason?: string;
         }
 
+        /**
+         * Metadata about the ad script that was on the stack that caused the current
+         * script in the `AdAncestry` to be considered ad related.
+         */
+        export interface AdScriptIdentifier {
+            /**
+             * The script's v8 identifier.
+             */
+            scriptId: Runtime.ScriptId;
+            /**
+             * v8's debugging id for the v8::Context.
+             */
+            debuggerId: Runtime.UniqueDebuggerId;
+            /**
+             * The script's url (or generated name based on id if inline script).
+             */
+            name: string;
+        }
+
+        /**
+         * Providence about how an ad script was determined to be such. It is an ad
+         * because its url matched a filterlist rule, or because some other ad script
+         * was on the stack when this script was loaded.
+         */
+        export interface AdAncestry {
+            /**
+             * The ad-script in the stack when the offending script was loaded. This is
+             * recursive down to the root script that was tagged due to the filterlist
+             * rule.
+             */
+            adAncestryChain: AdScriptIdentifier[];
+            /**
+             * The filterlist rule that caused the root (last) script in
+             * `adAncestry` to be ad-tagged.
+             */
+            rootScriptFilterlistRule?: string;
+        }
+
+        /**
+         * The issue warns about blocked calls to privacy sensitive APIs via the
+         * Selective Permissions Intervention.
+         */
+        export interface SelectivePermissionsInterventionIssueDetails {
+            /**
+             * Which API was intervened on.
+             */
+            apiName: string;
+            /**
+             * Why the ad script using the API is considered an ad.
+             */
+            adAncestry: AdAncestry;
+            /**
+             * The stack trace at the time of the intervention.
+             */
+            stackTrace?: Runtime.StackTrace;
+        }
+
         /**
          * A unique identifier for the type of issue. Each type may use one of the
          * optional fields in InspectorIssueDetails to convey more specific
          * information about the kind of issue.
          */
-        export type InspectorIssueCode = ('CookieIssue' | 'MixedContentIssue' | 'BlockedByResponseIssue' | 'HeavyAdIssue' | 'ContentSecurityPolicyIssue' | 'SharedArrayBufferIssue' | 'LowTextContrastIssue' | 'CorsIssue' | 'AttributionReportingIssue' | 'QuirksModeIssue' | 'PartitioningBlobURLIssue' | 'NavigatorUserAgentIssue' | 'GenericIssue' | 'DeprecationIssue' | 'ClientHintIssue' | 'FederatedAuthRequestIssue' | 'BounceTrackingIssue' | 'CookieDeprecationMetadataIssue' | 'StylesheetLoadingIssue' | 'FederatedAuthUserInfoRequestIssue' | 'PropertyRuleIssue' | 'SharedDictionaryIssue' | 'ElementAccessibilityIssue' | 'SRIMessageSignatureIssue' | 'UnencodedDigestIssue' | 'ConnectionAllowlistIssue' | 'UserReidentificationIssue' | 'PermissionElementIssue' | 'PerformanceIssue');
+        export type InspectorIssueCode = ('CookieIssue' | 'MixedContentIssue' | 'BlockedByResponseIssue' | 'HeavyAdIssue' | 'ContentSecurityPolicyIssue' | 'SharedArrayBufferIssue' | 'LowTextContrastIssue' | 'CorsIssue' | 'AttributionReportingIssue' | 'QuirksModeIssue' | 'PartitioningBlobURLIssue' | 'NavigatorUserAgentIssue' | 'GenericIssue' | 'DeprecationIssue' | 'ClientHintIssue' | 'FederatedAuthRequestIssue' | 'BounceTrackingIssue' | 'CookieDeprecationMetadataIssue' | 'StylesheetLoadingIssue' | 'FederatedAuthUserInfoRequestIssue' | 'PropertyRuleIssue' | 'SharedDictionaryIssue' | 'ElementAccessibilityIssue' | 'SRIMessageSignatureIssue' | 'UnencodedDigestIssue' | 'ConnectionAllowlistIssue' | 'UserReidentificationIssue' | 'PermissionElementIssue' | 'PerformanceIssue' | 'SelectivePermissionsInterventionIssue');
 
         /**
          * This struct holds a list of optional fields with additional information
@@ -3981,6 +4038,7 @@ export namespace Protocol {
             userReidentificationIssueDetails?: UserReidentificationIssueDetails;
             permissionElementIssueDetails?: PermissionElementIssueDetails;
             performanceIssueDetails?: PerformanceIssueDetails;
+            selectivePermissionsInterventionIssueDetails?: SelectivePermissionsInterventionIssueDetails;
         }
 
         /**
@@ -9380,6 +9438,11 @@ export namespace Protocol {
             insets: SafeAreaInsets;
         }
 
+        export const enum SetDeviceMetricsOverrideRequestScrollbarType {
+            Overlay = 'overlay',
+            Default = 'default',
+        }
+
         export interface SetDeviceMetricsOverrideRequest {
             /**
              * Overriding width value in pixels (minimum 0, maximum 10000000). 0 disables the override.
@@ -9454,6 +9517,11 @@ export namespace Protocol {
              * @experimental
              */
             devicePosture?: DevicePosture;
+            /**
+             * Scrollbar type. Default: `default`.
+             * @experimental
+             */
+            scrollbarType?: ('overlay' | 'default');
         }
 
         export interface SetDevicePostureOverrideRequest {
@@ -9800,6 +9868,10 @@ export namespace Protocol {
         export interface RemoveScreenRequest {
             screenId: ScreenId;
         }
+
+        export interface SetPrimaryScreenRequest {
+            screenId: ScreenId;
+        }
     }
 
     /**
@@ -9836,6 +9908,32 @@ export namespace Protocol {
          */
         export type StorageArea = ('session' | 'local' | 'sync' | 'managed');
 
+        /**
+         * Detailed information about an extension.
+         */
+        export interface ExtensionInfo {
+            /**
+             * Extension id.
+             */
+            id: string;
+            /**
+             * Extension name.
+             */
+            name: string;
+            /**
+             * Extension version.
+             */
+            version: string;
+            /**
+             * The path from which the extension was loaded.
+             */
+            path: string;
+            /**
+             * Extension enabled status.
+             */
+            enabled: boolean;
+        }
+
         export interface TriggerActionRequest {
             /**
              * Extension id.
@@ -9865,6 +9963,10 @@ export namespace Protocol {
             id: string;
         }
 
+        export interface GetExtensionsResponse {
+            extensions: ExtensionInfo[];
+        }
+
         export interface UninstallRequest {
             /**
              * Extension id.