devtools-protocol 0.0.1682007 → 0.0.1683682

package/json/browser_protocol.json

@@ -688,6 +688,23 @@
                             }
                         }
                     ]
+                },
+                {
+                    "id": "AdScript",
+                    "description": "An ad script.\nNote: when the script is a transitive ad script, we only fill in the\nimmediate ancestor script in the provenance's adScriptAncestry field (as its\nfirst entry), rather than filling in the full ancestry. This saves work for\nthe backend, and the frontend can reconstruct the full ancestry if\nnecessary.",
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "scriptId",
+                            "description": "The script ID.",
+                            "$ref": "Runtime.ScriptId"
+                        },
+                        {
+                            "name": "provenance",
+                            "description": "The ad provenance.",
+                            "$ref": "Network.AdProvenance"
+                        }
+                    ]
                 }
             ],
             "commands": [
@@ -700,6 +717,19 @@
                             "$ref": "AdMetrics"
                         }
                     ]
+                },
+                {
+                    "name": "getAdScripts",
+                    "description": "Retrieves ad scripts for the current page. To minimize payload size, this\nonly returns the newly tracked ad scripts since the last call to\ngetAdScripts (i.e., the delta).",
+                    "returns": [
+                        {
+                            "name": "newScripts",
+                            "type": "array",
+                            "items": {
+                                "$ref": "AdScript"
+                            }
+                        }
+                    ]
                 }
             ]
         },
@@ -17632,7 +17662,7 @@
                         },
                         {
                             "name": "adScriptAncestry",
-                            "description": "The script ancestry that created the ad, if any.",
+                            "description": "The script ancestry that created the ad, if any.\nNote: depending on the context, this may represent the full ancestry up\nto the root script, or it may contain only one script representing the\nimmediate ancestor.",
                             "optional": true,
                             "$ref": "AdAncestry"
                         }
@@ -24424,9 +24454,21 @@
                         },
                         {
                             "name": "everyNthFrame",
-                            "description": "Send every n-th frame.",
+                            "description": "Send every n-th frame. Must be a positive integer.",
+                            "optional": true,
+                            "type": "integer"
+                        },
+                        {
+                            "name": "maxFramesInFlight",
+                            "description": "Maximum number of frames sent until screencastFrameAck is required.\nDefaults to 3. Must be a positive integer.",
                             "optional": true,
                             "type": "integer"
+                        },
+                        {
+                            "name": "sendLastFrame",
+                            "description": "By default, after screencastFrameAck arrives, the next produced frame is sent.\nPassing this flag enables storing the last produced frame in memory, which is\nimmediately sent upon screencastFrameAck. This way, overall performance is\ntraded for a better latency.",
+                            "optional": true,
+                            "type": "boolean"
                         }
                     ]
                 },

package/package.json

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

package/pdl/domains/Ads.pdl

@@ -48,3 +48,23 @@ experimental domain Ads
   command getAdMetrics
     returns
       AdMetrics metrics
+
+  # An ad script.
+  # Note: when the script is a transitive ad script, we only fill in the
+  # immediate ancestor script in the provenance's adScriptAncestry field (as its
+  # first entry), rather than filling in the full ancestry. This saves work for
+  # the backend, and the frontend can reconstruct the full ancestry if
+  # necessary.
+  type AdScript extends object
+    properties
+      # The script ID.
+      Runtime.ScriptId scriptId
+      # The ad provenance.
+      Network.AdProvenance provenance
+
+  # Retrieves ad scripts for the current page. To minimize payload size, this
+  # only returns the newly tracked ad scripts since the last call to
+  # getAdScripts (i.e., the delta).
+  command getAdScripts
+    returns
+      array of AdScript newScripts

package/pdl/domains/Network.pdl

@@ -1701,6 +1701,9 @@ domain Network
       # The filterlist rule that matched, if any.
       optional string filterlistRule
       # The script ancestry that created the ad, if any.
+      # Note: depending on the context, this may represent the full ancestry up
+      # to the root script, or it may contain only one script representing the
+      # immediate ancestor.
       optional AdAncestry adScriptAncestry
 
   # Fired when additional information about a requestWillBeSent event is available from the

package/pdl/domains/Page.pdl

@@ -1170,8 +1170,16 @@ domain Page
       optional integer maxWidth
       # Maximum screenshot height.
       optional integer maxHeight
-      # Send every n-th frame.
+      # Send every n-th frame. Must be a positive integer.
       optional integer everyNthFrame
+      # Maximum number of frames sent until screencastFrameAck is required.
+      # Defaults to 3. Must be a positive integer.
+      optional integer maxFramesInFlight
+      # By default, after screencastFrameAck arrives, the next produced frame is sent.
+      # Passing this flag enables storing the last produced frame in memory, which is
+      # immediately sent upon screencastFrameAck. This way, overall performance is
+      # traded for a better latency.
+      optional boolean sendLastFrame
 
   # Starts screencast video recording.
   experimental command startScreenRecording

package/types/protocol-mapping.d.ts

@@ -1756,6 +1756,15 @@ export namespace ProtocolMapping {
             paramsType: [];
             returnType: Protocol.Ads.GetAdMetricsResponse;
         };
+        /**
+         * Retrieves ad scripts for the current page. To minimize payload size, this
+         * only returns the newly tracked ad scripts since the last call to
+         * getAdScripts (i.e., the delta).
+         */
+        'Ads.getAdScripts': {
+            paramsType: [];
+            returnType: Protocol.Ads.GetAdScriptsResponse;
+        };
         /**
          * Disables animation domain notifications.
          */

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

@@ -761,6 +761,13 @@ export namespace ProtocolProxyApi {
          */
         getAdMetrics(): Promise<Protocol.Ads.GetAdMetricsResponse>;
 
+        /**
+         * Retrieves ad scripts for the current page. To minimize payload size, this
+         * only returns the newly tracked ad scripts since the last call to
+         * getAdScripts (i.e., the delta).
+         */
+        getAdScripts(): Promise<Protocol.Ads.GetAdScriptsResponse>;
+
     }
 
     export interface AnimationApi {

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

@@ -809,6 +809,13 @@ export namespace ProtocolTestsProxyApi {
          */
         getAdMetrics(): Promise<{id: number, result: Protocol.Ads.GetAdMetricsResponse, sessionId: string}>;
 
+        /**
+         * Retrieves ad scripts for the current page. To minimize payload size, this
+         * only returns the newly tracked ad scripts since the last call to
+         * getAdScripts (i.e., the delta).
+         */
+        getAdScripts(): Promise<{id: number, result: Protocol.Ads.GetAdScriptsResponse, sessionId: string}>;
+
     }
 
     export interface AnimationApi {

package/types/protocol.d.ts

@@ -3193,9 +3193,32 @@ export namespace Protocol {
             removeAdFrames: Page.FrameId[];
         }
 
+        /**
+         * An ad script.
+         * Note: when the script is a transitive ad script, we only fill in the
+         * immediate ancestor script in the provenance's adScriptAncestry field (as its
+         * first entry), rather than filling in the full ancestry. This saves work for
+         * the backend, and the frontend can reconstruct the full ancestry if
+         * necessary.
+         */
+        export interface AdScript {
+            /**
+             * The script ID.
+             */
+            scriptId: Runtime.ScriptId;
+            /**
+             * The ad provenance.
+             */
+            provenance: Network.AdProvenance;
+        }
+
         export interface GetAdMetricsResponse {
             metrics: AdMetrics;
         }
+
+        export interface GetAdScriptsResponse {
+            newScripts: AdScript[];
+        }
     }
 
     /**
@@ -13899,6 +13922,9 @@ export namespace Protocol {
             filterlistRule?: string;
             /**
              * The script ancestry that created the ad, if any.
+             * Note: depending on the context, this may represent the full ancestry up
+             * to the root script, or it may contain only one script representing the
+             * immediate ancestor.
              */
             adScriptAncestry?: AdAncestry;
         }
@@ -18179,9 +18205,21 @@ export namespace Protocol {
              */
             maxHeight?: integer;
             /**
-             * Send every n-th frame.
+             * Send every n-th frame. Must be a positive integer.
              */
             everyNthFrame?: integer;
+            /**
+             * Maximum number of frames sent until screencastFrameAck is required.
+             * Defaults to 3. Must be a positive integer.
+             */
+            maxFramesInFlight?: integer;
+            /**
+             * By default, after screencastFrameAck arrives, the next produced frame is sent.
+             * Passing this flag enables storing the last produced frame in memory, which is
+             * immediately sent upon screencastFrameAck. This way, overall performance is
+             * traded for a better latency.
+             */
+            sendLastFrame?: boolean;
         }
 
         export interface StartScreenRecordingRequest {