Skip to content

Commit a12defa

Browse files
devtools-botdevtools-bot
committed
Roll protocol to r1683682
1 parent 022aac9 commit a12defa

11 files changed

Lines changed: 208 additions & 37 deletions

‎changelog.md‎

Lines changed: 67 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,73 @@
11

22

3+
## Roll protocol to r1683682 — _2026-08-21T04:41:18.000Z_
4+
###### Diff: [`022aac9...dc3d21f`](https://github.com/ChromeDevTools/devtools-protocol/compare/022aac9...dc3d21f)
5+
6+
```diff
7+
@@ domains/Ads.pdl:48 @@ experimental domain Ads
8+
command getAdMetrics
9+
returns
10+
AdMetrics metrics
11+
+
12+
+ # An ad script.
13+
+ # Note: when the script is a transitive ad script, we only fill in the
14+
+ # immediate ancestor script in the provenance's adScriptAncestry field (as its
15+
+ # first entry), rather than filling in the full ancestry. This saves work for
16+
+ # the backend, and the frontend can reconstruct the full ancestry if
17+
+ # necessary.
18+
+ type AdScript extends object
19+
+ properties
20+
+ # The script ID.
21+
+ Runtime.ScriptId scriptId
22+
+ # The ad provenance.
23+
+ Network.AdProvenance provenance
24+
+
25+
+ # Retrieves ad scripts for the current page. To minimize payload size, this
26+
+ # only returns the newly tracked ad scripts since the last call to
27+
+ # getAdScripts (i.e., the delta).
28+
+ command getAdScripts
29+
+ returns
30+
+ array of AdScript newScripts
31+
diff --git a/pdl/domains/Network.pdl b/pdl/domains/Network.pdl
32+
index c00edefc..228ed6c8 100644
33+
--- a/pdl/domains/Network.pdl
34+
+++ b/pdl/domains/Network.pdl
35+
@@ -1701,6 +1701,9 @@ domain Network
36+
# The filterlist rule that matched, if any.
37+
optional string filterlistRule
38+
# The script ancestry that created the ad, if any.
39+
+ # Note: depending on the context, this may represent the full ancestry up
40+
+ # to the root script, or it may contain only one script representing the
41+
+ # immediate ancestor.
42+
optional AdAncestry adScriptAncestry
43+
44+
# Fired when additional information about a requestWillBeSent event is available from the
45+
diff --git a/pdl/domains/Page.pdl b/pdl/domains/Page.pdl
46+
index 80cd13ea..0961300c 100644
47+
--- a/pdl/domains/Page.pdl
48+
+++ b/pdl/domains/Page.pdl
49+
@@ -1170,8 +1170,16 @@ domain Page
50+
optional integer maxWidth
51+
# Maximum screenshot height.
52+
optional integer maxHeight
53+
- # Send every n-th frame.
54+
+ # Send every n-th frame. Must be a positive integer.
55+
optional integer everyNthFrame
56+
+ # Maximum number of frames sent until screencastFrameAck is required.
57+
+ # Defaults to 3. Must be a positive integer.
58+
+ optional integer maxFramesInFlight
59+
+ # By default, after screencastFrameAck arrives, the next produced frame is sent.
60+
+ # Passing this flag enables storing the last produced frame in memory, which is
61+
+ # immediately sent upon screencastFrameAck. This way, overall performance is
62+
+ # traded for a better latency.
63+
+ optional boolean sendLastFrame
64+
65+
# Starts screencast video recording.
66+
experimental command startScreenRecording
67+
```
68+
369
## Roll protocol to r1682007 — _2026-08-19T04:37:26.000Z_
4-
###### Diff: [`0539a3c...7efb382`](https://github.com/ChromeDevTools/devtools-protocol/compare/0539a3c...7efb382)
70+
###### Diff: [`0539a3c...022aac9`](https://github.com/ChromeDevTools/devtools-protocol/compare/0539a3c...022aac9)
571

672
```diff
773
@@ domains/Browser.pdl:332 @@ domain Browser
@@ -43227,33 +43293,4 @@ index 4754f17c..8dad9c98 100644
4322743293
command enable
4322843294
parameters
4322943295
# Allows callers to disable the promise rejection delay that would
43230-
```
43231-
43232-
## Roll protocol to r1231134 — _2023-11-30T04:27:01.000Z_
43233-
###### Diff: [`2dcad56...92cb696`](https://github.com/ChromeDevTools/devtools-protocol/compare/2dcad56...92cb696)
43234-
43235-
```diff
43236-
@@ browser_protocol.pdl:7651 @@ domain Page
43237-
sync-xhr
43238-
unload
43239-
usb
43240-
+ usb-unrestricted
43241-
vertical-scroll
43242-
web-printing
43243-
web-share
43244-
@@ -11636,11 +11637,14 @@ experimental domain FedCm
43245-
AccountChooser
43246-
AutoReauthn
43247-
ConfirmIdpLogin
43248-
+ Error
43249-
43250-
# The buttons on the FedCM dialog.
43251-
type DialogButton extends string
43252-
enum
43253-
ConfirmIdpLoginContinue
43254-
+ ErrorGotIt
43255-
+ ErrorMoreDetails
43256-
43257-
# Corresponds to IdentityRequestAccount
43258-
type Account extends object
4325943296
```

‎json/browser_protocol.json‎

Lines changed: 44 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -688,6 +688,23 @@
688688
}
689689
}
690690
]
691+
},
692+
{
693+
"id": "AdScript",
694+
"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.",
695+
"type": "object",
696+
"properties": [
697+
{
698+
"name": "scriptId",
699+
"description": "The script ID.",
700+
"$ref": "Runtime.ScriptId"
701+
},
702+
{
703+
"name": "provenance",
704+
"description": "The ad provenance.",
705+
"$ref": "Network.AdProvenance"
706+
}
707+
]
691708
}
692709
],
693710
"commands": [
@@ -700,6 +717,19 @@
700717
"$ref": "AdMetrics"
701718
}
702719
]
720+
},
721+
{
722+
"name": "getAdScripts",
723+
"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).",
724+
"returns": [
725+
{
726+
"name": "newScripts",
727+
"type": "array",
728+
"items": {
729+
"$ref": "AdScript"
730+
}
731+
}
732+
]
703733
}
704734
]
705735
},
@@ -17632,7 +17662,7 @@
1763217662
},
1763317663
{
1763417664
"name": "adScriptAncestry",
17635-
"description": "The script ancestry that created the ad, if any.",
17665+
"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.",
1763617666
"optional": true,
1763717667
"$ref": "AdAncestry"
1763817668
}
@@ -24424,9 +24454,21 @@
2442424454
},
2442524455
{
2442624456
"name": "everyNthFrame",
24427-
"description": "Send every n-th frame.",
24457+
"description": "Send every n-th frame. Must be a positive integer.",
24458+
"optional": true,
24459+
"type": "integer"
24460+
},
24461+
{
24462+
"name": "maxFramesInFlight",
24463+
"description": "Maximum number of frames sent until screencastFrameAck is required.\nDefaults to 3. Must be a positive integer.",
2442824464
"optional": true,
2442924465
"type": "integer"
24466+
},
24467+
{
24468+
"name": "sendLastFrame",
24469+
"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.",
24470+
"optional": true,
24471+
"type": "boolean"
2443024472
}
2443124473
]
2443224474
},

‎package-lock.json‎

Lines changed: 2 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎package.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "devtools-protocol",
3-
"version": "0.0.1682007",
3+
"version": "0.0.1683682",
44
"description": "The Chrome DevTools Protocol JSON",
55
"repository": "https://github.com/ChromeDevTools/devtools-protocol",
66
"author": "The Chromium Authors",

‎pdl/domains/Ads.pdl‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -48,3 +48,23 @@ experimental domain Ads
4848
command getAdMetrics
4949
returns
5050
AdMetrics metrics
51+
52+
# An ad script.
53+
# Note: when the script is a transitive ad script, we only fill in the
54+
# immediate ancestor script in the provenance's adScriptAncestry field (as its
55+
# first entry), rather than filling in the full ancestry. This saves work for
56+
# the backend, and the frontend can reconstruct the full ancestry if
57+
# necessary.
58+
type AdScript extends object
59+
properties
60+
# The script ID.
61+
Runtime.ScriptId scriptId
62+
# The ad provenance.
63+
Network.AdProvenance provenance
64+
65+
# Retrieves ad scripts for the current page. To minimize payload size, this
66+
# only returns the newly tracked ad scripts since the last call to
67+
# getAdScripts (i.e., the delta).
68+
command getAdScripts
69+
returns
70+
array of AdScript newScripts

‎pdl/domains/Network.pdl‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1701,6 +1701,9 @@ domain Network
17011701
# The filterlist rule that matched, if any.
17021702
optional string filterlistRule
17031703
# The script ancestry that created the ad, if any.
1704+
# Note: depending on the context, this may represent the full ancestry up
1705+
# to the root script, or it may contain only one script representing the
1706+
# immediate ancestor.
17041707
optional AdAncestry adScriptAncestry
17051708

17061709
# Fired when additional information about a requestWillBeSent event is available from the

‎pdl/domains/Page.pdl‎

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1170,8 +1170,16 @@ domain Page
11701170
optional integer maxWidth
11711171
# Maximum screenshot height.
11721172
optional integer maxHeight
1173-
# Send every n-th frame.
1173+
# Send every n-th frame. Must be a positive integer.
11741174
optional integer everyNthFrame
1175+
# Maximum number of frames sent until screencastFrameAck is required.
1176+
# Defaults to 3. Must be a positive integer.
1177+
optional integer maxFramesInFlight
1178+
# By default, after screencastFrameAck arrives, the next produced frame is sent.
1179+
# Passing this flag enables storing the last produced frame in memory, which is
1180+
# immediately sent upon screencastFrameAck. This way, overall performance is
1181+
# traded for a better latency.
1182+
optional boolean sendLastFrame
11751183

11761184
# Starts screencast video recording.
11771185
experimental command startScreenRecording

‎types/protocol-mapping.d.ts‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1756,6 +1756,15 @@ export namespace ProtocolMapping {
17561756
paramsType: [];
17571757
returnType: Protocol.Ads.GetAdMetricsResponse;
17581758
};
1759+
/**
1760+
* Retrieves ad scripts for the current page. To minimize payload size, this
1761+
* only returns the newly tracked ad scripts since the last call to
1762+
* getAdScripts (i.e., the delta).
1763+
*/
1764+
'Ads.getAdScripts': {
1765+
paramsType: [];
1766+
returnType: Protocol.Ads.GetAdScriptsResponse;
1767+
};
17591768
/**
17601769
* Disables animation domain notifications.
17611770
*/

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

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -761,6 +761,13 @@ export namespace ProtocolProxyApi {
761761
*/
762762
getAdMetrics(): Promise<Protocol.Ads.GetAdMetricsResponse>;
763763

764+
/**
765+
* Retrieves ad scripts for the current page. To minimize payload size, this
766+
* only returns the newly tracked ad scripts since the last call to
767+
* getAdScripts (i.e., the delta).
768+
*/
769+
getAdScripts(): Promise<Protocol.Ads.GetAdScriptsResponse>;
770+
764771
}
765772

766773
export interface AnimationApi {

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

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -809,6 +809,13 @@ export namespace ProtocolTestsProxyApi {
809809
*/
810810
getAdMetrics(): Promise<{id: number, result: Protocol.Ads.GetAdMetricsResponse, sessionId: string}>;
811811

812+
/**
813+
* Retrieves ad scripts for the current page. To minimize payload size, this
814+
* only returns the newly tracked ad scripts since the last call to
815+
* getAdScripts (i.e., the delta).
816+
*/
817+
getAdScripts(): Promise<{id: number, result: Protocol.Ads.GetAdScriptsResponse, sessionId: string}>;
818+
812819
}
813820

814821
export interface AnimationApi {

0 commit comments

Comments
 (0)