Roll protocol to r1301748

ChromeDevTools · May 16, 2024 · f8def09 · f8def09
1 parent e200d9e
commit f8def09
Show file tree

Hide file tree

Showing 7 changed files with 155 additions and 52 deletions.
diff --git a/changelog.md b/changelog.md
@@ -1,7 +1,95 @@
 
 
+## Roll protocol to r1301748 — _2024-05-16T04:24:35.000Z_
+######  Diff: [`e200d9e...043416a`](https://github.com/ChromeDevTools/devtools-protocol/compare/e200d9e...043416a)
+
+```diff
+@@ browser_protocol.pdl:6183 @@ domain Network
+       TopLevelStorageAccess
+       # The cookie should have been blocked by 3PCD but is exempted by CORS opt-in.
+       CorsOptIn
++      # The cookie should have been blocked by 3PCD but is exempted by the first-party URL scheme.
++      Scheme
+
+   # A cookie which was not stored from a response with the corresponding reason.
+   experimental type BlockedSetCookieWithReason extends object
+diff --git a/pdl/js_protocol.pdl b/pdl/js_protocol.pdl
+index 8dad9c9..ee14676 100644
+--- a/pdl/js_protocol.pdl
++++ b/pdl/js_protocol.pdl
+@@ -1297,6 +1297,10 @@ domain Runtime
+   # Id of an execution context.
+   type ExecutionContextId extends integer
+
++  # Id of an execution context that is unique across processes
++  # (unlike ExecutionContextId).
++  type ExecutionContextUniqueId extends string
++
+   # Description of an isolated world.
+   type ExecutionContextDescription extends object
+     properties
+@@ -1310,7 +1314,7 @@ domain Runtime
+       # A system-unique execution context identifier. Unlike the id, this is unique across
+       # multiple processes, so can be reliably used to identify specific context while backend
+       # performs a cross-process navigation.
+-      experimental string uniqueId
++      experimental ExecutionContextUniqueId uniqueId
+       # Embedder-specific auxiliary data likely matching {isDefault: boolean, type: 'default'|'isolated'|'worker', frameId: string}
+       optional object auxData
+
+@@ -1671,7 +1675,8 @@ domain Runtime
+       # If specified, the binding would only be exposed to the specified
+       # execution context. If omitted and `executionContextName` is not set,
+       # the binding is exposed to all execution contexts of the target.
+-      # This parameter is mutually exclusive with `executionContextName`.
++      # This parameter is mutually exclusive with `executionContextName`
++      # and `executionContextUniqueId`.
+       # Deprecated in favor of `executionContextName` due to an unclear use case
+       # and bugs in implementation (crbug.com/1169639). `executionContextId` will be
+       # removed in the future.
+@@ -1680,8 +1685,12 @@ domain Runtime
+       # matching name, even for contexts created after the binding is added.
+       # See also `ExecutionContext.name` and `worldName` parameter to
+       # `Page.addScriptToEvaluateOnNewDocument`.
+-      # This parameter is mutually exclusive with `executionContextId`.
++      # This parameter is mutually exclusive with `executionContextId`
++      # and `executionContextUniqueId`.
+       optional string executionContextName
++      # This parameter is mutually exclusive with `executionContextId`
++      # and `executionContextName`.
++      experimental optional ExecutionContextUniqueId executionContextUniqueId
+
+   # This method does not remove binding function from global object but
+   # unsubscribes current runtime agent from Runtime.bindingCalled notifications.
+@@ -1708,6 +1717,7 @@ domain Runtime
+       string payload
+       # Identifier of the context where the call was made.
+       ExecutionContextId executionContextId
++      experimental ExecutionContextUniqueId executionContextUniqueId
+
+   # Issued when console API was called.
+   event consoleAPICalled
+@@ -1736,6 +1746,7 @@ domain Runtime
+       array of RemoteObject args
+       # Identifier of the context where the call was made.
+       ExecutionContextId executionContextId
++      experimental ExecutionContextUniqueId executionContextUniqueId
+       # Call timestamp.
+       Timestamp timestamp
+       # Stack trace captured when the call was made. The async stack chain is automatically reported for
+@@ -1774,7 +1785,7 @@ domain Runtime
+       # Id of the destroyed context
+       deprecated ExecutionContextId executionContextId
+       # Unique Id of the destroyed context
+-      experimental string executionContextUniqueId
++      experimental ExecutionContextUniqueId executionContextUniqueId
+
+   # Issued when all executionContexts were cleared in browser
+   event executionContextsCleared
+```
+
 ## Roll protocol to r1301093 — _2024-05-15T04:27:06.000Z_
-######  Diff: [`2ac7f42...e8bd56f`](https://github.com/ChromeDevTools/devtools-protocol/compare/2ac7f42...e8bd56f)
+######  Diff: [`2ac7f42...e200d9e`](https://github.com/ChromeDevTools/devtools-protocol/compare/2ac7f42...e200d9e)
 
 ```diff
 @@ browser_protocol.pdl:2633 @@ domain DOM
@@ -11788,40 +11876,4 @@ index 09c420e..bd277eb 100644
        experimental optional array of string commands
 
    # This method emulates inserting text that doesn't come from a key press,
-```
-
-## Roll protocol to r961891 — _2022-01-21T14:15:27.000Z_
-######  Diff: [`dac32a8...0abe20f`](https://github.com/ChromeDevTools/devtools-protocol/compare/dac32a8...0abe20f)
-
-```diff
-@@ browser_protocol.pdl:736 @@ experimental domain Audits
-       string url
-       optional SourceCodeLocation location
-
--  type WasmCrossOriginModuleSharingIssueDetails extends object
--    properties
--      string wasmModuleUrl
--      string sourceOrigin
--      string targetOrigin
--      boolean isWarning
--
-   type GenericIssueErrorType extends string
-     enum
-       CrossOriginPortalPostMessageError
-@@ -804,7 +797,6 @@ experimental domain Audits
-       AttributionReportingIssue
-       QuirksModeIssue
-       NavigatorUserAgentIssue
--      WasmCrossOriginModuleSharingIssue
-       GenericIssue
-       DeprecationIssue
-       ClientHintIssue
-@@ -826,7 +818,6 @@ experimental domain Audits
-       optional AttributionReportingIssueDetails attributionReportingIssueDetails
-       optional QuirksModeIssueDetails quirksModeIssueDetails
-       optional NavigatorUserAgentIssueDetails navigatorUserAgentIssueDetails
--      optional WasmCrossOriginModuleSharingIssueDetails wasmCrossOriginModuleSharingIssue
-       optional GenericIssueDetails genericIssueDetails
-       optional DeprecationIssueDetails deprecationIssueDetails
-       optional ClientHintIssueDetails clientHintIssueDetails
 ```
diff --git a/json/browser_protocol.json b/json/browser_protocol.json
@@ -13070,7 +13070,8 @@
                         "EnterprisePolicy",
                         "StorageAccess",
                         "TopLevelStorageAccess",
-                        "CorsOptIn"
+                        "CorsOptIn",
+                        "Scheme"
                     ]
                 },
                 {

diff --git a/json/js_protocol.json b/json/js_protocol.json
@@ -2675,6 +2675,11 @@
                     "description": "Id of an execution context.",
                     "type": "integer"
                 },
+                {
+                    "id": "ExecutionContextUniqueId",
+                    "description": "Id of an execution context that is unique across processes\n(unlike ExecutionContextId).",
+                    "type": "string"
+                },
                 {
                     "id": "ExecutionContextDescription",
                     "description": "Description of an isolated world.",
@@ -2699,7 +2704,7 @@
                             "name": "uniqueId",
                             "description": "A system-unique execution context identifier. Unlike the id, this is unique across\nmultiple processes, so can be reliably used to identify specific context while backend\nperforms a cross-process navigation.",
                             "experimental": true,
-                            "type": "string"
+                            "$ref": "ExecutionContextUniqueId"
                         },
                         {
                             "name": "auxData",
@@ -3473,17 +3478,24 @@
                         },
                         {
                             "name": "executionContextId",
-                            "description": "If specified, the binding would only be exposed to the specified\nexecution context. If omitted and `executionContextName` is not set,\nthe binding is exposed to all execution contexts of the target.\nThis parameter is mutually exclusive with `executionContextName`.\nDeprecated in favor of `executionContextName` due to an unclear use case\nand bugs in implementation (crbug.com/1169639). `executionContextId` will be\nremoved in the future.",
+                            "description": "If specified, the binding would only be exposed to the specified\nexecution context. If omitted and `executionContextName` is not set,\nthe binding is exposed to all execution contexts of the target.\nThis parameter is mutually exclusive with `executionContextName`\nand `executionContextUniqueId`.\nDeprecated in favor of `executionContextName` due to an unclear use case\nand bugs in implementation (crbug.com/1169639). `executionContextId` will be\nremoved in the future.",
                             "experimental": true,
                             "deprecated": true,
                             "optional": true,
                             "$ref": "ExecutionContextId"
                         },
                         {
                             "name": "executionContextName",
-                            "description": "If specified, the binding is exposed to the executionContext with\nmatching name, even for contexts created after the binding is added.\nSee also `ExecutionContext.name` and `worldName` parameter to\n`Page.addScriptToEvaluateOnNewDocument`.\nThis parameter is mutually exclusive with `executionContextId`.",
+                            "description": "If specified, the binding is exposed to the executionContext with\nmatching name, even for contexts created after the binding is added.\nSee also `ExecutionContext.name` and `worldName` parameter to\n`Page.addScriptToEvaluateOnNewDocument`.\nThis parameter is mutually exclusive with `executionContextId`\nand `executionContextUniqueId`.",
                             "optional": true,
                             "type": "string"
+                        },
+                        {
+                            "name": "executionContextUniqueId",
+                            "description": "This parameter is mutually exclusive with `executionContextId`\nand `executionContextName`.",
+                            "experimental": true,
+                            "optional": true,
+                            "$ref": "ExecutionContextUniqueId"
                         }
                     ]
                 },
@@ -3535,6 +3547,11 @@
                             "name": "executionContextId",
                             "description": "Identifier of the context where the call was made.",
                             "$ref": "ExecutionContextId"
+                        },
+                        {
+                            "name": "executionContextUniqueId",
+                            "experimental": true,
+                            "$ref": "ExecutionContextUniqueId"
                         }
                     ]
                 },
@@ -3580,6 +3597,11 @@
                             "description": "Identifier of the context where the call was made.",
                             "$ref": "ExecutionContextId"
                         },
+                        {
+                            "name": "executionContextUniqueId",
+                            "experimental": true,
+                            "$ref": "ExecutionContextUniqueId"
+                        },
                         {
                             "name": "timestamp",
                             "description": "Call timestamp.",
@@ -3656,7 +3678,7 @@
                             "name": "executionContextUniqueId",
                             "description": "Unique Id of the destroyed context",
                             "experimental": true,
-                            "type": "string"
+                            "$ref": "ExecutionContextUniqueId"
                         }
                     ]
                 },

diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "devtools-protocol",
-  "version": "0.0.1301093",
+  "version": "0.0.1301748",
   "description": "The Chrome DevTools Protocol JSON",
   "repository": "https://github.com/ChromeDevTools/devtools-protocol",
   "author": "The Chromium Authors",

diff --git a/pdl/browser_protocol.pdl b/pdl/browser_protocol.pdl
@@ -6183,6 +6183,8 @@ domain Network
       TopLevelStorageAccess
       # The cookie should have been blocked by 3PCD but is exempted by CORS opt-in.
       CorsOptIn
+      # The cookie should have been blocked by 3PCD but is exempted by the first-party URL scheme.
+      Scheme
 
   # A cookie which was not stored from a response with the corresponding reason.
   experimental type BlockedSetCookieWithReason extends object

diff --git a/pdl/js_protocol.pdl b/pdl/js_protocol.pdl
@@ -1297,6 +1297,10 @@ domain Runtime
   # Id of an execution context.
   type ExecutionContextId extends integer
 
+  # Id of an execution context that is unique across processes
+  # (unlike ExecutionContextId).
+  type ExecutionContextUniqueId extends string
+
   # Description of an isolated world.
   type ExecutionContextDescription extends object
     properties
@@ -1310,7 +1314,7 @@ domain Runtime
       # A system-unique execution context identifier. Unlike the id, this is unique across
       # multiple processes, so can be reliably used to identify specific context while backend
       # performs a cross-process navigation.
-      experimental string uniqueId
+      experimental ExecutionContextUniqueId uniqueId
       # Embedder-specific auxiliary data likely matching {isDefault: boolean, type: 'default'|'isolated'|'worker', frameId: string}
       optional object auxData
 
@@ -1671,7 +1675,8 @@ domain Runtime
       # If specified, the binding would only be exposed to the specified
       # execution context. If omitted and `executionContextName` is not set,
       # the binding is exposed to all execution contexts of the target.
-      # This parameter is mutually exclusive with `executionContextName`.
+      # This parameter is mutually exclusive with `executionContextName`
+      # and `executionContextUniqueId`.
       # Deprecated in favor of `executionContextName` due to an unclear use case
       # and bugs in implementation (crbug.com/1169639). `executionContextId` will be
       # removed in the future.
@@ -1680,8 +1685,12 @@ domain Runtime
       # matching name, even for contexts created after the binding is added.
       # See also `ExecutionContext.name` and `worldName` parameter to
       # `Page.addScriptToEvaluateOnNewDocument`.
-      # This parameter is mutually exclusive with `executionContextId`.
+      # This parameter is mutually exclusive with `executionContextId`
+      # and `executionContextUniqueId`.
       optional string executionContextName
+      # This parameter is mutually exclusive with `executionContextId`
+      # and `executionContextName`.
+      experimental optional ExecutionContextUniqueId executionContextUniqueId
 
   # This method does not remove binding function from global object but
   # unsubscribes current runtime agent from Runtime.bindingCalled notifications.
@@ -1708,6 +1717,7 @@ domain Runtime
       string payload
       # Identifier of the context where the call was made.
       ExecutionContextId executionContextId
+      experimental ExecutionContextUniqueId executionContextUniqueId
 
   # Issued when console API was called.
   event consoleAPICalled
@@ -1736,6 +1746,7 @@ domain Runtime
       array of RemoteObject args
       # Identifier of the context where the call was made.
       ExecutionContextId executionContextId
+      experimental ExecutionContextUniqueId executionContextUniqueId
       # Call timestamp.
       Timestamp timestamp
       # Stack trace captured when the call was made. The async stack chain is automatically reported for
@@ -1774,7 +1785,7 @@ domain Runtime
       # Id of the destroyed context
       deprecated ExecutionContextId executionContextId
       # Unique Id of the destroyed context
-      experimental string executionContextUniqueId
+      experimental ExecutionContextUniqueId executionContextUniqueId
 
   # Issued when all executionContexts were cleared in browser
   event executionContextsCleared

diff --git a/types/protocol.d.ts b/types/protocol.d.ts
@@ -1908,6 +1908,12 @@ export namespace Protocol {
          */
         export type ExecutionContextId = integer;
 
+        /**
+         * Id of an execution context that is unique across processes
+         * (unlike ExecutionContextId).
+         */
+        export type ExecutionContextUniqueId = string;
+
         /**
          * Description of an isolated world.
          */
@@ -1930,7 +1936,7 @@ export namespace Protocol {
              * multiple processes, so can be reliably used to identify specific context while backend
              * performs a cross-process navigation.
              */
-            uniqueId: string;
+            uniqueId: ExecutionContextUniqueId;
             /**
              * Embedder-specific auxiliary data likely matching {isDefault: boolean, type: 'default'|'isolated'|'worker', frameId: string}
              */
@@ -2467,7 +2473,8 @@ export namespace Protocol {
              * If specified, the binding would only be exposed to the specified
              * execution context. If omitted and `executionContextName` is not set,
              * the binding is exposed to all execution contexts of the target.
-             * This parameter is mutually exclusive with `executionContextName`.
+             * This parameter is mutually exclusive with `executionContextName`
+             * and `executionContextUniqueId`.
              * Deprecated in favor of `executionContextName` due to an unclear use case
              * and bugs in implementation (crbug.com/1169639). `executionContextId` will be
              * removed in the future.
@@ -2478,9 +2485,15 @@ export namespace Protocol {
              * matching name, even for contexts created after the binding is added.
              * See also `ExecutionContext.name` and `worldName` parameter to
              * `Page.addScriptToEvaluateOnNewDocument`.
-             * This parameter is mutually exclusive with `executionContextId`.
+             * This parameter is mutually exclusive with `executionContextId`
+             * and `executionContextUniqueId`.
              */
             executionContextName?: string;
+            /**
+             * This parameter is mutually exclusive with `executionContextId`
+             * and `executionContextName`.
+             */
+            executionContextUniqueId?: ExecutionContextUniqueId;
         }
 
         export interface RemoveBindingRequest {
@@ -2508,6 +2521,7 @@ export namespace Protocol {
              * Identifier of the context where the call was made.
              */
             executionContextId: ExecutionContextId;
+            executionContextUniqueId: ExecutionContextUniqueId;
         }
 
         export const enum ConsoleAPICalledEventType {
@@ -2547,6 +2561,7 @@ export namespace Protocol {
              * Identifier of the context where the call was made.
              */
             executionContextId: ExecutionContextId;
+            executionContextUniqueId: ExecutionContextUniqueId;
             /**
              * Call timestamp.
              */
@@ -2611,7 +2626,7 @@ export namespace Protocol {
             /**
              * Unique Id of the destroyed context
              */
-            executionContextUniqueId: string;
+            executionContextUniqueId: ExecutionContextUniqueId;
         }
 
         /**
@@ -10770,7 +10785,7 @@ export namespace Protocol {
         /**
          * Types of reasons why a cookie should have been blocked by 3PCD but is exempted for the request.
          */
-        export type CookieExemptionReason = ('None' | 'UserSetting' | 'TPCDMetadata' | 'TPCDDeprecationTrial' | 'TPCDHeuristics' | 'EnterprisePolicy' | 'StorageAccess' | 'TopLevelStorageAccess' | 'CorsOptIn');
+        export type CookieExemptionReason = ('None' | 'UserSetting' | 'TPCDMetadata' | 'TPCDDeprecationTrial' | 'TPCDHeuristics' | 'EnterprisePolicy' | 'StorageAccess' | 'TopLevelStorageAccess' | 'CorsOptIn' | 'Scheme');
 
         /**
          * A cookie which was not stored from a response with the corresponding reason.