Roll protocol to r1602427

Author: devtools-bot

changelog.md

@@ -1,7 +1,65 @@
 
 
+## Roll protocol to r1602427 — _2026-03-20T04:57:27.000Z_
+######  Diff: [`7a16bec...c588f6e`](https://github.com/ChromeDevTools/devtools-protocol/compare/7a16bec...c588f6e)
+
+```diff
+@@ domains/DOM.pdl:13 @@ @@ -13,6 +13,7 @@
+ # corresponding document elements as their child nodes.
+ domain DOM
+   depends on Runtime
++  depends on Network
+ 
+   # Unique DOM node identifier.
+   type NodeId extends integer
+@@ -184,7 +185,7 @@ domain DOM
+       experimental optional boolean isScrollable
+       experimental optional boolean affectedByStartingStyles
+       experimental optional array of StyleSheetId adoptedStyleSheets
+-      experimental optional boolean isAdRelated
++      experimental optional Network.AdProvenance adProvenance
+ 
+   # A structure to hold the top-level node of a detached tree and an array of its retained descendants.
+   type DetachedElementInfo extends object
+@@ -919,8 +920,8 @@ domain DOM
+     parameters
+       # The id of the node.
+       DOM.NodeId nodeId
+-      # If the node is ad related.
+-      boolean isAdRelated
++      # The provenance of the ad related node, if it is ad related.
++      optional Network.AdProvenance adProvenance
+ 
+   # Fired when a node's starting styles changes.
+   experimental event affectedByStartingStylesFlagUpdated
+diff --git a/pdl/domains/Network.pdl b/pdl/domains/Network.pdl
+index 504edfe8..a03d977b 100644
+--- a/pdl/domains/Network.pdl
++++ b/pdl/domains/Network.pdl
+@@ -1825,6 +1825,19 @@ domain Network
+       # `ancestryChain` to be tagged as an ad.
+       optional string rootScriptFilterlistRule
+ 
++  # Represents the provenance of an ad resource or element. Only one of
++  # `filterlistRule` or `adScriptAncestry` can be set. If `filterlistRule`
++  # is provided, the resource URL directly matches a filter list rule. If
++  # `adScriptAncestry` is provided, an ad script initiated the resource fetch or
++  # appended the element to the DOM. If neither is provided, the entity is
++  # known to be an ad, but provenance tracking information is unavailable.
++  experimental type AdProvenance extends object
++    properties
++      # The filterlist rule that matched, if any.
++      optional string filterlistRule
++      # The script ancestry that created the ad, if any.
++      optional AdAncestry adScriptAncestry
++
+   # Fired when additional information about a requestWillBeSent event is available from the
+   # network stack. Not every requestWillBeSent event will have an additional
+   # requestWillBeSentExtraInfo fired for it, and there is no guarantee whether requestWillBeSent
+```
+
 ## Roll protocol to r1601756 — _2026-03-19T05:02:00.000Z_
-######  Diff: [`e653604...a0bd184`](https://github.com/ChromeDevTools/devtools-protocol/compare/e653604...a0bd184)
+######  Diff: [`e653604...7a16bec`](https://github.com/ChromeDevTools/devtools-protocol/compare/e653604...7a16bec)
 
 ```diff
 @@ domains/CSS.pdl:602 @@ experimental domain CSS
@@ -42717,18 +42775,4 @@ index 0dbdc01d..7a3c772c 100644
        experimental optional SerializationOptions serializationOptions
      returns
        # Evaluation result.
-```
-
-## Roll protocol to r1148337 — _2023-05-24T04:27:07.000Z_
-######  Diff: [`fb80158...4f898ab`](https://github.com/ChromeDevTools/devtools-protocol/compare/fb80158...4f898ab)
-
-```diff
-@@ browser_protocol.pdl:5121 @@ domain Network
-       experimental number pushStart
-       # Time the server finished pushing request.
-       experimental number pushEnd
-+      # Started receiving response headers.
-+      experimental number receiveHeadersStart
-       # Finished receiving response headers.
-       number receiveHeadersEnd
 ```

json/browser_protocol.json

@@ -6928,7 +6928,8 @@
             "domain": "DOM",
             "description": "This domain exposes DOM read/write operations. Each DOM Node is represented with its mirror object\nthat has an `id`. This `id` can be used to get additional information on the Node, resolve it into\nthe JavaScript object wrapper, etc. It is important that client receives DOM events only for the\nnodes that are known to the client. Backend keeps track of the nodes that were sent to the client\nand never sends the same node twice. It is client's responsibility to collect information about\nthe nodes that were sent to the client. Note that `iframe` owner elements will return\ncorresponding document elements as their child nodes.",
             "dependencies": [
-                "Runtime"
+                "Runtime",
+                "Network"
             ],
             "types": [
                 {
@@ -7285,10 +7286,10 @@
                             }
                         },
                         {
-                            "name": "isAdRelated",
+                            "name": "adProvenance",
                             "experimental": true,
                             "optional": true,
-                            "type": "boolean"
+                            "$ref": "Network.AdProvenance"
                         }
                     ]
                 },
@@ -8854,9 +8855,10 @@
                             "$ref": "DOM.NodeId"
                         },
                         {
-                            "name": "isAdRelated",
-                            "description": "If the node is ad related.",
-                            "type": "boolean"
+                            "name": "adProvenance",
+                            "description": "The provenance of the ad related node, if it is ad related.",
+                            "optional": true,
+                            "$ref": "Network.AdProvenance"
                         }
                     ]
                 },
@@ -17297,6 +17299,26 @@
                         }
                     ]
                 },
+                {
+                    "id": "AdProvenance",
+                    "description": "Represents the provenance of an ad resource or element. Only one of\n`filterlistRule` or `adScriptAncestry` can be set. If `filterlistRule`\nis provided, the resource URL directly matches a filter list rule. If\n`adScriptAncestry` is provided, an ad script initiated the resource fetch or\nappended the element to the DOM. If neither is provided, the entity is\nknown to be an ad, but provenance tracking information is unavailable.",
+                    "experimental": true,
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "filterlistRule",
+                            "description": "The filterlist rule that matched, if any.",
+                            "optional": true,
+                            "type": "string"
+                        },
+                        {
+                            "name": "adScriptAncestry",
+                            "description": "The script ancestry that created the ad, if any.",
+                            "optional": true,
+                            "$ref": "AdAncestry"
+                        }
+                    ]
+                },
                 {
                     "id": "CrossOriginOpenerPolicyValue",
                     "experimental": true,

package-lock.json

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

package.json

@@ -13,6 +13,7 @@
 # corresponding document elements as their child nodes.
 domain DOM
   depends on Runtime
+  depends on Network
 
   # Unique DOM node identifier.
   type NodeId extends integer
@@ -184,7 +185,7 @@ domain DOM
       experimental optional boolean isScrollable
       experimental optional boolean affectedByStartingStyles
       experimental optional array of StyleSheetId adoptedStyleSheets
-      experimental optional boolean isAdRelated
+      experimental optional Network.AdProvenance adProvenance
 
   # A structure to hold the top-level node of a detached tree and an array of its retained descendants.
   type DetachedElementInfo extends object
@@ -919,8 +920,8 @@ domain DOM
     parameters
       # The id of the node.
       DOM.NodeId nodeId
-      # If the node is ad related.
-      boolean isAdRelated
+      # The provenance of the ad related node, if it is ad related.
+      optional Network.AdProvenance adProvenance
 
   # Fired when a node's starting styles changes.
   experimental event affectedByStartingStylesFlagUpdated

pdl/domains/DOM.pdl

@@ -1825,6 +1825,19 @@ domain Network
       # `ancestryChain` to be tagged as an ad.
       optional string rootScriptFilterlistRule
 
+  # Represents the provenance of an ad resource or element. Only one of
+  # `filterlistRule` or `adScriptAncestry` can be set. If `filterlistRule`
+  # is provided, the resource URL directly matches a filter list rule. If
+  # `adScriptAncestry` is provided, an ad script initiated the resource fetch or
+  # appended the element to the DOM. If neither is provided, the entity is
+  # known to be an ad, but provenance tracking information is unavailable.
+  experimental type AdProvenance extends object
+    properties
+      # The filterlist rule that matched, if any.
+      optional string filterlistRule
+      # The script ancestry that created the ad, if any.
+      optional AdAncestry adScriptAncestry
+
   # Fired when additional information about a requestWillBeSent event is available from the
   # network stack. Not every requestWillBeSent event will have an additional
   # requestWillBeSentExtraInfo fired for it, and there is no guarantee whether requestWillBeSent

pdl/domains/Network.pdl

@@ -7062,7 +7062,7 @@ export namespace Protocol {
             /**
              * @experimental
              */
-            isAdRelated?: boolean;
+            adProvenance?: Network.AdProvenance;
         }
 
         /**
@@ -8138,9 +8138,9 @@ export namespace Protocol {
              */
             nodeId: DOM.NodeId;
             /**
-             * If the node is ad related.
+             * The provenance of the ad related node, if it is ad related.
              */
-            isAdRelated: boolean;
+            adProvenance?: Network.AdProvenance;
         }
 
         /**
@@ -13687,6 +13687,26 @@ export namespace Protocol {
             rootScriptFilterlistRule?: string;
         }
 
+        /**
+         * Represents the provenance of an ad resource or element. Only one of
+         * `filterlistRule` or `adScriptAncestry` can be set. If `filterlistRule`
+         * is provided, the resource URL directly matches a filter list rule. If
+         * `adScriptAncestry` is provided, an ad script initiated the resource fetch or
+         * appended the element to the DOM. If neither is provided, the entity is
+         * known to be an ad, but provenance tracking information is unavailable.
+         * @experimental
+         */
+        export interface AdProvenance {
+            /**
+             * The filterlist rule that matched, if any.
+             */
+            filterlistRule?: string;
+            /**
+             * The script ancestry that created the ad, if any.
+             */
+            adScriptAncestry?: AdAncestry;
+        }
+
         /**
          * @experimental
          */