Roll protocol to r1468520

devtools-bot · devtools-bot · commit 2823d322ec37 · 2025-06-03T04:31:51.000Z
diff --git a/changelog.md b/changelog.md
@@ -1,7 +1,70 @@
 
 
+## Roll protocol to r1468520 — _2025-06-03T04:31:40.000Z_
+######  Diff: [`c9a1a5d...d8fdb5f`](https://github.com/ChromeDevTools/devtools-protocol/compare/c9a1a5d...d8fdb5f)
+
+```diff
+@@ browser_protocol.pdl:8514 @@ domain Page
+       AdFrameType adFrameType
+       optional array of AdFrameExplanation explanations
+ 
+-  # Identifies the bottom-most script which caused the frame to be labelled
+-  # as an ad.
++  # Identifies the script which caused a script or frame to be labelled as an
++  # ad.
+   experimental type AdScriptId extends object
+     properties
+-      # Script Id of the bottom-most script which caused the frame to be labelled
+-      # as an ad.
++      # Script Id of the script which caused a script or frame to be labelled as
++      # an ad.
+       Runtime.ScriptId scriptId
+-      # Id of adScriptId's debugger.
++      # Id of scriptId's debugger.
+       Runtime.UniqueDebuggerId debuggerId
+ 
++  # Encapsulates the script ancestry and the root script filterlist rule that
++  # caused the frame to be labelled as an ad. Only created when `ancestryChain`
++  # is not empty.
++  experimental type AdScriptAncestry extends object
++    properties
++      # A chain of `AdScriptId`s representing the ancestry of an ad script that
++      # led to the creation of a frame. The chain is ordered from the script
++      # itself (lower level) up to its root ancestor that was flagged by
++      # filterlist.
++      array of AdScriptId ancestryChain
++      # The filterlist rule that caused the root (last) script in
++      # `ancestryChain` to be ad-tagged. Only populated if the rule is
++      # available.
++      optional string rootScriptFilterlistRule
++
+   # Indicates whether the frame is a secure context and why it is the case.
+   experimental type SecureContextType extends string
+     enum
+@@ -9291,15 +9306,16 @@ domain Page
+       # Recommendation for manifest's id attribute to match current id computed from start_url
+       optional string recommendedId
+ 
+-  experimental command getAdScriptAncestryIds
++  experimental command getAdScriptAncestry
+     parameters
+       FrameId frameId
+     returns
+       # The ancestry chain of ad script identifiers leading to this frame's
+-      # creation, ordered from the most immediate script (in the frame creation
++      # creation, along with the root script's filterlist rule. The ancestry
++      # chain is ordered from the most immediate script (in the frame creation
+       # stack) to more distant ancestors (that created the immediately preceding
+       # script). Only sent if frame is labelled as an ad and ids are available.
+-      array of AdScriptId adScriptAncestryIds
++      optional AdScriptAncestry adScriptAncestry
+ 
+   # Returns present frame tree structure.
+   command getFrameTree
+```
+
 ## Roll protocol to r1467305 — _2025-05-30T04:31:28.000Z_
-######  Diff: [`8aaa683...47ad7ee`](https://github.com/ChromeDevTools/devtools-protocol/compare/8aaa683...47ad7ee)
+######  Diff: [`8aaa683...c9a1a5d`](https://github.com/ChromeDevTools/devtools-protocol/compare/8aaa683...c9a1a5d)
 
 ```diff
 @@ browser_protocol.pdl:3006 @@ domain DOM
@@ -13939,27 +14002,4 @@ index 8d8211b..2d56043 100644
        NodeId previousNodeId
        # Inserted node data.
        Node node
-```
-
-## Roll protocol to r1040073 — _2022-08-27T04:44:13.000Z_
-######  Diff: [`4561609...6ea69cb`](https://github.com/ChromeDevTools/devtools-protocol/compare/4561609...6ea69cb)
-
-```diff
-@@ browser_protocol.pdl:835 @@ experimental domain Audits
-   # all cases except for success.
-   type FederatedAuthRequestIssueReason extends string
-     enum
--      ApprovalDeclined
-+      ShouldEmbargo
-       TooManyRequests
-       ManifestListHttpNotFound
-       ManifestListNoResponse
-@@ -860,6 +860,7 @@ experimental domain Audits
-       IdTokenInvalidRequest
-       ErrorIdToken
-       Canceled
-+      RpPageNotVisible
- 
-   # This issue tracks client hints related issues. It's used to deprecate old
-   # features, encourage the use of new ones, and provide general guidance.
 ```
diff --git a/json/browser_protocol.json b/json/browser_protocol.json
@@ -18150,22 +18150,44 @@
                 },
                 {
                     "id": "AdScriptId",
-                    "description": "Identifies the bottom-most script which caused the frame to be labelled\nas an ad.",
+                    "description": "Identifies the script which caused a script or frame to be labelled as an\nad.",
                     "experimental": true,
                     "type": "object",
                     "properties": [
                         {
                             "name": "scriptId",
-                            "description": "Script Id of the bottom-most script which caused the frame to be labelled\nas an ad.",
+                            "description": "Script Id of the script which caused a script or frame to be labelled as\nan ad.",
                             "$ref": "Runtime.ScriptId"
                         },
                         {
                             "name": "debuggerId",
-                            "description": "Id of adScriptId's debugger.",
+                            "description": "Id of scriptId's debugger.",
                             "$ref": "Runtime.UniqueDebuggerId"
                         }
                     ]
                 },
+                {
+                    "id": "AdScriptAncestry",
+                    "description": "Encapsulates the script ancestry and the root script filterlist rule that\ncaused the frame to be labelled as an ad. Only created when `ancestryChain`\nis not empty.",
+                    "experimental": true,
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "ancestryChain",
+                            "description": "A chain of `AdScriptId`s representing the ancestry of an ad script that\nled to the creation of a frame. The chain is ordered from the script\nitself (lower level) up to its root ancestor that was flagged by\nfilterlist.",
+                            "type": "array",
+                            "items": {
+                                "$ref": "AdScriptId"
+                            }
+                        },
+                        {
+                            "name": "rootScriptFilterlistRule",
+                            "description": "The filterlist rule that caused the root (last) script in\n`ancestryChain` to be ad-tagged. Only populated if the rule is\navailable.",
+                            "optional": true,
+                            "type": "string"
+                        }
+                    ]
+                },
                 {
                     "id": "SecureContextType",
                     "description": "Indicates whether the frame is a secure context and why it is the case.",
@@ -20091,7 +20113,7 @@
                     ]
                 },
                 {
-                    "name": "getAdScriptAncestryIds",
+                    "name": "getAdScriptAncestry",
                     "experimental": true,
                     "parameters": [
                         {
@@ -20101,12 +20123,10 @@
                     ],
                     "returns": [
                         {
-                            "name": "adScriptAncestryIds",
-                            "description": "The ancestry chain of ad script identifiers leading to this frame's\ncreation, ordered from the most immediate script (in the frame creation\nstack) to more distant ancestors (that created the immediately preceding\nscript). Only sent if frame is labelled as an ad and ids are available.",
-                            "type": "array",
-                            "items": {
-                                "$ref": "AdScriptId"
-                            }
+                            "name": "adScriptAncestry",
+                            "description": "The ancestry chain of ad script identifiers leading to this frame's\ncreation, along with the root script's filterlist rule. The ancestry\nchain is ordered from the most immediate script (in the frame creation\nstack) to more distant ancestors (that created the immediately preceding\nscript). Only sent if frame is labelled as an ad and ids are available.",
+                            "optional": true,
+                            "$ref": "AdScriptAncestry"
                         }
                     ]
                 },
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "devtools-protocol",
-  "version": "0.0.1467305",
+  "version": "0.0.1468520",
   "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
@@ -8514,16 +8514,31 @@ domain Page
       AdFrameType adFrameType
       optional array of AdFrameExplanation explanations
 
-  # Identifies the bottom-most script which caused the frame to be labelled
-  # as an ad.
+  # Identifies the script which caused a script or frame to be labelled as an
+  # ad.
   experimental type AdScriptId extends object
     properties
-      # Script Id of the bottom-most script which caused the frame to be labelled
-      # as an ad.
+      # Script Id of the script which caused a script or frame to be labelled as
+      # an ad.
       Runtime.ScriptId scriptId
-      # Id of adScriptId's debugger.
+      # Id of scriptId's debugger.
       Runtime.UniqueDebuggerId debuggerId
 
+  # Encapsulates the script ancestry and the root script filterlist rule that
+  # caused the frame to be labelled as an ad. Only created when `ancestryChain`
+  # is not empty.
+  experimental type AdScriptAncestry extends object
+    properties
+      # A chain of `AdScriptId`s representing the ancestry of an ad script that
+      # led to the creation of a frame. The chain is ordered from the script
+      # itself (lower level) up to its root ancestor that was flagged by
+      # filterlist.
+      array of AdScriptId ancestryChain
+      # The filterlist rule that caused the root (last) script in
+      # `ancestryChain` to be ad-tagged. Only populated if the rule is
+      # available.
+      optional string rootScriptFilterlistRule
+
   # Indicates whether the frame is a secure context and why it is the case.
   experimental type SecureContextType extends string
     enum
@@ -9291,15 +9306,16 @@ domain Page
       # Recommendation for manifest's id attribute to match current id computed from start_url
       optional string recommendedId
 
-  experimental command getAdScriptAncestryIds
+  experimental command getAdScriptAncestry
     parameters
       FrameId frameId
     returns
       # The ancestry chain of ad script identifiers leading to this frame's
-      # creation, ordered from the most immediate script (in the frame creation
+      # creation, along with the root script's filterlist rule. The ancestry
+      # chain is ordered from the most immediate script (in the frame creation
       # stack) to more distant ancestors (that created the immediately preceding
       # script). Only sent if frame is labelled as an ad and ids are available.
-      array of AdScriptId adScriptAncestryIds
+      optional AdScriptAncestry adScriptAncestry
 
   # Returns present frame tree structure.
   command getFrameTree
diff --git a/types/protocol-mapping.d.ts b/types/protocol-mapping.d.ts
@@ -4052,9 +4052,9 @@ export namespace ProtocolMapping {
             paramsType: [];
             returnType: Protocol.Page.GetAppIdResponse;
         };
-        'Page.getAdScriptAncestryIds': {
-            paramsType: [Protocol.Page.GetAdScriptAncestryIdsRequest];
-            returnType: Protocol.Page.GetAdScriptAncestryIdsResponse;
+        'Page.getAdScriptAncestry': {
+            paramsType: [Protocol.Page.GetAdScriptAncestryRequest];
+            returnType: Protocol.Page.GetAdScriptAncestryResponse;
         };
         /**
          * Returns present frame tree structure.
diff --git a/types/protocol-proxy-api.d.ts b/types/protocol-proxy-api.d.ts
@@ -3101,7 +3101,7 @@ export namespace ProtocolProxyApi {
          */
         getAppId(): Promise<Protocol.Page.GetAppIdResponse>;
 
-        getAdScriptAncestryIds(params: Protocol.Page.GetAdScriptAncestryIdsRequest): Promise<Protocol.Page.GetAdScriptAncestryIdsResponse>;
+        getAdScriptAncestry(params: Protocol.Page.GetAdScriptAncestryRequest): Promise<Protocol.Page.GetAdScriptAncestryResponse>;
 
         /**
          * Returns present frame tree structure.
diff --git a/types/protocol-tests-proxy-api.d.ts b/types/protocol-tests-proxy-api.d.ts
@@ -3337,7 +3337,7 @@ export namespace ProtocolTestsProxyApi {
          */
         getAppId(): Promise<{id: number, result: Protocol.Page.GetAppIdResponse, sessionId: string}>;
 
-        getAdScriptAncestryIds(params: Protocol.Page.GetAdScriptAncestryIdsRequest): Promise<{id: number, result: Protocol.Page.GetAdScriptAncestryIdsResponse, sessionId: string}>;
+        getAdScriptAncestry(params: Protocol.Page.GetAdScriptAncestryRequest): Promise<{id: number, result: Protocol.Page.GetAdScriptAncestryResponse, sessionId: string}>;
 
         /**
          * Returns present frame tree structure.
diff --git a/types/protocol.d.ts b/types/protocol.d.ts
@@ -13985,21 +13985,42 @@ export namespace Protocol {
         }
 
         /**
-         * Identifies the bottom-most script which caused the frame to be labelled
-         * as an ad.
+         * Identifies the script which caused a script or frame to be labelled as an
+         * ad.
          */
         export interface AdScriptId {
             /**
-             * Script Id of the bottom-most script which caused the frame to be labelled
-             * as an ad.
+             * Script Id of the script which caused a script or frame to be labelled as
+             * an ad.
              */
             scriptId: Runtime.ScriptId;
             /**
-             * Id of adScriptId's debugger.
+             * Id of scriptId's debugger.
              */
             debuggerId: Runtime.UniqueDebuggerId;
         }
 
+        /**
+         * Encapsulates the script ancestry and the root script filterlist rule that
+         * caused the frame to be labelled as an ad. Only created when `ancestryChain`
+         * is not empty.
+         */
+        export interface AdScriptAncestry {
+            /**
+             * A chain of `AdScriptId`s representing the ancestry of an ad script that
+             * led to the creation of a frame. The chain is ordered from the script
+             * itself (lower level) up to its root ancestor that was flagged by
+             * filterlist.
+             */
+            ancestryChain: AdScriptId[];
+            /**
+             * The filterlist rule that caused the root (last) script in
+             * `ancestryChain` to be ad-tagged. Only populated if the rule is
+             * available.
+             */
+            rootScriptFilterlistRule?: string;
+        }
+
         /**
          * Indicates whether the frame is a secure context and why it is the case.
          */
@@ -14903,18 +14924,19 @@ export namespace Protocol {
             recommendedId?: string;
         }
 
-        export interface GetAdScriptAncestryIdsRequest {
+        export interface GetAdScriptAncestryRequest {
             frameId: FrameId;
         }
 
-        export interface GetAdScriptAncestryIdsResponse {
+        export interface GetAdScriptAncestryResponse {
             /**
              * The ancestry chain of ad script identifiers leading to this frame's
-             * creation, ordered from the most immediate script (in the frame creation
+             * creation, along with the root script's filterlist rule. The ancestry
+             * chain is ordered from the most immediate script (in the frame creation
              * stack) to more distant ancestors (that created the immediately preceding
              * script). Only sent if frame is labelled as an ad and ids are available.
              */
-            adScriptAncestryIds: AdScriptId[];
+            adScriptAncestry?: AdScriptAncestry;
         }
 
         export interface GetFrameTreeResponse {

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "devtools-protocol",`
`3`		`- "version": "0.0.1467305",`
	`3`	`+ "version": "0.0.1468520",`
`4`	`4`	`"description": "The Chrome DevTools Protocol JSON",`
`5`	`5`	`"repository": "https://github.com/ChromeDevTools/devtools-protocol",`
`6`	`6`	`"author": "The Chromium Authors",`