devtools-protocol 0.0.1601756 → 0.0.1602427

package/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/package.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/pdl/domains/DOM.pdl

@@ -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

package/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

package/types/protocol.d.ts

@@ -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
          */