devtools-protocol 0.0.1253004 → 0.0.1254350

package/json/browser_protocol.json

@@ -12770,6 +12770,23 @@
                         "NameValuePairExceedsMaxSize"
                     ]
                 },
+                {
+                    "id": "CookieExemptionReason",
+                    "description": "Types of reasons why a cookie should have been blocked by 3PCD but is exempted for the request.",
+                    "experimental": true,
+                    "type": "string",
+                    "enum": [
+                        "None",
+                        "UserSetting",
+                        "TPCDMetadata",
+                        "TPCDDeprecationTrial",
+                        "TPCDHeuristics",
+                        "EnterprisePolicy",
+                        "StorageAccess",
+                        "TopLevelStorageAccess",
+                        "BrowserHeuristics"
+                    ]
+                },
                 {
                     "id": "BlockedSetCookieWithReason",
                     "description": "A cookie which was not stored from a response with the corresponding reason.",
@@ -12798,23 +12815,47 @@
                     ]
                 },
                 {
-                    "id": "BlockedCookieWithReason",
-                    "description": "A cookie with was not sent with a request with the corresponding reason.",
+                    "id": "ExemptedSetCookieWithReason",
+                    "description": "A cookie should have been blocked by 3PCD but is exempted and stored from a response with the\ncorresponding reason. A cookie could only have at most one exemption reason.",
+                    "experimental": true,
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "exemptionReason",
+                            "description": "The reason the cookie was exempted.",
+                            "$ref": "CookieExemptionReason"
+                        },
+                        {
+                            "name": "cookie",
+                            "description": "The cookie object representing the cookie.",
+                            "$ref": "Cookie"
+                        }
+                    ]
+                },
+                {
+                    "id": "AssociatedCookie",
+                    "description": "A cookie associated with the request which may or may not be sent with it.\nIncludes the cookies itself and reasons for blocking or exemption.",
                     "experimental": true,
                     "type": "object",
                     "properties": [
+                        {
+                            "name": "cookie",
+                            "description": "The cookie object representing the cookie which was not sent.",
+                            "$ref": "Cookie"
+                        },
                         {
                             "name": "blockedReasons",
-                            "description": "The reason(s) the cookie was blocked.",
+                            "description": "The reason(s) the cookie was blocked. If empty means the cookie is included.",
                             "type": "array",
                             "items": {
                                 "$ref": "CookieBlockedReason"
                             }
                         },
                         {
-                            "name": "cookie",
-                            "description": "The cookie object representing the cookie which was not sent.",
-                            "$ref": "Cookie"
+                            "name": "exemptionReason",
+                            "description": "The reason the cookie should have been blocked by 3PCD but is exempted. A cookie could\nonly have at most one exemption reason.",
+                            "optional": true,
+                            "$ref": "CookieExemptionReason"
                         }
                     ]
                 },
@@ -13633,7 +13674,7 @@
                 },
                 {
                     "name": "deleteCookies",
-                    "description": "Deletes browser cookies with matching name and url or domain/path pair.",
+                    "description": "Deletes browser cookies with matching name and url or domain/path/partitionKey pair.",
                     "parameters": [
                         {
                             "name": "name",
@@ -13657,6 +13698,12 @@
                             "description": "If specified, deletes only cookies with the exact path.",
                             "optional": true,
                             "type": "string"
+                        },
+                        {
+                            "name": "partitionKey",
+                            "description": "If specified, deletes only cookies with the the given name and partitionKey where domain\nmatches provided URL.",
+                            "optional": true,
+                            "type": "string"
                         }
                     ]
                 },
@@ -14805,10 +14852,10 @@
                         },
                         {
                             "name": "associatedCookies",
-                            "description": "A list of cookies potentially associated to the requested URL. This includes both cookies sent with\nthe request and the ones not sent; the latter are distinguished by having blockedReason field set.",
+                            "description": "A list of cookies potentially associated to the requested URL. This includes both cookies sent with\nthe request and the ones not sent; the latter are distinguished by having blockedReasons field set.",
                             "type": "array",
                             "items": {
-                                "$ref": "BlockedCookieWithReason"
+                                "$ref": "AssociatedCookie"
                             }
                         },
                         {
@@ -14886,6 +14933,15 @@
                             "description": "True if partitioned cookies are enabled, but the partition key is not serializeable to string.",
                             "optional": true,
                             "type": "boolean"
+                        },
+                        {
+                            "name": "exemptedCookies",
+                            "description": "A list of cookies which should have been blocked by 3PCD but are exempted and stored from\nthe response with the corresponding reason.",
+                            "optional": true,
+                            "type": "array",
+                            "items": {
+                                "$ref": "ExemptedSetCookieWithReason"
+                            }
                         }
                     ]
                 },

package/package.json

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

package/pdl/browser_protocol.pdl

@@ -5991,6 +5991,28 @@ domain Network
       # RFC6265bis.
       NameValuePairExceedsMaxSize
 
+  # Types of reasons why a cookie should have been blocked by 3PCD but is exempted for the request.
+  experimental type CookieExemptionReason extends string
+    enum
+      # The default value. Cookie with this reason could either be blocked or included.
+      None
+      # The cookie should have been blocked by 3PCD but is exempted by explicit user setting.
+      UserSetting
+      # The cookie should have been blocked by 3PCD but is exempted by metadata mitigation.
+      TPCDMetadata
+      # The cookie should have been blocked by 3PCD but is exempted by Deprecation Trial mitigation.
+      TPCDDeprecationTrial
+      # The cookie should have been blocked by 3PCD but is exempted by heuristics mitigation.
+      TPCDHeuristics
+      # The cookie should have been blocked by 3PCD but is exempted by Enterprise Policy.
+      EnterprisePolicy
+      # The cookie should have been blocked by 3PCD but is exempted by Storage Access API.
+      StorageAccess
+      # The cookie should have been blocked by 3PCD but is exempted by Top-level Storage Access API.
+      TopLevelStorageAccess
+      # The cookie should have been blocked by 3PCD but is exempted by browser heuristics.
+      BrowserHeuristics
+
   # A cookie which was not stored from a response with the corresponding reason.
   experimental type BlockedSetCookieWithReason extends object
     properties
@@ -6004,13 +6026,26 @@ domain Network
       # errors.
       optional Cookie cookie
 
-  # A cookie with was not sent with a request with the corresponding reason.
-  experimental type BlockedCookieWithReason extends object
+  # A cookie should have been blocked by 3PCD but is exempted and stored from a response with the
+  # corresponding reason. A cookie could only have at most one exemption reason.
+  experimental type ExemptedSetCookieWithReason extends object
+    properties
+      # The reason the cookie was exempted.
+      CookieExemptionReason exemptionReason
+      # The cookie object representing the cookie.
+      Cookie cookie
+
+  # A cookie associated with the request which may or may not be sent with it.
+  # Includes the cookies itself and reasons for blocking or exemption.
+  experimental type AssociatedCookie extends object
     properties
-      # The reason(s) the cookie was blocked.
-      array of CookieBlockedReason blockedReasons
       # The cookie object representing the cookie which was not sent.
       Cookie cookie
+      # The reason(s) the cookie was blocked. If empty means the cookie is included.
+      array of CookieBlockedReason blockedReasons
+      # The reason the cookie should have been blocked by 3PCD but is exempted. A cookie could
+      # only have at most one exemption reason.
+      optional CookieExemptionReason exemptionReason
 
   # Cookie parameter object
   type CookieParam extends object
@@ -6238,7 +6273,7 @@ domain Network
       # Response to a requestIntercepted with an authChallenge. Must not be set otherwise.
       optional AuthChallengeResponse authChallengeResponse
 
-  # Deletes browser cookies with matching name and url or domain/path pair.
+  # Deletes browser cookies with matching name and url or domain/path/partitionKey pair.
   command deleteCookies
     parameters
       # Name of the cookies to remove.
@@ -6250,6 +6285,9 @@ domain Network
       optional string domain
       # If specified, deletes only cookies with the exact path.
       optional string path
+      # If specified, deletes only cookies with the the given name and partitionKey where domain
+      # matches provided URL.
+      optional string partitionKey
 
   # Disables network tracking, prevents network events from being sent to the client.
   command disable
@@ -6779,8 +6817,8 @@ domain Network
       # Request identifier. Used to match this information to an existing requestWillBeSent event.
       RequestId requestId
       # A list of cookies potentially associated to the requested URL. This includes both cookies sent with
-      # the request and the ones not sent; the latter are distinguished by having blockedReason field set.
-      array of BlockedCookieWithReason associatedCookies
+      # the request and the ones not sent; the latter are distinguished by having blockedReasons field set.
+      array of AssociatedCookie associatedCookies
       # Raw request headers as they will be sent over the wire.
       Headers headers
       # Connection timing information for the request.
@@ -6818,6 +6856,9 @@ domain Network
       optional string cookiePartitionKey
       # True if partitioned cookies are enabled, but the partition key is not serializeable to string.
       optional boolean cookiePartitionKeyOpaque
+      # A list of cookies which should have been blocked by 3PCD but are exempted and stored from
+      # the response with the corresponding reason.
+      optional array of ExemptedSetCookieWithReason exemptedCookies
 
   # Fired exactly once for each Trust Token operation. Depending on
   # the type of the operation and whether the operation succeeded or

package/types/protocol-mapping.d.ts

@@ -3200,7 +3200,7 @@ export namespace ProtocolMapping {
             returnType: void;
         };
         /**
-         * Deletes browser cookies with matching name and url or domain/path pair.
+         * Deletes browser cookies with matching name and url or domain/path/partitionKey pair.
          */
         'Network.deleteCookies': {
             paramsType: [Protocol.Network.DeleteCookiesRequest];

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

@@ -2281,7 +2281,7 @@ export namespace ProtocolProxyApi {
         continueInterceptedRequest(params: Protocol.Network.ContinueInterceptedRequestRequest): Promise<void>;
 
         /**
-         * Deletes browser cookies with matching name and url or domain/path pair.
+         * Deletes browser cookies with matching name and url or domain/path/partitionKey pair.
          */
         deleteCookies(params: Protocol.Network.DeleteCookiesRequest): Promise<void>;
 

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

@@ -2417,7 +2417,7 @@ export namespace ProtocolTestsProxyApi {
         continueInterceptedRequest(params: Protocol.Network.ContinueInterceptedRequestRequest): Promise<void>;
 
         /**
-         * Deletes browser cookies with matching name and url or domain/path pair.
+         * Deletes browser cookies with matching name and url or domain/path/partitionKey pair.
          */
         deleteCookies(params: Protocol.Network.DeleteCookiesRequest): Promise<void>;
 

package/types/protocol.d.ts

@@ -10592,6 +10592,11 @@ export namespace Protocol {
          */
         export type CookieBlockedReason = ('SecureOnly' | 'NotOnPath' | 'DomainMismatch' | 'SameSiteStrict' | 'SameSiteLax' | 'SameSiteUnspecifiedTreatedAsLax' | 'SameSiteNoneInsecure' | 'UserPreferences' | 'ThirdPartyPhaseout' | 'ThirdPartyBlockedInFirstPartySet' | 'UnknownError' | 'SchemefulSameSiteStrict' | 'SchemefulSameSiteLax' | 'SchemefulSameSiteUnspecifiedTreatedAsLax' | 'SamePartyFromCrossPartyContext' | 'NameValuePairExceedsMaxSize');
 
+        /**
+         * 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' | 'BrowserHeuristics');
+
         /**
          * A cookie which was not stored from a response with the corresponding reason.
          */
@@ -10614,17 +10619,38 @@ export namespace Protocol {
         }
 
         /**
-         * A cookie with was not sent with a request with the corresponding reason.
+         * A cookie should have been blocked by 3PCD but is exempted and stored from a response with the
+         * corresponding reason. A cookie could only have at most one exemption reason.
          */
-        export interface BlockedCookieWithReason {
+        export interface ExemptedSetCookieWithReason {
             /**
-             * The reason(s) the cookie was blocked.
+             * The reason the cookie was exempted.
              */
-            blockedReasons: CookieBlockedReason[];
+            exemptionReason: CookieExemptionReason;
+            /**
+             * The cookie object representing the cookie.
+             */
+            cookie: Cookie;
+        }
+
+        /**
+         * A cookie associated with the request which may or may not be sent with it.
+         * Includes the cookies itself and reasons for blocking or exemption.
+         */
+        export interface AssociatedCookie {
             /**
              * The cookie object representing the cookie which was not sent.
              */
             cookie: Cookie;
+            /**
+             * The reason(s) the cookie was blocked. If empty means the cookie is included.
+             */
+            blockedReasons: CookieBlockedReason[];
+            /**
+             * The reason the cookie should have been blocked by 3PCD but is exempted. A cookie could
+             * only have at most one exemption reason.
+             */
+            exemptionReason?: CookieExemptionReason;
         }
 
         /**
@@ -11110,6 +11136,11 @@ export namespace Protocol {
              * If specified, deletes only cookies with the exact path.
              */
             path?: string;
+            /**
+             * If specified, deletes only cookies with the the given name and partitionKey where domain
+             * matches provided URL.
+             */
+            partitionKey?: string;
         }
 
         export interface EmulateNetworkConditionsRequest {
@@ -11954,9 +11985,9 @@ export namespace Protocol {
             requestId: RequestId;
             /**
              * A list of cookies potentially associated to the requested URL. This includes both cookies sent with
-             * the request and the ones not sent; the latter are distinguished by having blockedReason field set.
+             * the request and the ones not sent; the latter are distinguished by having blockedReasons field set.
              */
-            associatedCookies: BlockedCookieWithReason[];
+            associatedCookies: AssociatedCookie[];
             /**
              * Raw request headers as they will be sent over the wire.
              */
@@ -12020,6 +12051,11 @@ export namespace Protocol {
              * True if partitioned cookies are enabled, but the partition key is not serializeable to string.
              */
             cookiePartitionKeyOpaque?: boolean;
+            /**
+             * A list of cookies which should have been blocked by 3PCD but are exempted and stored from
+             * the response with the corresponding reason.
+             */
+            exemptedCookies?: ExemptedSetCookieWithReason[];
         }
 
         export const enum TrustTokenOperationDoneEventStatus {