devtools-protocol 0.0.1493946 → 0.0.1495869
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/json/browser_protocol.json +50 -1
- package/package.json +1 -1
- package/pdl/browser_protocol.pdl +24 -2
- package/types/protocol-mapping.d.ts +8 -2
- package/types/protocol-proxy-api.d.ts +356 -2
- package/types/protocol-tests-proxy-api.d.ts +356 -2
- package/types/protocol.d.ts +870 -93
@@ -176,6 +176,9 @@ export namespace ProtocolProxyApi {
|
|
176
176
|
*/
|
177
177
|
getScriptSource(params: Protocol.Debugger.GetScriptSourceRequest): Promise<Protocol.Debugger.GetScriptSourceResponse>;
|
178
178
|
|
179
|
+
/**
|
180
|
+
* @experimental
|
181
|
+
*/
|
179
182
|
disassembleWasmModule(params: Protocol.Debugger.DisassembleWasmModuleRequest): Promise<Protocol.Debugger.DisassembleWasmModuleResponse>;
|
180
183
|
|
181
184
|
/**
|
@@ -183,16 +186,19 @@ export namespace ProtocolProxyApi {
|
|
183
186
|
* stream. If disassembly is complete, this API will invalidate the streamId
|
184
187
|
* and return an empty chunk. Any subsequent calls for the now invalid stream
|
185
188
|
* will return errors.
|
189
|
+
* @experimental
|
186
190
|
*/
|
187
191
|
nextWasmDisassemblyChunk(params: Protocol.Debugger.NextWasmDisassemblyChunkRequest): Promise<Protocol.Debugger.NextWasmDisassemblyChunkResponse>;
|
188
192
|
|
189
193
|
/**
|
190
194
|
* This command is deprecated. Use getScriptSource instead.
|
195
|
+
* @deprecated
|
191
196
|
*/
|
192
197
|
getWasmBytecode(params: Protocol.Debugger.GetWasmBytecodeRequest): Promise<Protocol.Debugger.GetWasmBytecodeResponse>;
|
193
198
|
|
194
199
|
/**
|
195
200
|
* Returns stack trace with given `stackTraceId`.
|
201
|
+
* @experimental
|
196
202
|
*/
|
197
203
|
getStackTrace(params: Protocol.Debugger.GetStackTraceRequest): Promise<Protocol.Debugger.GetStackTraceResponse>;
|
198
204
|
|
@@ -201,6 +207,10 @@ export namespace ProtocolProxyApi {
|
|
201
207
|
*/
|
202
208
|
pause(): Promise<void>;
|
203
209
|
|
210
|
+
/**
|
211
|
+
* @deprecated
|
212
|
+
* @experimental
|
213
|
+
*/
|
204
214
|
pauseOnAsyncCall(params: Protocol.Debugger.PauseOnAsyncCallRequest): Promise<void>;
|
205
215
|
|
206
216
|
/**
|
@@ -244,6 +254,7 @@ export namespace ProtocolProxyApi {
|
|
244
254
|
* Replace previous blackbox execution contexts with passed ones. Forces backend to skip
|
245
255
|
* stepping/pausing in scripts in these execution contexts. VM will try to leave blackboxed script by
|
246
256
|
* performing 'step in' several times, finally resorting to 'step out' if unsuccessful.
|
257
|
+
* @experimental
|
247
258
|
*/
|
248
259
|
setBlackboxExecutionContexts(params: Protocol.Debugger.SetBlackboxExecutionContextsRequest): Promise<void>;
|
249
260
|
|
@@ -251,6 +262,7 @@ export namespace ProtocolProxyApi {
|
|
251
262
|
* Replace previous blackbox patterns with passed ones. Forces backend to skip stepping/pausing in
|
252
263
|
* scripts with url matching one of the patterns. VM will try to leave blackboxed script by
|
253
264
|
* performing 'step in' several times, finally resorting to 'step out' if unsuccessful.
|
265
|
+
* @experimental
|
254
266
|
*/
|
255
267
|
setBlackboxPatterns(params: Protocol.Debugger.SetBlackboxPatternsRequest): Promise<void>;
|
256
268
|
|
@@ -259,6 +271,7 @@ export namespace ProtocolProxyApi {
|
|
259
271
|
* scripts by performing 'step in' several times, finally resorting to 'step out' if unsuccessful.
|
260
272
|
* Positions array contains positions where blackbox state is changed. First interval isn't
|
261
273
|
* blackboxed. Array should be sorted.
|
274
|
+
* @experimental
|
262
275
|
*/
|
263
276
|
setBlackboxedRanges(params: Protocol.Debugger.SetBlackboxedRangesRequest): Promise<void>;
|
264
277
|
|
@@ -284,6 +297,7 @@ export namespace ProtocolProxyApi {
|
|
284
297
|
* Sets JavaScript breakpoint before each call to the given function.
|
285
298
|
* If another function was created from the same source as a given one,
|
286
299
|
* calling it will also trigger the breakpoint.
|
300
|
+
* @experimental
|
287
301
|
*/
|
288
302
|
setBreakpointOnFunctionCall(params: Protocol.Debugger.SetBreakpointOnFunctionCallRequest): Promise<Protocol.Debugger.SetBreakpointOnFunctionCallResponse>;
|
289
303
|
|
@@ -300,6 +314,7 @@ export namespace ProtocolProxyApi {
|
|
300
314
|
|
301
315
|
/**
|
302
316
|
* Changes return value in top frame. Available only at return break position.
|
317
|
+
* @experimental
|
303
318
|
*/
|
304
319
|
setReturnValue(params: Protocol.Debugger.SetReturnValueRequest): Promise<void>;
|
305
320
|
|
@@ -343,6 +358,7 @@ export namespace ProtocolProxyApi {
|
|
343
358
|
/**
|
344
359
|
* Fired when breakpoint is resolved to an actual script and location.
|
345
360
|
* Deprecated in favor of `resolvedBreakpoints` in the `scriptParsed` event.
|
361
|
+
* @deprecated
|
346
362
|
*/
|
347
363
|
on(event: 'breakpointResolved', listener: (params: Protocol.Debugger.BreakpointResolvedEvent) => void): void;
|
348
364
|
|
@@ -469,6 +485,7 @@ export namespace ProtocolProxyApi {
|
|
469
485
|
* `takePreciseCoverage` for the current isolate. May only be sent if precise code
|
470
486
|
* coverage has been started. This event can be trigged by the embedder to, for example,
|
471
487
|
* trigger collection of coverage data immediately at a certain point in time.
|
488
|
+
* @experimental
|
472
489
|
*/
|
473
490
|
on(event: 'preciseCoverageDeltaUpdate', listener: (params: Protocol.Profiler.PreciseCoverageDeltaUpdateEvent) => void): void;
|
474
491
|
|
@@ -515,12 +532,14 @@ export namespace ProtocolProxyApi {
|
|
515
532
|
|
516
533
|
/**
|
517
534
|
* Returns the isolate id.
|
535
|
+
* @experimental
|
518
536
|
*/
|
519
537
|
getIsolateId(): Promise<Protocol.Runtime.GetIsolateIdResponse>;
|
520
538
|
|
521
539
|
/**
|
522
540
|
* Returns the JavaScript heap usage.
|
523
541
|
* It is the total usage of the corresponding isolate not scoped to a particular Runtime.
|
542
|
+
* @experimental
|
524
543
|
*/
|
525
544
|
getHeapUsage(): Promise<Protocol.Runtime.GetHeapUsageResponse>;
|
526
545
|
|
@@ -562,13 +581,20 @@ export namespace ProtocolProxyApi {
|
|
562
581
|
*/
|
563
582
|
setAsyncCallStackDepth(params: Protocol.Runtime.SetAsyncCallStackDepthRequest): Promise<void>;
|
564
583
|
|
584
|
+
/**
|
585
|
+
* @experimental
|
586
|
+
*/
|
565
587
|
setCustomObjectFormatterEnabled(params: Protocol.Runtime.SetCustomObjectFormatterEnabledRequest): Promise<void>;
|
566
588
|
|
589
|
+
/**
|
590
|
+
* @experimental
|
591
|
+
*/
|
567
592
|
setMaxCallStackSizeToCapture(params: Protocol.Runtime.SetMaxCallStackSizeToCaptureRequest): Promise<void>;
|
568
593
|
|
569
594
|
/**
|
570
595
|
* Terminate current or next JavaScript execution.
|
571
596
|
* Will cancel the termination when the outer-most script execution ends.
|
597
|
+
* @experimental
|
572
598
|
*/
|
573
599
|
terminateExecution(): Promise<void>;
|
574
600
|
|
@@ -594,11 +620,13 @@ export namespace ProtocolProxyApi {
|
|
594
620
|
* Note that the stackTrace portion of the resulting exceptionDetails will
|
595
621
|
* only be populated if the Runtime domain was enabled at the time when the
|
596
622
|
* Error was thrown.
|
623
|
+
* @experimental
|
597
624
|
*/
|
598
625
|
getExceptionDetails(params: Protocol.Runtime.GetExceptionDetailsRequest): Promise<Protocol.Runtime.GetExceptionDetailsResponse>;
|
599
626
|
|
600
627
|
/**
|
601
628
|
* Notification is issued every time when binding is called.
|
629
|
+
* @experimental
|
602
630
|
*/
|
603
631
|
on(event: 'bindingCalled', listener: (params: Protocol.Runtime.BindingCalledEvent) => void): void;
|
604
632
|
|
@@ -662,29 +690,34 @@ export namespace ProtocolProxyApi {
|
|
662
690
|
|
663
691
|
/**
|
664
692
|
* Fetches the accessibility node and partial accessibility tree for this DOM node, if it exists.
|
693
|
+
* @experimental
|
665
694
|
*/
|
666
695
|
getPartialAXTree(params: Protocol.Accessibility.GetPartialAXTreeRequest): Promise<Protocol.Accessibility.GetPartialAXTreeResponse>;
|
667
696
|
|
668
697
|
/**
|
669
698
|
* Fetches the entire accessibility tree for the root Document
|
699
|
+
* @experimental
|
670
700
|
*/
|
671
701
|
getFullAXTree(params: Protocol.Accessibility.GetFullAXTreeRequest): Promise<Protocol.Accessibility.GetFullAXTreeResponse>;
|
672
702
|
|
673
703
|
/**
|
674
704
|
* Fetches the root node.
|
675
705
|
* Requires `enable()` to have been called previously.
|
706
|
+
* @experimental
|
676
707
|
*/
|
677
708
|
getRootAXNode(params: Protocol.Accessibility.GetRootAXNodeRequest): Promise<Protocol.Accessibility.GetRootAXNodeResponse>;
|
678
709
|
|
679
710
|
/**
|
680
711
|
* Fetches a node and all ancestors up to and including the root.
|
681
712
|
* Requires `enable()` to have been called previously.
|
713
|
+
* @experimental
|
682
714
|
*/
|
683
715
|
getAXNodeAndAncestors(params: Protocol.Accessibility.GetAXNodeAndAncestorsRequest): Promise<Protocol.Accessibility.GetAXNodeAndAncestorsResponse>;
|
684
716
|
|
685
717
|
/**
|
686
718
|
* Fetches a particular accessibility node by AXNodeId.
|
687
719
|
* Requires `enable()` to have been called previously.
|
720
|
+
* @experimental
|
688
721
|
*/
|
689
722
|
getChildAXNodes(params: Protocol.Accessibility.GetChildAXNodesRequest): Promise<Protocol.Accessibility.GetChildAXNodesResponse>;
|
690
723
|
|
@@ -694,17 +727,20 @@ export namespace ProtocolProxyApi {
|
|
694
727
|
* ignored for accessibility, and returns those that match the specified name and role. If no DOM
|
695
728
|
* node is specified, or the DOM node does not exist, the command returns an error. If neither
|
696
729
|
* `accessibleName` or `role` is specified, it returns all the accessibility nodes in the subtree.
|
730
|
+
* @experimental
|
697
731
|
*/
|
698
732
|
queryAXTree(params: Protocol.Accessibility.QueryAXTreeRequest): Promise<Protocol.Accessibility.QueryAXTreeResponse>;
|
699
733
|
|
700
734
|
/**
|
701
735
|
* The loadComplete event mirrors the load complete event sent by the browser to assistive
|
702
736
|
* technology when the web page has finished loading.
|
737
|
+
* @experimental
|
703
738
|
*/
|
704
739
|
on(event: 'loadComplete', listener: (params: Protocol.Accessibility.LoadCompleteEvent) => void): void;
|
705
740
|
|
706
741
|
/**
|
707
742
|
* The nodesUpdated event is sent every time a previously requested node has changed the in tree.
|
743
|
+
* @experimental
|
708
744
|
*/
|
709
745
|
on(event: 'nodesUpdated', listener: (params: Protocol.Accessibility.NodesUpdatedEvent) => void): void;
|
710
746
|
|
@@ -924,11 +960,13 @@ export namespace ProtocolProxyApi {
|
|
924
960
|
export interface BrowserApi {
|
925
961
|
/**
|
926
962
|
* Set permission settings for given origin.
|
963
|
+
* @experimental
|
927
964
|
*/
|
928
965
|
setPermission(params: Protocol.Browser.SetPermissionRequest): Promise<void>;
|
929
966
|
|
930
967
|
/**
|
931
968
|
* Grant specific permissions to the given origin and reject all others.
|
969
|
+
* @experimental
|
932
970
|
*/
|
933
971
|
grantPermissions(params: Protocol.Browser.GrantPermissionsRequest): Promise<void>;
|
934
972
|
|
@@ -939,11 +977,13 @@ export namespace ProtocolProxyApi {
|
|
939
977
|
|
940
978
|
/**
|
941
979
|
* Set the behavior when downloading a file.
|
980
|
+
* @experimental
|
942
981
|
*/
|
943
982
|
setDownloadBehavior(params: Protocol.Browser.SetDownloadBehaviorRequest): Promise<void>;
|
944
983
|
|
945
984
|
/**
|
946
985
|
* Cancel a download if in progress
|
986
|
+
* @experimental
|
947
987
|
*/
|
948
988
|
cancelDownload(params: Protocol.Browser.CancelDownloadRequest): Promise<void>;
|
949
989
|
|
@@ -954,11 +994,13 @@ export namespace ProtocolProxyApi {
|
|
954
994
|
|
955
995
|
/**
|
956
996
|
* Crashes browser on the main thread.
|
997
|
+
* @experimental
|
957
998
|
*/
|
958
999
|
crash(): Promise<void>;
|
959
1000
|
|
960
1001
|
/**
|
961
1002
|
* Crashes GPU process.
|
1003
|
+
* @experimental
|
962
1004
|
*/
|
963
1005
|
crashGpuProcess(): Promise<void>;
|
964
1006
|
|
@@ -970,46 +1012,55 @@ export namespace ProtocolProxyApi {
|
|
970
1012
|
/**
|
971
1013
|
* Returns the command line switches for the browser process if, and only if
|
972
1014
|
* --enable-automation is on the commandline.
|
1015
|
+
* @experimental
|
973
1016
|
*/
|
974
1017
|
getBrowserCommandLine(): Promise<Protocol.Browser.GetBrowserCommandLineResponse>;
|
975
1018
|
|
976
1019
|
/**
|
977
1020
|
* Get Chrome histograms.
|
1021
|
+
* @experimental
|
978
1022
|
*/
|
979
1023
|
getHistograms(params: Protocol.Browser.GetHistogramsRequest): Promise<Protocol.Browser.GetHistogramsResponse>;
|
980
1024
|
|
981
1025
|
/**
|
982
1026
|
* Get a Chrome histogram by name.
|
1027
|
+
* @experimental
|
983
1028
|
*/
|
984
1029
|
getHistogram(params: Protocol.Browser.GetHistogramRequest): Promise<Protocol.Browser.GetHistogramResponse>;
|
985
1030
|
|
986
1031
|
/**
|
987
1032
|
* Get position and size of the browser window.
|
1033
|
+
* @experimental
|
988
1034
|
*/
|
989
1035
|
getWindowBounds(params: Protocol.Browser.GetWindowBoundsRequest): Promise<Protocol.Browser.GetWindowBoundsResponse>;
|
990
1036
|
|
991
1037
|
/**
|
992
1038
|
* Get the browser window that contains the devtools target.
|
1039
|
+
* @experimental
|
993
1040
|
*/
|
994
1041
|
getWindowForTarget(params: Protocol.Browser.GetWindowForTargetRequest): Promise<Protocol.Browser.GetWindowForTargetResponse>;
|
995
1042
|
|
996
1043
|
/**
|
997
1044
|
* Set position and/or size of the browser window.
|
1045
|
+
* @experimental
|
998
1046
|
*/
|
999
1047
|
setWindowBounds(params: Protocol.Browser.SetWindowBoundsRequest): Promise<void>;
|
1000
1048
|
|
1001
1049
|
/**
|
1002
1050
|
* Set size of the browser contents resizing browser window as necessary.
|
1051
|
+
* @experimental
|
1003
1052
|
*/
|
1004
1053
|
setContentsSize(params: Protocol.Browser.SetContentsSizeRequest): Promise<void>;
|
1005
1054
|
|
1006
1055
|
/**
|
1007
1056
|
* Set dock tile details, platform-specific.
|
1057
|
+
* @experimental
|
1008
1058
|
*/
|
1009
1059
|
setDockTile(params: Protocol.Browser.SetDockTileRequest): Promise<void>;
|
1010
1060
|
|
1011
1061
|
/**
|
1012
1062
|
* Invoke custom browser commands used by telemetry.
|
1063
|
+
* @experimental
|
1013
1064
|
*/
|
1014
1065
|
executeBrowserCommand(params: Protocol.Browser.ExecuteBrowserCommandRequest): Promise<void>;
|
1015
1066
|
|
@@ -1029,11 +1080,13 @@ export namespace ProtocolProxyApi {
|
|
1029
1080
|
|
1030
1081
|
/**
|
1031
1082
|
* Fired when page is about to start a download.
|
1083
|
+
* @experimental
|
1032
1084
|
*/
|
1033
1085
|
on(event: 'downloadWillBegin', listener: (params: Protocol.Browser.DownloadWillBeginEvent) => void): void;
|
1034
1086
|
|
1035
1087
|
/**
|
1036
1088
|
* Fired when download makes progress. Last call has |done| == true.
|
1089
|
+
* @experimental
|
1037
1090
|
*/
|
1038
1091
|
on(event: 'downloadProgress', listener: (params: Protocol.Browser.DownloadProgressEvent) => void): void;
|
1039
1092
|
|
@@ -1095,9 +1148,13 @@ export namespace ProtocolProxyApi {
|
|
1095
1148
|
* to the provided property syntax, the value is parsed using combined
|
1096
1149
|
* syntax as if null `propertyName` was provided. If the value cannot be
|
1097
1150
|
* resolved even then, return the provided value without any changes.
|
1151
|
+
* @experimental
|
1098
1152
|
*/
|
1099
1153
|
resolveValues(params: Protocol.CSS.ResolveValuesRequest): Promise<Protocol.CSS.ResolveValuesResponse>;
|
1100
1154
|
|
1155
|
+
/**
|
1156
|
+
* @experimental
|
1157
|
+
*/
|
1101
1158
|
getLonghandProperties(params: Protocol.CSS.GetLonghandPropertiesRequest): Promise<Protocol.CSS.GetLonghandPropertiesResponse>;
|
1102
1159
|
|
1103
1160
|
/**
|
@@ -1109,6 +1166,7 @@ export namespace ProtocolProxyApi {
|
|
1109
1166
|
/**
|
1110
1167
|
* Returns the styles coming from animations & transitions
|
1111
1168
|
* including the animation & transition styles coming from inheritance chain.
|
1169
|
+
* @experimental
|
1112
1170
|
*/
|
1113
1171
|
getAnimatedStylesForNode(params: Protocol.CSS.GetAnimatedStylesForNodeRequest): Promise<Protocol.CSS.GetAnimatedStylesForNodeResponse>;
|
1114
1172
|
|
@@ -1119,6 +1177,7 @@ export namespace ProtocolProxyApi {
|
|
1119
1177
|
|
1120
1178
|
/**
|
1121
1179
|
* Returns the values of the default UA-defined environment variables used in env()
|
1180
|
+
* @experimental
|
1122
1181
|
*/
|
1123
1182
|
getEnvironmentVariables(): Promise<Protocol.CSS.GetEnvironmentVariablesResponse>;
|
1124
1183
|
|
@@ -1143,12 +1202,14 @@ export namespace ProtocolProxyApi {
|
|
1143
1202
|
* Given a DOM element identified by nodeId, getLayersForNode returns the root
|
1144
1203
|
* layer for the nearest ancestor document or shadow root. The layer root contains
|
1145
1204
|
* the full layer tree for the tree scope and their ordering.
|
1205
|
+
* @experimental
|
1146
1206
|
*/
|
1147
1207
|
getLayersForNode(params: Protocol.CSS.GetLayersForNodeRequest): Promise<Protocol.CSS.GetLayersForNodeResponse>;
|
1148
1208
|
|
1149
1209
|
/**
|
1150
1210
|
* Given a CSS selector text and a style sheet ID, getLocationForSelector
|
1151
1211
|
* returns an array of locations of the CSS selector in the style sheet.
|
1212
|
+
* @experimental
|
1152
1213
|
*/
|
1153
1214
|
getLocationForSelector(params: Protocol.CSS.GetLocationForSelectorRequest): Promise<Protocol.CSS.GetLocationForSelectorResponse>;
|
1154
1215
|
|
@@ -1159,6 +1220,7 @@ export namespace ProtocolProxyApi {
|
|
1159
1220
|
* There can only be 1 node tracked for computed style updates
|
1160
1221
|
* so passing a new node id removes tracking from the previous node.
|
1161
1222
|
* Pass `undefined` to disable tracking.
|
1223
|
+
* @experimental
|
1162
1224
|
*/
|
1163
1225
|
trackComputedStyleUpdatesForNode(params: Protocol.CSS.TrackComputedStyleUpdatesForNodeRequest): Promise<void>;
|
1164
1226
|
|
@@ -1169,11 +1231,13 @@ export namespace ProtocolProxyApi {
|
|
1169
1231
|
* The changes to computed style properties are only tracked for nodes pushed to the front-end
|
1170
1232
|
* by the DOM agent. If no changes to the tracked properties occur after the node has been pushed
|
1171
1233
|
* to the front-end, no updates will be issued for the node.
|
1234
|
+
* @experimental
|
1172
1235
|
*/
|
1173
1236
|
trackComputedStyleUpdates(params: Protocol.CSS.TrackComputedStyleUpdatesRequest): Promise<void>;
|
1174
1237
|
|
1175
1238
|
/**
|
1176
1239
|
* Polls the next batch of computed style updates.
|
1240
|
+
* @experimental
|
1177
1241
|
*/
|
1178
1242
|
takeComputedStyleUpdates(): Promise<Protocol.CSS.TakeComputedStyleUpdatesResponse>;
|
1179
1243
|
|
@@ -1200,16 +1264,19 @@ export namespace ProtocolProxyApi {
|
|
1200
1264
|
|
1201
1265
|
/**
|
1202
1266
|
* Modifies the expression of a container query.
|
1267
|
+
* @experimental
|
1203
1268
|
*/
|
1204
1269
|
setContainerQueryText(params: Protocol.CSS.SetContainerQueryTextRequest): Promise<Protocol.CSS.SetContainerQueryTextResponse>;
|
1205
1270
|
|
1206
1271
|
/**
|
1207
1272
|
* Modifies the expression of a supports at-rule.
|
1273
|
+
* @experimental
|
1208
1274
|
*/
|
1209
1275
|
setSupportsText(params: Protocol.CSS.SetSupportsTextRequest): Promise<Protocol.CSS.SetSupportsTextResponse>;
|
1210
1276
|
|
1211
1277
|
/**
|
1212
1278
|
* Modifies the expression of a scope at-rule.
|
1279
|
+
* @experimental
|
1213
1280
|
*/
|
1214
1281
|
setScopeText(params: Protocol.CSS.SetScopeTextRequest): Promise<Protocol.CSS.SetScopeTextResponse>;
|
1215
1282
|
|
@@ -1247,6 +1314,7 @@ export namespace ProtocolProxyApi {
|
|
1247
1314
|
|
1248
1315
|
/**
|
1249
1316
|
* Enables/disables rendering of local CSS fonts (enabled by default).
|
1317
|
+
* @experimental
|
1250
1318
|
*/
|
1251
1319
|
setLocalFontsEnabled(params: Protocol.CSS.SetLocalFontsEnabledRequest): Promise<void>;
|
1252
1320
|
|
@@ -1277,6 +1345,9 @@ export namespace ProtocolProxyApi {
|
|
1277
1345
|
*/
|
1278
1346
|
on(event: 'styleSheetRemoved', listener: (params: Protocol.CSS.StyleSheetRemovedEvent) => void): void;
|
1279
1347
|
|
1348
|
+
/**
|
1349
|
+
* @experimental
|
1350
|
+
*/
|
1280
1351
|
on(event: 'computedStyleUpdated', listener: (params: Protocol.CSS.ComputedStyleUpdatedEvent) => void): void;
|
1281
1352
|
|
1282
1353
|
}
|
@@ -1362,12 +1433,14 @@ export namespace ProtocolProxyApi {
|
|
1362
1433
|
export interface DOMApi {
|
1363
1434
|
/**
|
1364
1435
|
* Collects class names for the node with given id and all of it's child nodes.
|
1436
|
+
* @experimental
|
1365
1437
|
*/
|
1366
1438
|
collectClassNamesFromSubtree(params: Protocol.DOM.CollectClassNamesFromSubtreeRequest): Promise<Protocol.DOM.CollectClassNamesFromSubtreeResponse>;
|
1367
1439
|
|
1368
1440
|
/**
|
1369
1441
|
* Creates a deep copy of the specified node and places it into the target container before the
|
1370
1442
|
* given anchor.
|
1443
|
+
* @experimental
|
1371
1444
|
*/
|
1372
1445
|
copyTo(params: Protocol.DOM.CopyToRequest): Promise<Protocol.DOM.CopyToResponse>;
|
1373
1446
|
|
@@ -1392,6 +1465,7 @@ export namespace ProtocolProxyApi {
|
|
1392
1465
|
/**
|
1393
1466
|
* Discards search results from the session with the given id. `getSearchResults` should no longer
|
1394
1467
|
* be called for that search.
|
1468
|
+
* @experimental
|
1395
1469
|
*/
|
1396
1470
|
discardSearchResults(params: Protocol.DOM.DiscardSearchResultsRequest): Promise<void>;
|
1397
1471
|
|
@@ -1418,6 +1492,7 @@ export namespace ProtocolProxyApi {
|
|
1418
1492
|
/**
|
1419
1493
|
* Returns quads that describe node position on the page. This method
|
1420
1494
|
* might return multiple quads for inline nodes.
|
1495
|
+
* @experimental
|
1421
1496
|
*/
|
1422
1497
|
getContentQuads(params: Protocol.DOM.GetContentQuadsRequest): Promise<Protocol.DOM.GetContentQuadsResponse>;
|
1423
1498
|
|
@@ -1431,11 +1506,13 @@ export namespace ProtocolProxyApi {
|
|
1431
1506
|
* Returns the root DOM node (and optionally the subtree) to the caller.
|
1432
1507
|
* Deprecated, as it is not designed to work well with the rest of the DOM agent.
|
1433
1508
|
* Use DOMSnapshot.captureSnapshot instead.
|
1509
|
+
* @deprecated
|
1434
1510
|
*/
|
1435
1511
|
getFlattenedDocument(params: Protocol.DOM.GetFlattenedDocumentRequest): Promise<Protocol.DOM.GetFlattenedDocumentResponse>;
|
1436
1512
|
|
1437
1513
|
/**
|
1438
1514
|
* Finds nodes with a given computed style in a subtree.
|
1515
|
+
* @experimental
|
1439
1516
|
*/
|
1440
1517
|
getNodesForSubtreeByStyle(params: Protocol.DOM.GetNodesForSubtreeByStyleRequest): Promise<Protocol.DOM.GetNodesForSubtreeByStyleResponse>;
|
1441
1518
|
|
@@ -1452,12 +1529,14 @@ export namespace ProtocolProxyApi {
|
|
1452
1529
|
|
1453
1530
|
/**
|
1454
1531
|
* Returns the id of the nearest ancestor that is a relayout boundary.
|
1532
|
+
* @experimental
|
1455
1533
|
*/
|
1456
1534
|
getRelayoutBoundary(params: Protocol.DOM.GetRelayoutBoundaryRequest): Promise<Protocol.DOM.GetRelayoutBoundaryResponse>;
|
1457
1535
|
|
1458
1536
|
/**
|
1459
1537
|
* Returns search results from given `fromIndex` to given `toIndex` from the search with the given
|
1460
1538
|
* identifier.
|
1539
|
+
* @experimental
|
1461
1540
|
*/
|
1462
1541
|
getSearchResults(params: Protocol.DOM.GetSearchResultsRequest): Promise<Protocol.DOM.GetSearchResultsResponse>;
|
1463
1542
|
|
@@ -1478,6 +1557,7 @@ export namespace ProtocolProxyApi {
|
|
1478
1557
|
|
1479
1558
|
/**
|
1480
1559
|
* Marks last undoable state.
|
1560
|
+
* @experimental
|
1481
1561
|
*/
|
1482
1562
|
markUndoableState(): Promise<void>;
|
1483
1563
|
|
@@ -1489,16 +1569,19 @@ export namespace ProtocolProxyApi {
|
|
1489
1569
|
/**
|
1490
1570
|
* Searches for a given string in the DOM tree. Use `getSearchResults` to access search results or
|
1491
1571
|
* `cancelSearch` to end this search session.
|
1572
|
+
* @experimental
|
1492
1573
|
*/
|
1493
1574
|
performSearch(params: Protocol.DOM.PerformSearchRequest): Promise<Protocol.DOM.PerformSearchResponse>;
|
1494
1575
|
|
1495
1576
|
/**
|
1496
1577
|
* Requests that the node is sent to the caller given its path. // FIXME, use XPath
|
1578
|
+
* @experimental
|
1497
1579
|
*/
|
1498
1580
|
pushNodeByPathToFrontend(params: Protocol.DOM.PushNodeByPathToFrontendRequest): Promise<Protocol.DOM.PushNodeByPathToFrontendResponse>;
|
1499
1581
|
|
1500
1582
|
/**
|
1501
1583
|
* Requests that a batch of nodes is sent to the caller given their backend node ids.
|
1584
|
+
* @experimental
|
1502
1585
|
*/
|
1503
1586
|
pushNodesByBackendIdsToFrontend(params: Protocol.DOM.PushNodesByBackendIdsToFrontendRequest): Promise<Protocol.DOM.PushNodesByBackendIdsToFrontendResponse>;
|
1504
1587
|
|
@@ -1516,16 +1599,19 @@ export namespace ProtocolProxyApi {
|
|
1516
1599
|
* Returns NodeIds of current top layer elements.
|
1517
1600
|
* Top layer is rendered closest to the user within a viewport, therefore its elements always
|
1518
1601
|
* appear on top of all other content.
|
1602
|
+
* @experimental
|
1519
1603
|
*/
|
1520
1604
|
getTopLayerElements(): Promise<Protocol.DOM.GetTopLayerElementsResponse>;
|
1521
1605
|
|
1522
1606
|
/**
|
1523
1607
|
* Returns the NodeId of the matched element according to certain relations.
|
1608
|
+
* @experimental
|
1524
1609
|
*/
|
1525
1610
|
getElementByRelation(params: Protocol.DOM.GetElementByRelationRequest): Promise<Protocol.DOM.GetElementByRelationResponse>;
|
1526
1611
|
|
1527
1612
|
/**
|
1528
1613
|
* Re-does the last undone action.
|
1614
|
+
* @experimental
|
1529
1615
|
*/
|
1530
1616
|
redo(): Promise<void>;
|
1531
1617
|
|
@@ -1576,28 +1662,33 @@ export namespace ProtocolProxyApi {
|
|
1576
1662
|
|
1577
1663
|
/**
|
1578
1664
|
* Sets if stack traces should be captured for Nodes. See `Node.getNodeStackTraces`. Default is disabled.
|
1665
|
+
* @experimental
|
1579
1666
|
*/
|
1580
1667
|
setNodeStackTracesEnabled(params: Protocol.DOM.SetNodeStackTracesEnabledRequest): Promise<void>;
|
1581
1668
|
|
1582
1669
|
/**
|
1583
1670
|
* Gets stack traces associated with a Node. As of now, only provides stack trace for Node creation.
|
1671
|
+
* @experimental
|
1584
1672
|
*/
|
1585
1673
|
getNodeStackTraces(params: Protocol.DOM.GetNodeStackTracesRequest): Promise<Protocol.DOM.GetNodeStackTracesResponse>;
|
1586
1674
|
|
1587
1675
|
/**
|
1588
1676
|
* Returns file information for the given
|
1589
1677
|
* File wrapper.
|
1678
|
+
* @experimental
|
1590
1679
|
*/
|
1591
1680
|
getFileInfo(params: Protocol.DOM.GetFileInfoRequest): Promise<Protocol.DOM.GetFileInfoResponse>;
|
1592
1681
|
|
1593
1682
|
/**
|
1594
1683
|
* Returns list of detached nodes
|
1684
|
+
* @experimental
|
1595
1685
|
*/
|
1596
1686
|
getDetachedDomNodes(): Promise<Protocol.DOM.GetDetachedDomNodesResponse>;
|
1597
1687
|
|
1598
1688
|
/**
|
1599
1689
|
* Enables console to refer to the node with given id via $x (see Command Line API for more details
|
1600
1690
|
* $x functions).
|
1691
|
+
* @experimental
|
1601
1692
|
*/
|
1602
1693
|
setInspectedNode(params: Protocol.DOM.SetInspectedNodeRequest): Promise<void>;
|
1603
1694
|
|
@@ -1618,11 +1709,13 @@ export namespace ProtocolProxyApi {
|
|
1618
1709
|
|
1619
1710
|
/**
|
1620
1711
|
* Undoes the last performed action.
|
1712
|
+
* @experimental
|
1621
1713
|
*/
|
1622
1714
|
undo(): Promise<void>;
|
1623
1715
|
|
1624
1716
|
/**
|
1625
1717
|
* Returns iframe node that owns iframe with the given domain.
|
1718
|
+
* @experimental
|
1626
1719
|
*/
|
1627
1720
|
getFrameOwner(params: Protocol.DOM.GetFrameOwnerRequest): Promise<Protocol.DOM.GetFrameOwnerResponse>;
|
1628
1721
|
|
@@ -1632,24 +1725,28 @@ export namespace ProtocolProxyApi {
|
|
1632
1725
|
* scroll-state or anchored elements. If no axes are provided and
|
1633
1726
|
* queriesScrollState is false, the style container is returned, which is the
|
1634
1727
|
* direct parent or the closest element with a matching container-name.
|
1728
|
+
* @experimental
|
1635
1729
|
*/
|
1636
1730
|
getContainerForNode(params: Protocol.DOM.GetContainerForNodeRequest): Promise<Protocol.DOM.GetContainerForNodeResponse>;
|
1637
1731
|
|
1638
1732
|
/**
|
1639
1733
|
* Returns the descendants of a container query container that have
|
1640
1734
|
* container queries against this container.
|
1735
|
+
* @experimental
|
1641
1736
|
*/
|
1642
1737
|
getQueryingDescendantsForContainer(params: Protocol.DOM.GetQueryingDescendantsForContainerRequest): Promise<Protocol.DOM.GetQueryingDescendantsForContainerResponse>;
|
1643
1738
|
|
1644
1739
|
/**
|
1645
1740
|
* Returns the target anchor element of the given anchor query according to
|
1646
1741
|
* https://www.w3.org/TR/css-anchor-position-1/#target.
|
1742
|
+
* @experimental
|
1647
1743
|
*/
|
1648
1744
|
getAnchorElement(params: Protocol.DOM.GetAnchorElementRequest): Promise<Protocol.DOM.GetAnchorElementResponse>;
|
1649
1745
|
|
1650
1746
|
/**
|
1651
1747
|
* When enabling, this API force-opens the popover identified by nodeId
|
1652
1748
|
* and keeps it open until disabled.
|
1749
|
+
* @experimental
|
1653
1750
|
*/
|
1654
1751
|
forceShowPopover(params: Protocol.DOM.ForceShowPopoverRequest): Promise<Protocol.DOM.ForceShowPopoverResponse>;
|
1655
1752
|
|
@@ -1685,6 +1782,7 @@ export namespace ProtocolProxyApi {
|
|
1685
1782
|
|
1686
1783
|
/**
|
1687
1784
|
* Called when distribution is changed.
|
1785
|
+
* @experimental
|
1688
1786
|
*/
|
1689
1787
|
on(event: 'distributedNodesUpdated', listener: (params: Protocol.DOM.DistributedNodesUpdatedEvent) => void): void;
|
1690
1788
|
|
@@ -1695,26 +1793,31 @@ export namespace ProtocolProxyApi {
|
|
1695
1793
|
|
1696
1794
|
/**
|
1697
1795
|
* Fired when `Element`'s inline style is modified via a CSS property modification.
|
1796
|
+
* @experimental
|
1698
1797
|
*/
|
1699
1798
|
on(event: 'inlineStyleInvalidated', listener: (params: Protocol.DOM.InlineStyleInvalidatedEvent) => void): void;
|
1700
1799
|
|
1701
1800
|
/**
|
1702
1801
|
* Called when a pseudo element is added to an element.
|
1802
|
+
* @experimental
|
1703
1803
|
*/
|
1704
1804
|
on(event: 'pseudoElementAdded', listener: (params: Protocol.DOM.PseudoElementAddedEvent) => void): void;
|
1705
1805
|
|
1706
1806
|
/**
|
1707
1807
|
* Called when top layer elements are changed.
|
1808
|
+
* @experimental
|
1708
1809
|
*/
|
1709
1810
|
on(event: 'topLayerElementsUpdated', listener: () => void): void;
|
1710
1811
|
|
1711
1812
|
/**
|
1712
1813
|
* Fired when a node's scrollability state changes.
|
1814
|
+
* @experimental
|
1713
1815
|
*/
|
1714
1816
|
on(event: 'scrollableFlagUpdated', listener: (params: Protocol.DOM.ScrollableFlagUpdatedEvent) => void): void;
|
1715
1817
|
|
1716
1818
|
/**
|
1717
1819
|
* Called when a pseudo element is removed from an element.
|
1820
|
+
* @experimental
|
1718
1821
|
*/
|
1719
1822
|
on(event: 'pseudoElementRemoved', listener: (params: Protocol.DOM.PseudoElementRemovedEvent) => void): void;
|
1720
1823
|
|
@@ -1726,11 +1829,13 @@ export namespace ProtocolProxyApi {
|
|
1726
1829
|
|
1727
1830
|
/**
|
1728
1831
|
* Called when shadow root is popped from the element.
|
1832
|
+
* @experimental
|
1729
1833
|
*/
|
1730
1834
|
on(event: 'shadowRootPopped', listener: (params: Protocol.DOM.ShadowRootPoppedEvent) => void): void;
|
1731
1835
|
|
1732
1836
|
/**
|
1733
1837
|
* Called when shadow root is pushed into the element.
|
1838
|
+
* @experimental
|
1734
1839
|
*/
|
1735
1840
|
on(event: 'shadowRootPushed', listener: (params: Protocol.DOM.ShadowRootPushedEvent) => void): void;
|
1736
1841
|
|
@@ -1754,6 +1859,8 @@ export namespace ProtocolProxyApi {
|
|
1754
1859
|
|
1755
1860
|
/**
|
1756
1861
|
* Removes breakpoint on particular native event.
|
1862
|
+
* @deprecated
|
1863
|
+
* @experimental
|
1757
1864
|
*/
|
1758
1865
|
removeInstrumentationBreakpoint(params: Protocol.DOMDebugger.RemoveInstrumentationBreakpointRequest): Promise<void>;
|
1759
1866
|
|
@@ -1764,6 +1871,7 @@ export namespace ProtocolProxyApi {
|
|
1764
1871
|
|
1765
1872
|
/**
|
1766
1873
|
* Sets breakpoint on particular CSP violations.
|
1874
|
+
* @experimental
|
1767
1875
|
*/
|
1768
1876
|
setBreakOnCSPViolation(params: Protocol.DOMDebugger.SetBreakOnCSPViolationRequest): Promise<void>;
|
1769
1877
|
|
@@ -1779,6 +1887,8 @@ export namespace ProtocolProxyApi {
|
|
1779
1887
|
|
1780
1888
|
/**
|
1781
1889
|
* Sets breakpoint on particular native event.
|
1890
|
+
* @deprecated
|
1891
|
+
* @experimental
|
1782
1892
|
*/
|
1783
1893
|
setInstrumentationBreakpoint(params: Protocol.DOMDebugger.SetInstrumentationBreakpointRequest): Promise<void>;
|
1784
1894
|
|
@@ -1823,6 +1933,7 @@ export namespace ProtocolProxyApi {
|
|
1823
1933
|
* template contents, and imported documents) in a flattened array, as well as layout and
|
1824
1934
|
* white-listed computed style information for the nodes. Shadow DOM in the returned DOM tree is
|
1825
1935
|
* flattened.
|
1936
|
+
* @deprecated
|
1826
1937
|
*/
|
1827
1938
|
getSnapshot(params: Protocol.DOMSnapshot.GetSnapshotRequest): Promise<Protocol.DOMSnapshot.GetSnapshotResponse>;
|
1828
1939
|
|
@@ -1881,6 +1992,7 @@ export namespace ProtocolProxyApi {
|
|
1881
1992
|
export interface EmulationApi {
|
1882
1993
|
/**
|
1883
1994
|
* Tells whether emulation is supported.
|
1995
|
+
* @deprecated
|
1884
1996
|
*/
|
1885
1997
|
canEmulate(): Promise<Protocol.Emulation.CanEmulateResponse>;
|
1886
1998
|
|
@@ -1896,16 +2008,19 @@ export namespace ProtocolProxyApi {
|
|
1896
2008
|
|
1897
2009
|
/**
|
1898
2010
|
* Requests that page scale factor is reset to initial values.
|
2011
|
+
* @experimental
|
1899
2012
|
*/
|
1900
2013
|
resetPageScaleFactor(): Promise<void>;
|
1901
2014
|
|
1902
2015
|
/**
|
1903
2016
|
* Enables or disables simulating a focused and active page.
|
2017
|
+
* @experimental
|
1904
2018
|
*/
|
1905
2019
|
setFocusEmulationEnabled(params: Protocol.Emulation.SetFocusEmulationEnabledRequest): Promise<void>;
|
1906
2020
|
|
1907
2021
|
/**
|
1908
2022
|
* Automatically render all web contents using a dark theme.
|
2023
|
+
* @experimental
|
1909
2024
|
*/
|
1910
2025
|
setAutoDarkModeOverride(params: Protocol.Emulation.SetAutoDarkModeOverrideRequest): Promise<void>;
|
1911
2026
|
|
@@ -1923,6 +2038,7 @@ export namespace ProtocolProxyApi {
|
|
1923
2038
|
/**
|
1924
2039
|
* Overrides the values for env(safe-area-inset-*) and env(safe-area-max-inset-*). Unset values will cause the
|
1925
2040
|
* respective variables to be undefined, even if previously overridden.
|
2041
|
+
* @experimental
|
1926
2042
|
*/
|
1927
2043
|
setSafeAreaInsetsOverride(params: Protocol.Emulation.SetSafeAreaInsetsOverrideRequest): Promise<void>;
|
1928
2044
|
|
@@ -1936,6 +2052,7 @@ export namespace ProtocolProxyApi {
|
|
1936
2052
|
/**
|
1937
2053
|
* Start reporting the given posture value to the Device Posture API.
|
1938
2054
|
* This override can also be set in setDeviceMetricsOverride().
|
2055
|
+
* @experimental
|
1939
2056
|
*/
|
1940
2057
|
setDevicePostureOverride(params: Protocol.Emulation.SetDevicePostureOverrideRequest): Promise<void>;
|
1941
2058
|
|
@@ -1944,12 +2061,14 @@ export namespace ProtocolProxyApi {
|
|
1944
2061
|
* or setDevicePostureOverride() and starts using posture information from the
|
1945
2062
|
* platform again.
|
1946
2063
|
* Does nothing if no override is set.
|
2064
|
+
* @experimental
|
1947
2065
|
*/
|
1948
2066
|
clearDevicePostureOverride(): Promise<void>;
|
1949
2067
|
|
1950
2068
|
/**
|
1951
2069
|
* Start using the given display features to pupulate the Viewport Segments API.
|
1952
2070
|
* This override can also be set in setDeviceMetricsOverride().
|
2071
|
+
* @experimental
|
1953
2072
|
*/
|
1954
2073
|
setDisplayFeaturesOverride(params: Protocol.Emulation.SetDisplayFeaturesOverrideRequest): Promise<void>;
|
1955
2074
|
|
@@ -1958,13 +2077,23 @@ export namespace ProtocolProxyApi {
|
|
1958
2077
|
* or setDisplayFeaturesOverride() and starts using display features from the
|
1959
2078
|
* platform again.
|
1960
2079
|
* Does nothing if no override is set.
|
2080
|
+
* @experimental
|
1961
2081
|
*/
|
1962
2082
|
clearDisplayFeaturesOverride(): Promise<void>;
|
1963
2083
|
|
2084
|
+
/**
|
2085
|
+
* @experimental
|
2086
|
+
*/
|
1964
2087
|
setScrollbarsHidden(params: Protocol.Emulation.SetScrollbarsHiddenRequest): Promise<void>;
|
1965
2088
|
|
2089
|
+
/**
|
2090
|
+
* @experimental
|
2091
|
+
*/
|
1966
2092
|
setDocumentCookieDisabled(params: Protocol.Emulation.SetDocumentCookieDisabledRequest): Promise<void>;
|
1967
2093
|
|
2094
|
+
/**
|
2095
|
+
* @experimental
|
2096
|
+
*/
|
1968
2097
|
setEmitTouchEventsForMouse(params: Protocol.Emulation.SetEmitTouchEventsForMouseRequest): Promise<void>;
|
1969
2098
|
|
1970
2099
|
/**
|
@@ -1988,6 +2117,9 @@ export namespace ProtocolProxyApi {
|
|
1988
2117
|
*/
|
1989
2118
|
setGeolocationOverride(params: Protocol.Emulation.SetGeolocationOverrideRequest): Promise<void>;
|
1990
2119
|
|
2120
|
+
/**
|
2121
|
+
* @experimental
|
2122
|
+
*/
|
1991
2123
|
getOverriddenSensorInformation(params: Protocol.Emulation.GetOverriddenSensorInformationRequest): Promise<Protocol.Emulation.GetOverriddenSensorInformationResponse>;
|
1992
2124
|
|
1993
2125
|
/**
|
@@ -1996,12 +2128,14 @@ export namespace ProtocolProxyApi {
|
|
1996
2128
|
* data from a real hardware sensor. Otherwise, existing virtual
|
1997
2129
|
* sensor-backend Sensor objects will fire an error event and new calls to
|
1998
2130
|
* Sensor.start() will attempt to use a real sensor instead.
|
2131
|
+
* @experimental
|
1999
2132
|
*/
|
2000
2133
|
setSensorOverrideEnabled(params: Protocol.Emulation.SetSensorOverrideEnabledRequest): Promise<void>;
|
2001
2134
|
|
2002
2135
|
/**
|
2003
2136
|
* Updates the sensor readings reported by a sensor type previously overridden
|
2004
2137
|
* by setSensorOverrideEnabled.
|
2138
|
+
* @experimental
|
2005
2139
|
*/
|
2006
2140
|
setSensorOverrideReadings(params: Protocol.Emulation.SetSensorOverrideReadingsRequest): Promise<void>;
|
2007
2141
|
|
@@ -2010,6 +2144,7 @@ export namespace ProtocolProxyApi {
|
|
2010
2144
|
* Pressure API, so that updates to PressureObserver.observe() are provided
|
2011
2145
|
* via setPressureStateOverride instead of being retrieved from
|
2012
2146
|
* platform-provided telemetry data.
|
2147
|
+
* @experimental
|
2013
2148
|
*/
|
2014
2149
|
setPressureSourceOverrideEnabled(params: Protocol.Emulation.SetPressureSourceOverrideEnabledRequest): Promise<void>;
|
2015
2150
|
|
@@ -2018,6 +2153,7 @@ export namespace ProtocolProxyApi {
|
|
2018
2153
|
* Provides a given pressure state that will be processed and eventually be
|
2019
2154
|
* delivered to PressureObserver users. |source| must have been previously
|
2020
2155
|
* overridden by setPressureSourceOverrideEnabled.
|
2156
|
+
* @experimental
|
2021
2157
|
*/
|
2022
2158
|
setPressureStateOverride(params: Protocol.Emulation.SetPressureStateOverrideRequest): Promise<void>;
|
2023
2159
|
|
@@ -2025,6 +2161,7 @@ export namespace ProtocolProxyApi {
|
|
2025
2161
|
* Provides a given pressure data set that will be processed and eventually be
|
2026
2162
|
* delivered to PressureObserver users. |source| must have been previously
|
2027
2163
|
* overridden by setPressureSourceOverrideEnabled.
|
2164
|
+
* @experimental
|
2028
2165
|
*/
|
2029
2166
|
setPressureDataOverride(params: Protocol.Emulation.SetPressureDataOverrideRequest): Promise<void>;
|
2030
2167
|
|
@@ -2040,11 +2177,14 @@ export namespace ProtocolProxyApi {
|
|
2040
2177
|
|
2041
2178
|
/**
|
2042
2179
|
* Overrides value returned by the javascript navigator object.
|
2180
|
+
* @deprecated
|
2181
|
+
* @experimental
|
2043
2182
|
*/
|
2044
2183
|
setNavigatorOverrides(params: Protocol.Emulation.SetNavigatorOverridesRequest): Promise<void>;
|
2045
2184
|
|
2046
2185
|
/**
|
2047
2186
|
* Sets a specified page scale factor.
|
2187
|
+
* @experimental
|
2048
2188
|
*/
|
2049
2189
|
setPageScaleFactor(params: Protocol.Emulation.SetPageScaleFactorRequest): Promise<void>;
|
2050
2190
|
|
@@ -2061,11 +2201,13 @@ export namespace ProtocolProxyApi {
|
|
2061
2201
|
/**
|
2062
2202
|
* Turns on virtual time for all frames (replacing real-time with a synthetic time source) and sets
|
2063
2203
|
* the current virtual time policy. Note this supersedes any previous time budget.
|
2204
|
+
* @experimental
|
2064
2205
|
*/
|
2065
2206
|
setVirtualTimePolicy(params: Protocol.Emulation.SetVirtualTimePolicyRequest): Promise<Protocol.Emulation.SetVirtualTimePolicyResponse>;
|
2066
2207
|
|
2067
2208
|
/**
|
2068
2209
|
* Overrides default host system locale with the specified one.
|
2210
|
+
* @experimental
|
2069
2211
|
*/
|
2070
2212
|
setLocaleOverride(params: Protocol.Emulation.SetLocaleOverrideRequest): Promise<void>;
|
2071
2213
|
|
@@ -2078,16 +2220,25 @@ export namespace ProtocolProxyApi {
|
|
2078
2220
|
* Resizes the frame/viewport of the page. Note that this does not affect the frame's container
|
2079
2221
|
* (e.g. browser window). Can be used to produce screenshots of the specified size. Not supported
|
2080
2222
|
* on Android.
|
2223
|
+
* @deprecated
|
2224
|
+
* @experimental
|
2081
2225
|
*/
|
2082
2226
|
setVisibleSize(params: Protocol.Emulation.SetVisibleSizeRequest): Promise<void>;
|
2083
2227
|
|
2228
|
+
/**
|
2229
|
+
* @experimental
|
2230
|
+
*/
|
2084
2231
|
setDisabledImageTypes(params: Protocol.Emulation.SetDisabledImageTypesRequest): Promise<void>;
|
2085
2232
|
|
2086
2233
|
/**
|
2087
2234
|
* Override the value of navigator.connection.saveData
|
2235
|
+
* @experimental
|
2088
2236
|
*/
|
2089
2237
|
setDataSaverOverride(params: Protocol.Emulation.SetDataSaverOverrideRequest): Promise<void>;
|
2090
2238
|
|
2239
|
+
/**
|
2240
|
+
* @experimental
|
2241
|
+
*/
|
2091
2242
|
setHardwareConcurrencyOverride(params: Protocol.Emulation.SetHardwareConcurrencyOverrideRequest): Promise<void>;
|
2092
2243
|
|
2093
2244
|
/**
|
@@ -2098,17 +2249,20 @@ export namespace ProtocolProxyApi {
|
|
2098
2249
|
|
2099
2250
|
/**
|
2100
2251
|
* Allows overriding the automation flag.
|
2252
|
+
* @experimental
|
2101
2253
|
*/
|
2102
2254
|
setAutomationOverride(params: Protocol.Emulation.SetAutomationOverrideRequest): Promise<void>;
|
2103
2255
|
|
2104
2256
|
/**
|
2105
2257
|
* Allows overriding the difference between the small and large viewport sizes, which determine the
|
2106
2258
|
* value of the `svh` and `lvh` unit, respectively. Only supported for top-level frames.
|
2259
|
+
* @experimental
|
2107
2260
|
*/
|
2108
2261
|
setSmallViewportHeightDifferenceOverride(params: Protocol.Emulation.SetSmallViewportHeightDifferenceOverrideRequest): Promise<void>;
|
2109
2262
|
|
2110
2263
|
/**
|
2111
2264
|
* Notification sent after the virtual time budget for the current VirtualTimePolicy has run out.
|
2265
|
+
* @experimental
|
2112
2266
|
*/
|
2113
2267
|
on(event: 'virtualTimeBudgetExpired', listener: () => void): void;
|
2114
2268
|
|
@@ -2125,11 +2279,13 @@ export namespace ProtocolProxyApi {
|
|
2125
2279
|
|
2126
2280
|
/**
|
2127
2281
|
* Disables headless events for the target.
|
2282
|
+
* @deprecated
|
2128
2283
|
*/
|
2129
2284
|
disable(): Promise<void>;
|
2130
2285
|
|
2131
2286
|
/**
|
2132
2287
|
* Enables headless events for the target.
|
2288
|
+
* @deprecated
|
2133
2289
|
*/
|
2134
2290
|
enable(): Promise<void>;
|
2135
2291
|
|
@@ -2209,6 +2365,7 @@ export namespace ProtocolProxyApi {
|
|
2209
2365
|
export interface InputApi {
|
2210
2366
|
/**
|
2211
2367
|
* Dispatches a drag event into the page.
|
2368
|
+
* @experimental
|
2212
2369
|
*/
|
2213
2370
|
dispatchDragEvent(params: Protocol.Input.DispatchDragEventRequest): Promise<void>;
|
2214
2371
|
|
@@ -2220,6 +2377,7 @@ export namespace ProtocolProxyApi {
|
|
2220
2377
|
/**
|
2221
2378
|
* This method emulates inserting text that doesn't come from a key press,
|
2222
2379
|
* for example an emoji keyboard or an IME.
|
2380
|
+
* @experimental
|
2223
2381
|
*/
|
2224
2382
|
insertText(params: Protocol.Input.InsertTextRequest): Promise<void>;
|
2225
2383
|
|
@@ -2227,6 +2385,7 @@ export namespace ProtocolProxyApi {
|
|
2227
2385
|
* This method sets the current candidate text for IME.
|
2228
2386
|
* Use imeCommitComposition to commit the final text.
|
2229
2387
|
* Use imeSetComposition with empty string as text to cancel composition.
|
2388
|
+
* @experimental
|
2230
2389
|
*/
|
2231
2390
|
imeSetComposition(params: Protocol.Input.ImeSetCompositionRequest): Promise<void>;
|
2232
2391
|
|
@@ -2247,6 +2406,7 @@ export namespace ProtocolProxyApi {
|
|
2247
2406
|
|
2248
2407
|
/**
|
2249
2408
|
* Emulates touch event from the mouse event parameters.
|
2409
|
+
* @experimental
|
2250
2410
|
*/
|
2251
2411
|
emulateTouchFromMouseEvent(params: Protocol.Input.EmulateTouchFromMouseEventRequest): Promise<void>;
|
2252
2412
|
|
@@ -2258,27 +2418,32 @@ export namespace ProtocolProxyApi {
|
|
2258
2418
|
/**
|
2259
2419
|
* Prevents default drag and drop behavior and instead emits `Input.dragIntercepted` events.
|
2260
2420
|
* Drag and drop behavior can be directly controlled via `Input.dispatchDragEvent`.
|
2421
|
+
* @experimental
|
2261
2422
|
*/
|
2262
2423
|
setInterceptDrags(params: Protocol.Input.SetInterceptDragsRequest): Promise<void>;
|
2263
2424
|
|
2264
2425
|
/**
|
2265
2426
|
* Synthesizes a pinch gesture over a time period by issuing appropriate touch events.
|
2427
|
+
* @experimental
|
2266
2428
|
*/
|
2267
2429
|
synthesizePinchGesture(params: Protocol.Input.SynthesizePinchGestureRequest): Promise<void>;
|
2268
2430
|
|
2269
2431
|
/**
|
2270
2432
|
* Synthesizes a scroll gesture over a time period by issuing appropriate touch events.
|
2433
|
+
* @experimental
|
2271
2434
|
*/
|
2272
2435
|
synthesizeScrollGesture(params: Protocol.Input.SynthesizeScrollGestureRequest): Promise<void>;
|
2273
2436
|
|
2274
2437
|
/**
|
2275
2438
|
* Synthesizes a tap gesture over a time period by issuing appropriate touch events.
|
2439
|
+
* @experimental
|
2276
2440
|
*/
|
2277
2441
|
synthesizeTapGesture(params: Protocol.Input.SynthesizeTapGestureRequest): Promise<void>;
|
2278
2442
|
|
2279
2443
|
/**
|
2280
2444
|
* Emitted only when `Input.setInterceptDrags` is enabled. Use this data with `Input.dispatchDragEvent` to
|
2281
2445
|
* restore normal drag and drop behavior.
|
2446
|
+
* @experimental
|
2282
2447
|
*/
|
2283
2448
|
on(event: 'dragIntercepted', listener: (params: Protocol.Input.DragInterceptedEvent) => void): void;
|
2284
2449
|
|
@@ -2460,26 +2625,31 @@ export namespace ProtocolProxyApi {
|
|
2460
2625
|
export interface NetworkApi {
|
2461
2626
|
/**
|
2462
2627
|
* Sets a list of content encodings that will be accepted. Empty list means no encoding is accepted.
|
2628
|
+
* @experimental
|
2463
2629
|
*/
|
2464
2630
|
setAcceptedEncodings(params: Protocol.Network.SetAcceptedEncodingsRequest): Promise<void>;
|
2465
2631
|
|
2466
2632
|
/**
|
2467
2633
|
* Clears accepted encodings set by setAcceptedEncodings
|
2634
|
+
* @experimental
|
2468
2635
|
*/
|
2469
2636
|
clearAcceptedEncodingsOverride(): Promise<void>;
|
2470
2637
|
|
2471
2638
|
/**
|
2472
2639
|
* Tells whether clearing browser cache is supported.
|
2640
|
+
* @deprecated
|
2473
2641
|
*/
|
2474
2642
|
canClearBrowserCache(): Promise<Protocol.Network.CanClearBrowserCacheResponse>;
|
2475
2643
|
|
2476
2644
|
/**
|
2477
2645
|
* Tells whether clearing browser cookies is supported.
|
2646
|
+
* @deprecated
|
2478
2647
|
*/
|
2479
2648
|
canClearBrowserCookies(): Promise<Protocol.Network.CanClearBrowserCookiesResponse>;
|
2480
2649
|
|
2481
2650
|
/**
|
2482
2651
|
* Tells whether emulation of network conditions is supported.
|
2652
|
+
* @deprecated
|
2483
2653
|
*/
|
2484
2654
|
canEmulateNetworkConditions(): Promise<Protocol.Network.CanEmulateNetworkConditionsResponse>;
|
2485
2655
|
|
@@ -2499,6 +2669,8 @@ export namespace ProtocolProxyApi {
|
|
2499
2669
|
* fetch occurs as a result which encounters a redirect an additional Network.requestIntercepted
|
2500
2670
|
* event will be sent with the same InterceptionId.
|
2501
2671
|
* Deprecated, use Fetch.continueRequest, Fetch.fulfillRequest and Fetch.failRequest instead.
|
2672
|
+
* @deprecated
|
2673
|
+
* @experimental
|
2502
2674
|
*/
|
2503
2675
|
continueInterceptedRequest(params: Protocol.Network.ContinueInterceptedRequestRequest): Promise<void>;
|
2504
2676
|
|
@@ -2526,11 +2698,13 @@ export namespace ProtocolProxyApi {
|
|
2526
2698
|
* Returns all browser cookies. Depending on the backend support, will return detailed cookie
|
2527
2699
|
* information in the `cookies` field.
|
2528
2700
|
* Deprecated. Use Storage.getCookies instead.
|
2701
|
+
* @deprecated
|
2529
2702
|
*/
|
2530
2703
|
getAllCookies(): Promise<Protocol.Network.GetAllCookiesResponse>;
|
2531
2704
|
|
2532
2705
|
/**
|
2533
2706
|
* Returns the DER-encoded certificate.
|
2707
|
+
* @experimental
|
2534
2708
|
*/
|
2535
2709
|
getCertificate(params: Protocol.Network.GetCertificateRequest): Promise<Protocol.Network.GetCertificateResponse>;
|
2536
2710
|
|
@@ -2552,6 +2726,7 @@ export namespace ProtocolProxyApi {
|
|
2552
2726
|
|
2553
2727
|
/**
|
2554
2728
|
* Returns content served for the given currently intercepted request.
|
2729
|
+
* @experimental
|
2555
2730
|
*/
|
2556
2731
|
getResponseBodyForInterception(params: Protocol.Network.GetResponseBodyForInterceptionRequest): Promise<Protocol.Network.GetResponseBodyForInterceptionResponse>;
|
2557
2732
|
|
@@ -2560,6 +2735,7 @@ export namespace ProtocolProxyApi {
|
|
2560
2735
|
* the intercepted request can't be continued as is -- you either need to cancel it or to provide
|
2561
2736
|
* the response body. The stream only supports sequential read, IO.read will fail if the position
|
2562
2737
|
* is specified.
|
2738
|
+
* @experimental
|
2563
2739
|
*/
|
2564
2740
|
takeResponseBodyForInterceptionAsStream(params: Protocol.Network.TakeResponseBodyForInterceptionAsStreamRequest): Promise<Protocol.Network.TakeResponseBodyForInterceptionAsStreamResponse>;
|
2565
2741
|
|
@@ -2567,16 +2743,19 @@ export namespace ProtocolProxyApi {
|
|
2567
2743
|
* This method sends a new XMLHttpRequest which is identical to the original one. The following
|
2568
2744
|
* parameters should be identical: method, url, async, request body, extra headers, withCredentials
|
2569
2745
|
* attribute, user, password.
|
2746
|
+
* @experimental
|
2570
2747
|
*/
|
2571
2748
|
replayXHR(params: Protocol.Network.ReplayXHRRequest): Promise<void>;
|
2572
2749
|
|
2573
2750
|
/**
|
2574
2751
|
* Searches for given string in response content.
|
2752
|
+
* @experimental
|
2575
2753
|
*/
|
2576
2754
|
searchInResponseBody(params: Protocol.Network.SearchInResponseBodyRequest): Promise<Protocol.Network.SearchInResponseBodyResponse>;
|
2577
2755
|
|
2578
2756
|
/**
|
2579
2757
|
* Blocks URLs from loading.
|
2758
|
+
* @experimental
|
2580
2759
|
*/
|
2581
2760
|
setBlockedURLs(params: Protocol.Network.SetBlockedURLsRequest): Promise<void>;
|
2582
2761
|
|
@@ -2607,12 +2786,15 @@ export namespace ProtocolProxyApi {
|
|
2607
2786
|
|
2608
2787
|
/**
|
2609
2788
|
* Specifies whether to attach a page script stack id in requests
|
2789
|
+
* @experimental
|
2610
2790
|
*/
|
2611
2791
|
setAttachDebugStack(params: Protocol.Network.SetAttachDebugStackRequest): Promise<void>;
|
2612
2792
|
|
2613
2793
|
/**
|
2614
2794
|
* Sets the requests to intercept that match the provided patterns and optionally resource types.
|
2615
2795
|
* Deprecated, please use Fetch.enable instead.
|
2796
|
+
* @deprecated
|
2797
|
+
* @experimental
|
2616
2798
|
*/
|
2617
2799
|
setRequestInterception(params: Protocol.Network.SetRequestInterceptionRequest): Promise<void>;
|
2618
2800
|
|
@@ -2624,28 +2806,33 @@ export namespace ProtocolProxyApi {
|
|
2624
2806
|
/**
|
2625
2807
|
* Enables streaming of the response for the given requestId.
|
2626
2808
|
* If enabled, the dataReceived event contains the data that was received during streaming.
|
2809
|
+
* @experimental
|
2627
2810
|
*/
|
2628
2811
|
streamResourceContent(params: Protocol.Network.StreamResourceContentRequest): Promise<Protocol.Network.StreamResourceContentResponse>;
|
2629
2812
|
|
2630
2813
|
/**
|
2631
2814
|
* Returns information about the COEP/COOP isolation status.
|
2815
|
+
* @experimental
|
2632
2816
|
*/
|
2633
2817
|
getSecurityIsolationStatus(params: Protocol.Network.GetSecurityIsolationStatusRequest): Promise<Protocol.Network.GetSecurityIsolationStatusResponse>;
|
2634
2818
|
|
2635
2819
|
/**
|
2636
2820
|
* Enables tracking for the Reporting API, events generated by the Reporting API will now be delivered to the client.
|
2637
2821
|
* Enabling triggers 'reportingApiReportAdded' for all existing reports.
|
2822
|
+
* @experimental
|
2638
2823
|
*/
|
2639
2824
|
enableReportingApi(params: Protocol.Network.EnableReportingApiRequest): Promise<void>;
|
2640
2825
|
|
2641
2826
|
/**
|
2642
2827
|
* Fetches the resource and returns the content.
|
2828
|
+
* @experimental
|
2643
2829
|
*/
|
2644
2830
|
loadNetworkResource(params: Protocol.Network.LoadNetworkResourceRequest): Promise<Protocol.Network.LoadNetworkResourceResponse>;
|
2645
2831
|
|
2646
2832
|
/**
|
2647
2833
|
* Sets Controls for third-party cookie access
|
2648
2834
|
* Page reload is required before the new cookie behavior will be observed
|
2835
|
+
* @experimental
|
2649
2836
|
*/
|
2650
2837
|
setCookieControls(params: Protocol.Network.SetCookieControlsRequest): Promise<void>;
|
2651
2838
|
|
@@ -2673,6 +2860,8 @@ export namespace ProtocolProxyApi {
|
|
2673
2860
|
* Details of an intercepted HTTP request, which must be either allowed, blocked, modified or
|
2674
2861
|
* mocked.
|
2675
2862
|
* Deprecated, use Fetch.requestPaused instead.
|
2863
|
+
* @deprecated
|
2864
|
+
* @experimental
|
2676
2865
|
*/
|
2677
2866
|
on(event: 'requestIntercepted', listener: (params: Protocol.Network.RequestInterceptedEvent) => void): void;
|
2678
2867
|
|
@@ -2688,11 +2877,13 @@ export namespace ProtocolProxyApi {
|
|
2688
2877
|
|
2689
2878
|
/**
|
2690
2879
|
* Fired when resource loading priority is changed
|
2880
|
+
* @experimental
|
2691
2881
|
*/
|
2692
2882
|
on(event: 'resourceChangedPriority', listener: (params: Protocol.Network.ResourceChangedPriorityEvent) => void): void;
|
2693
2883
|
|
2694
2884
|
/**
|
2695
2885
|
* Fired when a signed exchange was received over the network
|
2886
|
+
* @experimental
|
2696
2887
|
*/
|
2697
2888
|
on(event: 'signedExchangeReceived', listener: (params: Protocol.Network.SignedExchangeReceivedEvent) => void): void;
|
2698
2889
|
|
@@ -2753,61 +2944,73 @@ export namespace ProtocolProxyApi {
|
|
2753
2944
|
|
2754
2945
|
/**
|
2755
2946
|
* Fired upon direct_socket.TCPSocket creation.
|
2947
|
+
* @experimental
|
2756
2948
|
*/
|
2757
2949
|
on(event: 'directTCPSocketCreated', listener: (params: Protocol.Network.DirectTCPSocketCreatedEvent) => void): void;
|
2758
2950
|
|
2759
2951
|
/**
|
2760
2952
|
* Fired when direct_socket.TCPSocket connection is opened.
|
2953
|
+
* @experimental
|
2761
2954
|
*/
|
2762
2955
|
on(event: 'directTCPSocketOpened', listener: (params: Protocol.Network.DirectTCPSocketOpenedEvent) => void): void;
|
2763
2956
|
|
2764
2957
|
/**
|
2765
2958
|
* Fired when direct_socket.TCPSocket is aborted.
|
2959
|
+
* @experimental
|
2766
2960
|
*/
|
2767
2961
|
on(event: 'directTCPSocketAborted', listener: (params: Protocol.Network.DirectTCPSocketAbortedEvent) => void): void;
|
2768
2962
|
|
2769
2963
|
/**
|
2770
2964
|
* Fired when direct_socket.TCPSocket is closed.
|
2965
|
+
* @experimental
|
2771
2966
|
*/
|
2772
2967
|
on(event: 'directTCPSocketClosed', listener: (params: Protocol.Network.DirectTCPSocketClosedEvent) => void): void;
|
2773
2968
|
|
2774
2969
|
/**
|
2775
2970
|
* Fired when data is sent to tcp direct socket stream.
|
2971
|
+
* @experimental
|
2776
2972
|
*/
|
2777
2973
|
on(event: 'directTCPSocketChunkSent', listener: (params: Protocol.Network.DirectTCPSocketChunkSentEvent) => void): void;
|
2778
2974
|
|
2779
2975
|
/**
|
2780
2976
|
* Fired when data is received from tcp direct socket stream.
|
2977
|
+
* @experimental
|
2781
2978
|
*/
|
2782
2979
|
on(event: 'directTCPSocketChunkReceived', listener: (params: Protocol.Network.DirectTCPSocketChunkReceivedEvent) => void): void;
|
2783
2980
|
|
2784
2981
|
/**
|
2785
2982
|
* Fired upon direct_socket.UDPSocket creation.
|
2983
|
+
* @experimental
|
2786
2984
|
*/
|
2787
2985
|
on(event: 'directUDPSocketCreated', listener: (params: Protocol.Network.DirectUDPSocketCreatedEvent) => void): void;
|
2788
2986
|
|
2789
2987
|
/**
|
2790
2988
|
* Fired when direct_socket.UDPSocket connection is opened.
|
2989
|
+
* @experimental
|
2791
2990
|
*/
|
2792
2991
|
on(event: 'directUDPSocketOpened', listener: (params: Protocol.Network.DirectUDPSocketOpenedEvent) => void): void;
|
2793
2992
|
|
2794
2993
|
/**
|
2795
2994
|
* Fired when direct_socket.UDPSocket is aborted.
|
2995
|
+
* @experimental
|
2796
2996
|
*/
|
2797
2997
|
on(event: 'directUDPSocketAborted', listener: (params: Protocol.Network.DirectUDPSocketAbortedEvent) => void): void;
|
2798
2998
|
|
2799
2999
|
/**
|
2800
3000
|
* Fired when direct_socket.UDPSocket is closed.
|
3001
|
+
* @experimental
|
2801
3002
|
*/
|
2802
3003
|
on(event: 'directUDPSocketClosed', listener: (params: Protocol.Network.DirectUDPSocketClosedEvent) => void): void;
|
2803
3004
|
|
2804
3005
|
/**
|
2805
3006
|
* Fired when message is sent to udp direct socket stream.
|
3007
|
+
* @experimental
|
2806
3008
|
*/
|
2807
3009
|
on(event: 'directUDPSocketChunkSent', listener: (params: Protocol.Network.DirectUDPSocketChunkSentEvent) => void): void;
|
2808
3010
|
|
2809
3011
|
/**
|
2810
3012
|
* Fired when message is received from udp direct socket stream.
|
3013
|
+
* @experimental
|
2811
3014
|
*/
|
2812
3015
|
on(event: 'directUDPSocketChunkReceived', listener: (params: Protocol.Network.DirectUDPSocketChunkReceivedEvent) => void): void;
|
2813
3016
|
|
@@ -2816,6 +3019,7 @@ export namespace ProtocolProxyApi {
|
|
2816
3019
|
* network stack. Not every requestWillBeSent event will have an additional
|
2817
3020
|
* requestWillBeSentExtraInfo fired for it, and there is no guarantee whether requestWillBeSent
|
2818
3021
|
* or requestWillBeSentExtraInfo will be fired first for the same request.
|
3022
|
+
* @experimental
|
2819
3023
|
*/
|
2820
3024
|
on(event: 'requestWillBeSentExtraInfo', listener: (params: Protocol.Network.RequestWillBeSentExtraInfoEvent) => void): void;
|
2821
3025
|
|
@@ -2823,6 +3027,7 @@ export namespace ProtocolProxyApi {
|
|
2823
3027
|
* Fired when additional information about a responseReceived event is available from the network
|
2824
3028
|
* stack. Not every responseReceived event will have an additional responseReceivedExtraInfo for
|
2825
3029
|
* it, and responseReceivedExtraInfo may be fired before or after responseReceived.
|
3030
|
+
* @experimental
|
2826
3031
|
*/
|
2827
3032
|
on(event: 'responseReceivedExtraInfo', listener: (params: Protocol.Network.ResponseReceivedExtraInfoEvent) => void): void;
|
2828
3033
|
|
@@ -2830,6 +3035,7 @@ export namespace ProtocolProxyApi {
|
|
2830
3035
|
* Fired when 103 Early Hints headers is received in addition to the common response.
|
2831
3036
|
* Not every responseReceived event will have an responseReceivedEarlyHints fired.
|
2832
3037
|
* Only one responseReceivedEarlyHints may be fired for eached responseReceived event.
|
3038
|
+
* @experimental
|
2833
3039
|
*/
|
2834
3040
|
on(event: 'responseReceivedEarlyHints', listener: (params: Protocol.Network.ResponseReceivedEarlyHintsEvent) => void): void;
|
2835
3041
|
|
@@ -2838,44 +3044,57 @@ export namespace ProtocolProxyApi {
|
|
2838
3044
|
* the type of the operation and whether the operation succeeded or
|
2839
3045
|
* failed, the event is fired before the corresponding request was sent
|
2840
3046
|
* or after the response was received.
|
3047
|
+
* @experimental
|
2841
3048
|
*/
|
2842
3049
|
on(event: 'trustTokenOperationDone', listener: (params: Protocol.Network.TrustTokenOperationDoneEvent) => void): void;
|
2843
3050
|
|
2844
3051
|
/**
|
2845
3052
|
* Fired once security policy has been updated.
|
3053
|
+
* @experimental
|
2846
3054
|
*/
|
2847
3055
|
on(event: 'policyUpdated', listener: () => void): void;
|
2848
3056
|
|
2849
3057
|
/**
|
2850
3058
|
* Fired once when parsing the .wbn file has succeeded.
|
2851
3059
|
* The event contains the information about the web bundle contents.
|
3060
|
+
* @experimental
|
2852
3061
|
*/
|
2853
3062
|
on(event: 'subresourceWebBundleMetadataReceived', listener: (params: Protocol.Network.SubresourceWebBundleMetadataReceivedEvent) => void): void;
|
2854
3063
|
|
2855
3064
|
/**
|
2856
3065
|
* Fired once when parsing the .wbn file has failed.
|
3066
|
+
* @experimental
|
2857
3067
|
*/
|
2858
3068
|
on(event: 'subresourceWebBundleMetadataError', listener: (params: Protocol.Network.SubresourceWebBundleMetadataErrorEvent) => void): void;
|
2859
3069
|
|
2860
3070
|
/**
|
2861
3071
|
* Fired when handling requests for resources within a .wbn file.
|
2862
3072
|
* Note: this will only be fired for resources that are requested by the webpage.
|
3073
|
+
* @experimental
|
2863
3074
|
*/
|
2864
3075
|
on(event: 'subresourceWebBundleInnerResponseParsed', listener: (params: Protocol.Network.SubresourceWebBundleInnerResponseParsedEvent) => void): void;
|
2865
3076
|
|
2866
3077
|
/**
|
2867
3078
|
* Fired when request for resources within a .wbn file failed.
|
3079
|
+
* @experimental
|
2868
3080
|
*/
|
2869
3081
|
on(event: 'subresourceWebBundleInnerResponseError', listener: (params: Protocol.Network.SubresourceWebBundleInnerResponseErrorEvent) => void): void;
|
2870
3082
|
|
2871
3083
|
/**
|
2872
3084
|
* Is sent whenever a new report is added.
|
2873
3085
|
* And after 'enableReportingApi' for all existing reports.
|
3086
|
+
* @experimental
|
2874
3087
|
*/
|
2875
3088
|
on(event: 'reportingApiReportAdded', listener: (params: Protocol.Network.ReportingApiReportAddedEvent) => void): void;
|
2876
3089
|
|
3090
|
+
/**
|
3091
|
+
* @experimental
|
3092
|
+
*/
|
2877
3093
|
on(event: 'reportingApiReportUpdated', listener: (params: Protocol.Network.ReportingApiReportUpdatedEvent) => void): void;
|
2878
3094
|
|
3095
|
+
/**
|
3096
|
+
* @experimental
|
3097
|
+
*/
|
2879
3098
|
on(event: 'reportingApiEndpointsChangedForOrigin', listener: (params: Protocol.Network.ReportingApiEndpointsChangedForOriginEvent) => void): void;
|
2880
3099
|
|
2881
3100
|
}
|
@@ -2916,6 +3135,7 @@ export namespace ProtocolProxyApi {
|
|
2916
3135
|
* Deprecated: Doesn't work reliably and cannot be fixed due to process
|
2917
3136
|
* separation (the owner node might be in a different process). Determine
|
2918
3137
|
* the owner node in the client and use highlightNode.
|
3138
|
+
* @deprecated
|
2919
3139
|
*/
|
2920
3140
|
highlightFrame(params: Protocol.Overlay.HighlightFrameRequest): Promise<void>;
|
2921
3141
|
|
@@ -2992,11 +3212,13 @@ export namespace ProtocolProxyApi {
|
|
2992
3212
|
|
2993
3213
|
/**
|
2994
3214
|
* Deprecated, no longer has any effect.
|
3215
|
+
* @deprecated
|
2995
3216
|
*/
|
2996
3217
|
setShowHitTestBorders(params: Protocol.Overlay.SetShowHitTestBordersRequest): Promise<void>;
|
2997
3218
|
|
2998
3219
|
/**
|
2999
3220
|
* Deprecated, no longer has any effect.
|
3221
|
+
* @deprecated
|
3000
3222
|
*/
|
3001
3223
|
setShowWebVitals(params: Protocol.Overlay.SetShowWebVitalsRequest): Promise<void>;
|
3002
3224
|
|
@@ -3046,6 +3268,8 @@ export namespace ProtocolProxyApi {
|
|
3046
3268
|
export interface PageApi {
|
3047
3269
|
/**
|
3048
3270
|
* Deprecated, please use addScriptToEvaluateOnNewDocument instead.
|
3271
|
+
* @deprecated
|
3272
|
+
* @experimental
|
3049
3273
|
*/
|
3050
3274
|
addScriptToEvaluateOnLoad(params: Protocol.Page.AddScriptToEvaluateOnLoadRequest): Promise<Protocol.Page.AddScriptToEvaluateOnLoadResponse>;
|
3051
3275
|
|
@@ -3067,21 +3291,27 @@ export namespace ProtocolProxyApi {
|
|
3067
3291
|
/**
|
3068
3292
|
* Returns a snapshot of the page as a string. For MHTML format, the serialization includes
|
3069
3293
|
* iframes, shadow DOM, external resources, and element-inline styles.
|
3294
|
+
* @experimental
|
3070
3295
|
*/
|
3071
3296
|
captureSnapshot(params: Protocol.Page.CaptureSnapshotRequest): Promise<Protocol.Page.CaptureSnapshotResponse>;
|
3072
3297
|
|
3073
3298
|
/**
|
3074
3299
|
* Clears the overridden device metrics.
|
3300
|
+
* @deprecated
|
3301
|
+
* @experimental
|
3075
3302
|
*/
|
3076
3303
|
clearDeviceMetricsOverride(): Promise<void>;
|
3077
3304
|
|
3078
3305
|
/**
|
3079
3306
|
* Clears the overridden Device Orientation.
|
3307
|
+
* @deprecated
|
3308
|
+
* @experimental
|
3080
3309
|
*/
|
3081
3310
|
clearDeviceOrientationOverride(): Promise<void>;
|
3082
3311
|
|
3083
3312
|
/**
|
3084
3313
|
* Clears the overridden Geolocation Position and Error.
|
3314
|
+
* @deprecated
|
3085
3315
|
*/
|
3086
3316
|
clearGeolocationOverride(): Promise<void>;
|
3087
3317
|
|
@@ -3092,6 +3322,8 @@ export namespace ProtocolProxyApi {
|
|
3092
3322
|
|
3093
3323
|
/**
|
3094
3324
|
* Deletes browser cookie with given name, domain and path.
|
3325
|
+
* @deprecated
|
3326
|
+
* @experimental
|
3095
3327
|
*/
|
3096
3328
|
deleteCookie(params: Protocol.Page.DeleteCookieRequest): Promise<void>;
|
3097
3329
|
|
@@ -3114,19 +3346,28 @@ export namespace ProtocolProxyApi {
|
|
3114
3346
|
*/
|
3115
3347
|
getAppManifest(params: Protocol.Page.GetAppManifestRequest): Promise<Protocol.Page.GetAppManifestResponse>;
|
3116
3348
|
|
3349
|
+
/**
|
3350
|
+
* @experimental
|
3351
|
+
*/
|
3117
3352
|
getInstallabilityErrors(): Promise<Protocol.Page.GetInstallabilityErrorsResponse>;
|
3118
3353
|
|
3119
3354
|
/**
|
3120
3355
|
* Deprecated because it's not guaranteed that the returned icon is in fact the one used for PWA installation.
|
3356
|
+
* @deprecated
|
3357
|
+
* @experimental
|
3121
3358
|
*/
|
3122
3359
|
getManifestIcons(): Promise<Protocol.Page.GetManifestIconsResponse>;
|
3123
3360
|
|
3124
3361
|
/**
|
3125
3362
|
* Returns the unique (PWA) app id.
|
3126
3363
|
* Only returns values if the feature flag 'WebAppEnableManifestId' is enabled
|
3364
|
+
* @experimental
|
3127
3365
|
*/
|
3128
3366
|
getAppId(): Promise<Protocol.Page.GetAppIdResponse>;
|
3129
3367
|
|
3368
|
+
/**
|
3369
|
+
* @experimental
|
3370
|
+
*/
|
3130
3371
|
getAdScriptAncestry(params: Protocol.Page.GetAdScriptAncestryRequest): Promise<Protocol.Page.GetAdScriptAncestryResponse>;
|
3131
3372
|
|
3132
3373
|
/**
|
@@ -3151,11 +3392,13 @@ export namespace ProtocolProxyApi {
|
|
3151
3392
|
|
3152
3393
|
/**
|
3153
3394
|
* Returns content of the given resource.
|
3395
|
+
* @experimental
|
3154
3396
|
*/
|
3155
3397
|
getResourceContent(params: Protocol.Page.GetResourceContentRequest): Promise<Protocol.Page.GetResourceContentResponse>;
|
3156
3398
|
|
3157
3399
|
/**
|
3158
3400
|
* Returns present frame / resource tree structure.
|
3401
|
+
* @experimental
|
3159
3402
|
*/
|
3160
3403
|
getResourceTree(): Promise<Protocol.Page.GetResourceTreeResponse>;
|
3161
3404
|
|
@@ -3186,6 +3429,8 @@ export namespace ProtocolProxyApi {
|
|
3186
3429
|
|
3187
3430
|
/**
|
3188
3431
|
* Deprecated, please use removeScriptToEvaluateOnNewDocument instead.
|
3432
|
+
* @deprecated
|
3433
|
+
* @experimental
|
3189
3434
|
*/
|
3190
3435
|
removeScriptToEvaluateOnLoad(params: Protocol.Page.RemoveScriptToEvaluateOnLoadRequest): Promise<void>;
|
3191
3436
|
|
@@ -3196,16 +3441,19 @@ export namespace ProtocolProxyApi {
|
|
3196
3441
|
|
3197
3442
|
/**
|
3198
3443
|
* Acknowledges that a screencast frame has been received by the frontend.
|
3444
|
+
* @experimental
|
3199
3445
|
*/
|
3200
3446
|
screencastFrameAck(params: Protocol.Page.ScreencastFrameAckRequest): Promise<void>;
|
3201
3447
|
|
3202
3448
|
/**
|
3203
3449
|
* Searches for given string in resource content.
|
3450
|
+
* @experimental
|
3204
3451
|
*/
|
3205
3452
|
searchInResource(params: Protocol.Page.SearchInResourceRequest): Promise<Protocol.Page.SearchInResourceResponse>;
|
3206
3453
|
|
3207
3454
|
/**
|
3208
3455
|
* Enable Chrome's experimental ad filter on all sites.
|
3456
|
+
* @experimental
|
3209
3457
|
*/
|
3210
3458
|
setAdBlockingEnabled(params: Protocol.Page.SetAdBlockingEnabledRequest): Promise<void>;
|
3211
3459
|
|
@@ -3216,11 +3464,13 @@ export namespace ProtocolProxyApi {
|
|
3216
3464
|
|
3217
3465
|
/**
|
3218
3466
|
* Get Permissions Policy state on given frame.
|
3467
|
+
* @experimental
|
3219
3468
|
*/
|
3220
3469
|
getPermissionsPolicyState(params: Protocol.Page.GetPermissionsPolicyStateRequest): Promise<Protocol.Page.GetPermissionsPolicyStateResponse>;
|
3221
3470
|
|
3222
3471
|
/**
|
3223
3472
|
* Get Origin Trials on given frame.
|
3473
|
+
* @experimental
|
3224
3474
|
*/
|
3225
3475
|
getOriginTrials(params: Protocol.Page.GetOriginTrialsRequest): Promise<Protocol.Page.GetOriginTrialsResponse>;
|
3226
3476
|
|
@@ -3228,21 +3478,27 @@ export namespace ProtocolProxyApi {
|
|
3228
3478
|
* Overrides the values of device screen dimensions (window.screen.width, window.screen.height,
|
3229
3479
|
* window.innerWidth, window.innerHeight, and "device-width"/"device-height"-related CSS media
|
3230
3480
|
* query results).
|
3481
|
+
* @deprecated
|
3482
|
+
* @experimental
|
3231
3483
|
*/
|
3232
3484
|
setDeviceMetricsOverride(params: Protocol.Page.SetDeviceMetricsOverrideRequest): Promise<void>;
|
3233
3485
|
|
3234
3486
|
/**
|
3235
3487
|
* Overrides the Device Orientation.
|
3488
|
+
* @deprecated
|
3489
|
+
* @experimental
|
3236
3490
|
*/
|
3237
3491
|
setDeviceOrientationOverride(params: Protocol.Page.SetDeviceOrientationOverrideRequest): Promise<void>;
|
3238
3492
|
|
3239
3493
|
/**
|
3240
3494
|
* Set generic font families.
|
3495
|
+
* @experimental
|
3241
3496
|
*/
|
3242
3497
|
setFontFamilies(params: Protocol.Page.SetFontFamiliesRequest): Promise<void>;
|
3243
3498
|
|
3244
3499
|
/**
|
3245
3500
|
* Set default font sizes.
|
3501
|
+
* @experimental
|
3246
3502
|
*/
|
3247
3503
|
setFontSizes(params: Protocol.Page.SetFontSizesRequest): Promise<void>;
|
3248
3504
|
|
@@ -3253,12 +3509,15 @@ export namespace ProtocolProxyApi {
|
|
3253
3509
|
|
3254
3510
|
/**
|
3255
3511
|
* Set the behavior when downloading a file.
|
3512
|
+
* @deprecated
|
3513
|
+
* @experimental
|
3256
3514
|
*/
|
3257
3515
|
setDownloadBehavior(params: Protocol.Page.SetDownloadBehaviorRequest): Promise<void>;
|
3258
3516
|
|
3259
3517
|
/**
|
3260
3518
|
* Overrides the Geolocation Position or Error. Omitting any of the parameters emulates position
|
3261
3519
|
* unavailable.
|
3520
|
+
* @deprecated
|
3262
3521
|
*/
|
3263
3522
|
setGeolocationOverride(params: Protocol.Page.SetGeolocationOverrideRequest): Promise<void>;
|
3264
3523
|
|
@@ -3269,11 +3528,14 @@ export namespace ProtocolProxyApi {
|
|
3269
3528
|
|
3270
3529
|
/**
|
3271
3530
|
* Toggles mouse event-based touch event emulation.
|
3531
|
+
* @deprecated
|
3532
|
+
* @experimental
|
3272
3533
|
*/
|
3273
3534
|
setTouchEmulationEnabled(params: Protocol.Page.SetTouchEmulationEnabledRequest): Promise<void>;
|
3274
3535
|
|
3275
3536
|
/**
|
3276
3537
|
* Starts sending each frame using the `screencastFrame` event.
|
3538
|
+
* @experimental
|
3277
3539
|
*/
|
3278
3540
|
startScreencast(params: Protocol.Page.StartScreencastRequest): Promise<void>;
|
3279
3541
|
|
@@ -3284,6 +3546,7 @@ export namespace ProtocolProxyApi {
|
|
3284
3546
|
|
3285
3547
|
/**
|
3286
3548
|
* Crashes renderer on the IO thread, generates minidumps.
|
3549
|
+
* @experimental
|
3287
3550
|
*/
|
3288
3551
|
crash(): Promise<void>;
|
3289
3552
|
|
@@ -3296,11 +3559,13 @@ export namespace ProtocolProxyApi {
|
|
3296
3559
|
* Tries to update the web lifecycle state of the page.
|
3297
3560
|
* It will transition the page to the given state according to:
|
3298
3561
|
* https://github.com/WICG/web-lifecycle/
|
3562
|
+
* @experimental
|
3299
3563
|
*/
|
3300
3564
|
setWebLifecycleState(params: Protocol.Page.SetWebLifecycleStateRequest): Promise<void>;
|
3301
3565
|
|
3302
3566
|
/**
|
3303
3567
|
* Stops sending each frame in the `screencastFrame`.
|
3568
|
+
* @experimental
|
3304
3569
|
*/
|
3305
3570
|
stopScreencast(): Promise<void>;
|
3306
3571
|
|
@@ -3311,39 +3576,46 @@ export namespace ProtocolProxyApi {
|
|
3311
3576
|
* When script with a matching URL is encountered, the cache is optionally
|
3312
3577
|
* produced upon backend discretion, based on internal heuristics.
|
3313
3578
|
* See also: `Page.compilationCacheProduced`.
|
3579
|
+
* @experimental
|
3314
3580
|
*/
|
3315
3581
|
produceCompilationCache(params: Protocol.Page.ProduceCompilationCacheRequest): Promise<void>;
|
3316
3582
|
|
3317
3583
|
/**
|
3318
3584
|
* Seeds compilation cache for given url. Compilation cache does not survive
|
3319
3585
|
* cross-process navigation.
|
3586
|
+
* @experimental
|
3320
3587
|
*/
|
3321
3588
|
addCompilationCache(params: Protocol.Page.AddCompilationCacheRequest): Promise<void>;
|
3322
3589
|
|
3323
3590
|
/**
|
3324
3591
|
* Clears seeded compilation cache.
|
3592
|
+
* @experimental
|
3325
3593
|
*/
|
3326
3594
|
clearCompilationCache(): Promise<void>;
|
3327
3595
|
|
3328
3596
|
/**
|
3329
3597
|
* Sets the Secure Payment Confirmation transaction mode.
|
3330
3598
|
* https://w3c.github.io/secure-payment-confirmation/#sctn-automation-set-spc-transaction-mode
|
3599
|
+
* @experimental
|
3331
3600
|
*/
|
3332
3601
|
setSPCTransactionMode(params: Protocol.Page.SetSPCTransactionModeRequest): Promise<void>;
|
3333
3602
|
|
3334
3603
|
/**
|
3335
3604
|
* Extensions for Custom Handlers API:
|
3336
3605
|
* https://html.spec.whatwg.org/multipage/system-state.html#rph-automation
|
3606
|
+
* @experimental
|
3337
3607
|
*/
|
3338
3608
|
setRPHRegistrationMode(params: Protocol.Page.SetRPHRegistrationModeRequest): Promise<void>;
|
3339
3609
|
|
3340
3610
|
/**
|
3341
3611
|
* Generates a report for testing.
|
3612
|
+
* @experimental
|
3342
3613
|
*/
|
3343
3614
|
generateTestReport(params: Protocol.Page.GenerateTestReportRequest): Promise<void>;
|
3344
3615
|
|
3345
3616
|
/**
|
3346
3617
|
* Pauses page execution. Can be resumed using generic Runtime.runIfWaitingForDebugger.
|
3618
|
+
* @experimental
|
3347
3619
|
*/
|
3348
3620
|
waitForDebugger(): Promise<void>;
|
3349
3621
|
|
@@ -3362,6 +3634,7 @@ export namespace ProtocolProxyApi {
|
|
3362
3634
|
* for more details.
|
3363
3635
|
*
|
3364
3636
|
* TODO(https://crbug.com/1440085): Remove this once Puppeteer supports tab targets.
|
3637
|
+
* @experimental
|
3365
3638
|
*/
|
3366
3639
|
setPrerenderingAllowed(params: Protocol.Page.SetPrerenderingAllowedRequest): Promise<void>;
|
3367
3640
|
|
@@ -3379,6 +3652,7 @@ export namespace ProtocolProxyApi {
|
|
3379
3652
|
|
3380
3653
|
/**
|
3381
3654
|
* Fired when frame no longer has a scheduled navigation.
|
3655
|
+
* @deprecated
|
3382
3656
|
*/
|
3383
3657
|
on(event: 'frameClearedScheduledNavigation', listener: (params: Protocol.Page.FrameClearedScheduledNavigationEvent) => void): void;
|
3384
3658
|
|
@@ -3390,6 +3664,7 @@ export namespace ProtocolProxyApi {
|
|
3390
3664
|
/**
|
3391
3665
|
* Fired before frame subtree is detached. Emitted before any frame of the
|
3392
3666
|
* subtree is actually detached.
|
3667
|
+
* @experimental
|
3393
3668
|
*/
|
3394
3669
|
on(event: 'frameSubtreeWillBeDetached', listener: (params: Protocol.Page.FrameSubtreeWillBeDetachedEvent) => void): void;
|
3395
3670
|
|
@@ -3400,9 +3675,13 @@ export namespace ProtocolProxyApi {
|
|
3400
3675
|
|
3401
3676
|
/**
|
3402
3677
|
* Fired when opening document to write to.
|
3678
|
+
* @experimental
|
3403
3679
|
*/
|
3404
3680
|
on(event: 'documentOpened', listener: (params: Protocol.Page.DocumentOpenedEvent) => void): void;
|
3405
3681
|
|
3682
|
+
/**
|
3683
|
+
* @experimental
|
3684
|
+
*/
|
3406
3685
|
on(event: 'frameResized', listener: () => void): void;
|
3407
3686
|
|
3408
3687
|
/**
|
@@ -3413,39 +3692,48 @@ export namespace ProtocolProxyApi {
|
|
3413
3692
|
* can be fired for a single navigation, for example, when a same-document
|
3414
3693
|
* navigation becomes a cross-document navigation (such as in the case of a
|
3415
3694
|
* frameset).
|
3695
|
+
* @experimental
|
3416
3696
|
*/
|
3417
3697
|
on(event: 'frameStartedNavigating', listener: (params: Protocol.Page.FrameStartedNavigatingEvent) => void): void;
|
3418
3698
|
|
3419
3699
|
/**
|
3420
3700
|
* Fired when a renderer-initiated navigation is requested.
|
3421
3701
|
* Navigation may still be cancelled after the event is issued.
|
3702
|
+
* @experimental
|
3422
3703
|
*/
|
3423
3704
|
on(event: 'frameRequestedNavigation', listener: (params: Protocol.Page.FrameRequestedNavigationEvent) => void): void;
|
3424
3705
|
|
3425
3706
|
/**
|
3426
3707
|
* Fired when frame schedules a potential navigation.
|
3708
|
+
* @deprecated
|
3427
3709
|
*/
|
3428
3710
|
on(event: 'frameScheduledNavigation', listener: (params: Protocol.Page.FrameScheduledNavigationEvent) => void): void;
|
3429
3711
|
|
3430
3712
|
/**
|
3431
3713
|
* Fired when frame has started loading.
|
3714
|
+
* @experimental
|
3432
3715
|
*/
|
3433
3716
|
on(event: 'frameStartedLoading', listener: (params: Protocol.Page.FrameStartedLoadingEvent) => void): void;
|
3434
3717
|
|
3435
3718
|
/**
|
3436
3719
|
* Fired when frame has stopped loading.
|
3720
|
+
* @experimental
|
3437
3721
|
*/
|
3438
3722
|
on(event: 'frameStoppedLoading', listener: (params: Protocol.Page.FrameStoppedLoadingEvent) => void): void;
|
3439
3723
|
|
3440
3724
|
/**
|
3441
3725
|
* Fired when page is about to start a download.
|
3442
3726
|
* Deprecated. Use Browser.downloadWillBegin instead.
|
3727
|
+
* @deprecated
|
3728
|
+
* @experimental
|
3443
3729
|
*/
|
3444
3730
|
on(event: 'downloadWillBegin', listener: (params: Protocol.Page.DownloadWillBeginEvent) => void): void;
|
3445
3731
|
|
3446
3732
|
/**
|
3447
3733
|
* Fired when download makes progress. Last call has |done| == true.
|
3448
3734
|
* Deprecated. Use Browser.downloadProgress instead.
|
3735
|
+
* @deprecated
|
3736
|
+
* @experimental
|
3449
3737
|
*/
|
3450
3738
|
on(event: 'downloadProgress', listener: (params: Protocol.Page.DownloadProgressEvent) => void): void;
|
3451
3739
|
|
@@ -3482,6 +3770,7 @@ export namespace ProtocolProxyApi {
|
|
3482
3770
|
* not assume any ordering with the Page.frameNavigated event. This event is fired only for
|
3483
3771
|
* main-frame history navigation where the document changes (non-same-document navigations),
|
3484
3772
|
* when bfcache navigation fails.
|
3773
|
+
* @experimental
|
3485
3774
|
*/
|
3486
3775
|
on(event: 'backForwardCacheNotUsed', listener: (params: Protocol.Page.BackForwardCacheNotUsedEvent) => void): void;
|
3487
3776
|
|
@@ -3489,16 +3778,19 @@ export namespace ProtocolProxyApi {
|
|
3489
3778
|
|
3490
3779
|
/**
|
3491
3780
|
* Fired when same-document navigation happens, e.g. due to history API usage or anchor navigation.
|
3781
|
+
* @experimental
|
3492
3782
|
*/
|
3493
3783
|
on(event: 'navigatedWithinDocument', listener: (params: Protocol.Page.NavigatedWithinDocumentEvent) => void): void;
|
3494
3784
|
|
3495
3785
|
/**
|
3496
3786
|
* Compressed image data requested by the `startScreencast`.
|
3787
|
+
* @experimental
|
3497
3788
|
*/
|
3498
3789
|
on(event: 'screencastFrame', listener: (params: Protocol.Page.ScreencastFrameEvent) => void): void;
|
3499
3790
|
|
3500
3791
|
/**
|
3501
3792
|
* Fired when the page with currently enabled screencast was shown or hidden `.
|
3793
|
+
* @experimental
|
3502
3794
|
*/
|
3503
3795
|
on(event: 'screencastVisibilityChanged', listener: (params: Protocol.Page.ScreencastVisibilityChangedEvent) => void): void;
|
3504
3796
|
|
@@ -3509,8 +3801,8 @@ export namespace ProtocolProxyApi {
|
|
3509
3801
|
on(event: 'windowOpen', listener: (params: Protocol.Page.WindowOpenEvent) => void): void;
|
3510
3802
|
|
3511
3803
|
/**
|
3512
|
-
* Issued for every compilation cache generated.
|
3513
|
-
*
|
3804
|
+
* Issued for every compilation cache generated.
|
3805
|
+
* @experimental
|
3514
3806
|
*/
|
3515
3807
|
on(event: 'compilationCacheProduced', listener: (params: Protocol.Page.CompilationCacheProducedEvent) => void): void;
|
3516
3808
|
|
@@ -3531,6 +3823,8 @@ export namespace ProtocolProxyApi {
|
|
3531
3823
|
* Sets time domain to use for collecting and reporting duration metrics.
|
3532
3824
|
* Note that this must be called before enabling metrics collection. Calling
|
3533
3825
|
* this method while metrics collection is enabled returns an error.
|
3826
|
+
* @deprecated
|
3827
|
+
* @experimental
|
3534
3828
|
*/
|
3535
3829
|
setTimeDomain(params: Protocol.Performance.SetTimeDomainRequest): Promise<void>;
|
3536
3830
|
|
@@ -3578,12 +3872,14 @@ export namespace ProtocolProxyApi {
|
|
3578
3872
|
|
3579
3873
|
/**
|
3580
3874
|
* Handles a certificate error that fired a certificateError event.
|
3875
|
+
* @deprecated
|
3581
3876
|
*/
|
3582
3877
|
handleCertificateError(params: Protocol.Security.HandleCertificateErrorRequest): Promise<void>;
|
3583
3878
|
|
3584
3879
|
/**
|
3585
3880
|
* Enable/disable overriding certificate errors. If enabled, all certificate error events need to
|
3586
3881
|
* be handled by the DevTools client and should be answered with `handleCertificateError` commands.
|
3882
|
+
* @deprecated
|
3587
3883
|
*/
|
3588
3884
|
setOverrideCertificateErrors(params: Protocol.Security.SetOverrideCertificateErrorsRequest): Promise<void>;
|
3589
3885
|
|
@@ -3592,16 +3888,19 @@ export namespace ProtocolProxyApi {
|
|
3592
3888
|
* handled with the `handleCertificateError` command. Note: this event does not fire if the
|
3593
3889
|
* certificate error has been allowed internally. Only one client per target should override
|
3594
3890
|
* certificate errors at the same time.
|
3891
|
+
* @deprecated
|
3595
3892
|
*/
|
3596
3893
|
on(event: 'certificateError', listener: (params: Protocol.Security.CertificateErrorEvent) => void): void;
|
3597
3894
|
|
3598
3895
|
/**
|
3599
3896
|
* The security state of the page changed.
|
3897
|
+
* @experimental
|
3600
3898
|
*/
|
3601
3899
|
on(event: 'visibleSecurityStateChanged', listener: (params: Protocol.Security.VisibleSecurityStateChangedEvent) => void): void;
|
3602
3900
|
|
3603
3901
|
/**
|
3604
3902
|
* The security state of the page changed. No longer being sent.
|
3903
|
+
* @deprecated
|
3605
3904
|
*/
|
3606
3905
|
on(event: 'securityStateChanged', listener: (params: Protocol.Security.SecurityStateChangedEvent) => void): void;
|
3607
3906
|
|
@@ -3678,6 +3977,7 @@ export namespace ProtocolProxyApi {
|
|
3678
3977
|
|
3679
3978
|
/**
|
3680
3979
|
* Override quota for the specified origin
|
3980
|
+
* @experimental
|
3681
3981
|
*/
|
3682
3982
|
overrideQuotaForOrigin(params: Protocol.Storage.OverrideQuotaForOriginRequest): Promise<void>;
|
3683
3983
|
|
@@ -3724,100 +4024,119 @@ export namespace ProtocolProxyApi {
|
|
3724
4024
|
/**
|
3725
4025
|
* Returns the number of stored Trust Tokens per issuer for the
|
3726
4026
|
* current browsing context.
|
4027
|
+
* @experimental
|
3727
4028
|
*/
|
3728
4029
|
getTrustTokens(): Promise<Protocol.Storage.GetTrustTokensResponse>;
|
3729
4030
|
|
3730
4031
|
/**
|
3731
4032
|
* Removes all Trust Tokens issued by the provided issuerOrigin.
|
3732
4033
|
* Leaves other stored data, including the issuer's Redemption Records, intact.
|
4034
|
+
* @experimental
|
3733
4035
|
*/
|
3734
4036
|
clearTrustTokens(params: Protocol.Storage.ClearTrustTokensRequest): Promise<Protocol.Storage.ClearTrustTokensResponse>;
|
3735
4037
|
|
3736
4038
|
/**
|
3737
4039
|
* Gets details for a named interest group.
|
4040
|
+
* @experimental
|
3738
4041
|
*/
|
3739
4042
|
getInterestGroupDetails(params: Protocol.Storage.GetInterestGroupDetailsRequest): Promise<Protocol.Storage.GetInterestGroupDetailsResponse>;
|
3740
4043
|
|
3741
4044
|
/**
|
3742
4045
|
* Enables/Disables issuing of interestGroupAccessed events.
|
4046
|
+
* @experimental
|
3743
4047
|
*/
|
3744
4048
|
setInterestGroupTracking(params: Protocol.Storage.SetInterestGroupTrackingRequest): Promise<void>;
|
3745
4049
|
|
3746
4050
|
/**
|
3747
4051
|
* Enables/Disables issuing of interestGroupAuctionEventOccurred and
|
3748
4052
|
* interestGroupAuctionNetworkRequestCreated.
|
4053
|
+
* @experimental
|
3749
4054
|
*/
|
3750
4055
|
setInterestGroupAuctionTracking(params: Protocol.Storage.SetInterestGroupAuctionTrackingRequest): Promise<void>;
|
3751
4056
|
|
3752
4057
|
/**
|
3753
4058
|
* Gets metadata for an origin's shared storage.
|
4059
|
+
* @experimental
|
3754
4060
|
*/
|
3755
4061
|
getSharedStorageMetadata(params: Protocol.Storage.GetSharedStorageMetadataRequest): Promise<Protocol.Storage.GetSharedStorageMetadataResponse>;
|
3756
4062
|
|
3757
4063
|
/**
|
3758
4064
|
* Gets the entries in an given origin's shared storage.
|
4065
|
+
* @experimental
|
3759
4066
|
*/
|
3760
4067
|
getSharedStorageEntries(params: Protocol.Storage.GetSharedStorageEntriesRequest): Promise<Protocol.Storage.GetSharedStorageEntriesResponse>;
|
3761
4068
|
|
3762
4069
|
/**
|
3763
4070
|
* Sets entry with `key` and `value` for a given origin's shared storage.
|
4071
|
+
* @experimental
|
3764
4072
|
*/
|
3765
4073
|
setSharedStorageEntry(params: Protocol.Storage.SetSharedStorageEntryRequest): Promise<void>;
|
3766
4074
|
|
3767
4075
|
/**
|
3768
4076
|
* Deletes entry for `key` (if it exists) for a given origin's shared storage.
|
4077
|
+
* @experimental
|
3769
4078
|
*/
|
3770
4079
|
deleteSharedStorageEntry(params: Protocol.Storage.DeleteSharedStorageEntryRequest): Promise<void>;
|
3771
4080
|
|
3772
4081
|
/**
|
3773
4082
|
* Clears all entries for a given origin's shared storage.
|
4083
|
+
* @experimental
|
3774
4084
|
*/
|
3775
4085
|
clearSharedStorageEntries(params: Protocol.Storage.ClearSharedStorageEntriesRequest): Promise<void>;
|
3776
4086
|
|
3777
4087
|
/**
|
3778
4088
|
* Resets the budget for `ownerOrigin` by clearing all budget withdrawals.
|
4089
|
+
* @experimental
|
3779
4090
|
*/
|
3780
4091
|
resetSharedStorageBudget(params: Protocol.Storage.ResetSharedStorageBudgetRequest): Promise<void>;
|
3781
4092
|
|
3782
4093
|
/**
|
3783
4094
|
* Enables/disables issuing of sharedStorageAccessed events.
|
4095
|
+
* @experimental
|
3784
4096
|
*/
|
3785
4097
|
setSharedStorageTracking(params: Protocol.Storage.SetSharedStorageTrackingRequest): Promise<void>;
|
3786
4098
|
|
3787
4099
|
/**
|
3788
4100
|
* Set tracking for a storage key's buckets.
|
4101
|
+
* @experimental
|
3789
4102
|
*/
|
3790
4103
|
setStorageBucketTracking(params: Protocol.Storage.SetStorageBucketTrackingRequest): Promise<void>;
|
3791
4104
|
|
3792
4105
|
/**
|
3793
4106
|
* Deletes the Storage Bucket with the given storage key and bucket name.
|
4107
|
+
* @experimental
|
3794
4108
|
*/
|
3795
4109
|
deleteStorageBucket(params: Protocol.Storage.DeleteStorageBucketRequest): Promise<void>;
|
3796
4110
|
|
3797
4111
|
/**
|
3798
4112
|
* Deletes state for sites identified as potential bounce trackers, immediately.
|
4113
|
+
* @experimental
|
3799
4114
|
*/
|
3800
4115
|
runBounceTrackingMitigations(): Promise<Protocol.Storage.RunBounceTrackingMitigationsResponse>;
|
3801
4116
|
|
3802
4117
|
/**
|
3803
4118
|
* https://wicg.github.io/attribution-reporting-api/
|
4119
|
+
* @experimental
|
3804
4120
|
*/
|
3805
4121
|
setAttributionReportingLocalTestingMode(params: Protocol.Storage.SetAttributionReportingLocalTestingModeRequest): Promise<void>;
|
3806
4122
|
|
3807
4123
|
/**
|
3808
4124
|
* Enables/disables issuing of Attribution Reporting events.
|
4125
|
+
* @experimental
|
3809
4126
|
*/
|
3810
4127
|
setAttributionReportingTracking(params: Protocol.Storage.SetAttributionReportingTrackingRequest): Promise<void>;
|
3811
4128
|
|
3812
4129
|
/**
|
3813
4130
|
* Sends all pending Attribution Reports immediately, regardless of their
|
3814
4131
|
* scheduled report time.
|
4132
|
+
* @experimental
|
3815
4133
|
*/
|
3816
4134
|
sendPendingAttributionReports(): Promise<Protocol.Storage.SendPendingAttributionReportsResponse>;
|
3817
4135
|
|
3818
4136
|
/**
|
3819
4137
|
* Returns the effective Related Website Sets in use by this profile for the browser
|
3820
4138
|
* session. The effective Related Website Sets will not change during a browser session.
|
4139
|
+
* @experimental
|
3821
4140
|
*/
|
3822
4141
|
getRelatedWebsiteSets(): Promise<Protocol.Storage.GetRelatedWebsiteSetsResponse>;
|
3823
4142
|
|
@@ -3825,6 +4144,7 @@ export namespace ProtocolProxyApi {
|
|
3825
4144
|
* Returns the list of URLs from a page and its embedded resources that match
|
3826
4145
|
* existing grace period URL pattern rules.
|
3827
4146
|
* https://developers.google.com/privacy-sandbox/cookies/temporary-exceptions/grace-period
|
4147
|
+
* @experimental
|
3828
4148
|
*/
|
3829
4149
|
getAffectedUrlsForThirdPartyCookieMetadata(params: Protocol.Storage.GetAffectedUrlsForThirdPartyCookieMetadataRequest): Promise<Protocol.Storage.GetAffectedUrlsForThirdPartyCookieMetadataResponse>;
|
3830
4150
|
|
@@ -3886,12 +4206,24 @@ export namespace ProtocolProxyApi {
|
|
3886
4206
|
|
3887
4207
|
on(event: 'storageBucketDeleted', listener: (params: Protocol.Storage.StorageBucketDeletedEvent) => void): void;
|
3888
4208
|
|
4209
|
+
/**
|
4210
|
+
* @experimental
|
4211
|
+
*/
|
3889
4212
|
on(event: 'attributionReportingSourceRegistered', listener: (params: Protocol.Storage.AttributionReportingSourceRegisteredEvent) => void): void;
|
3890
4213
|
|
4214
|
+
/**
|
4215
|
+
* @experimental
|
4216
|
+
*/
|
3891
4217
|
on(event: 'attributionReportingTriggerRegistered', listener: (params: Protocol.Storage.AttributionReportingTriggerRegisteredEvent) => void): void;
|
3892
4218
|
|
4219
|
+
/**
|
4220
|
+
* @experimental
|
4221
|
+
*/
|
3893
4222
|
on(event: 'attributionReportingReportSent', listener: (params: Protocol.Storage.AttributionReportingReportSentEvent) => void): void;
|
3894
4223
|
|
4224
|
+
/**
|
4225
|
+
* @experimental
|
4226
|
+
*/
|
3895
4227
|
on(event: 'attributionReportingVerboseDebugReportSent', listener: (params: Protocol.Storage.AttributionReportingVerboseDebugReportSentEvent) => void): void;
|
3896
4228
|
|
3897
4229
|
}
|
@@ -3927,6 +4259,7 @@ export namespace ProtocolProxyApi {
|
|
3927
4259
|
|
3928
4260
|
/**
|
3929
4261
|
* Attaches to the browser target, only uses flat sessionId mode.
|
4262
|
+
* @experimental
|
3930
4263
|
*/
|
3931
4264
|
attachToBrowserTarget(): Promise<Protocol.Target.AttachToBrowserTargetResponse>;
|
3932
4265
|
|
@@ -3944,6 +4277,7 @@ export namespace ProtocolProxyApi {
|
|
3944
4277
|
* The object has the following API:
|
3945
4278
|
* - `binding.send(json)` - a method to send messages over the remote debugging protocol
|
3946
4279
|
* - `binding.onmessage = json => handleMessage(json)` - a callback that will be called for the protocol notifications and command responses.
|
4280
|
+
* @experimental
|
3947
4281
|
*/
|
3948
4282
|
exposeDevToolsProtocol(params: Protocol.Target.ExposeDevToolsProtocolRequest): Promise<void>;
|
3949
4283
|
|
@@ -3976,6 +4310,7 @@ export namespace ProtocolProxyApi {
|
|
3976
4310
|
|
3977
4311
|
/**
|
3978
4312
|
* Returns information about a target.
|
4313
|
+
* @experimental
|
3979
4314
|
*/
|
3980
4315
|
getTargetInfo(params: Protocol.Target.GetTargetInfoRequest): Promise<Protocol.Target.GetTargetInfoResponse>;
|
3981
4316
|
|
@@ -3988,6 +4323,7 @@ export namespace ProtocolProxyApi {
|
|
3988
4323
|
* Sends protocol message over session with given id.
|
3989
4324
|
* Consider using flat mode instead; see commands attachToTarget, setAutoAttach,
|
3990
4325
|
* and crbug.com/991325.
|
4326
|
+
* @deprecated
|
3991
4327
|
*/
|
3992
4328
|
sendMessageToTarget(params: Protocol.Target.SendMessageToTargetRequest): Promise<void>;
|
3993
4329
|
|
@@ -4009,6 +4345,7 @@ export namespace ProtocolProxyApi {
|
|
4009
4345
|
* through `attachedToTarget`. The specified target is also auto-attached.
|
4010
4346
|
* This cancels the effect of any previous `setAutoAttach` and is also cancelled by subsequent
|
4011
4347
|
* `setAutoAttach`. Only available at the Browser target.
|
4348
|
+
* @experimental
|
4012
4349
|
*/
|
4013
4350
|
autoAttachRelated(params: Protocol.Target.AutoAttachRelatedRequest): Promise<void>;
|
4014
4351
|
|
@@ -4021,17 +4358,26 @@ export namespace ProtocolProxyApi {
|
|
4021
4358
|
/**
|
4022
4359
|
* Enables target discovery for the specified locations, when `setDiscoverTargets` was set to
|
4023
4360
|
* `true`.
|
4361
|
+
* @experimental
|
4024
4362
|
*/
|
4025
4363
|
setRemoteLocations(params: Protocol.Target.SetRemoteLocationsRequest): Promise<void>;
|
4026
4364
|
|
4365
|
+
/**
|
4366
|
+
* Opens a DevTools window for the target.
|
4367
|
+
* @experimental
|
4368
|
+
*/
|
4369
|
+
openDevTools(params: Protocol.Target.OpenDevToolsRequest): Promise<Protocol.Target.OpenDevToolsResponse>;
|
4370
|
+
|
4027
4371
|
/**
|
4028
4372
|
* Issued when attached to target because of auto-attach or `attachToTarget` command.
|
4373
|
+
* @experimental
|
4029
4374
|
*/
|
4030
4375
|
on(event: 'attachedToTarget', listener: (params: Protocol.Target.AttachedToTargetEvent) => void): void;
|
4031
4376
|
|
4032
4377
|
/**
|
4033
4378
|
* Issued when detached from target for any reason (including `detachFromTarget` command). Can be
|
4034
4379
|
* issued multiple times per target if multiple sessions have been attached to it.
|
4380
|
+
* @experimental
|
4035
4381
|
*/
|
4036
4382
|
on(event: 'detachedFromTarget', listener: (params: Protocol.Target.DetachedFromTargetEvent) => void): void;
|
4037
4383
|
|
@@ -4090,16 +4436,19 @@ export namespace ProtocolProxyApi {
|
|
4090
4436
|
|
4091
4437
|
/**
|
4092
4438
|
* Gets supported tracing categories.
|
4439
|
+
* @experimental
|
4093
4440
|
*/
|
4094
4441
|
getCategories(): Promise<Protocol.Tracing.GetCategoriesResponse>;
|
4095
4442
|
|
4096
4443
|
/**
|
4097
4444
|
* Record a clock sync marker in the trace.
|
4445
|
+
* @experimental
|
4098
4446
|
*/
|
4099
4447
|
recordClockSyncMarker(params: Protocol.Tracing.RecordClockSyncMarkerRequest): Promise<void>;
|
4100
4448
|
|
4101
4449
|
/**
|
4102
4450
|
* Request a global memory dump.
|
4451
|
+
* @experimental
|
4103
4452
|
*/
|
4104
4453
|
requestMemoryDump(params: Protocol.Tracing.RequestMemoryDumpRequest): Promise<Protocol.Tracing.RequestMemoryDumpResponse>;
|
4105
4454
|
|
@@ -4108,11 +4457,15 @@ export namespace ProtocolProxyApi {
|
|
4108
4457
|
*/
|
4109
4458
|
start(params: Protocol.Tracing.StartRequest): Promise<void>;
|
4110
4459
|
|
4460
|
+
/**
|
4461
|
+
* @experimental
|
4462
|
+
*/
|
4111
4463
|
on(event: 'bufferUsage', listener: (params: Protocol.Tracing.BufferUsageEvent) => void): void;
|
4112
4464
|
|
4113
4465
|
/**
|
4114
4466
|
* Contains a bucket of collected trace events. When tracing is stopped collected events will be
|
4115
4467
|
* sent as a sequence of dataCollected events followed by tracingComplete event.
|
4468
|
+
* @experimental
|
4116
4469
|
*/
|
4117
4470
|
on(event: 'dataCollected', listener: (params: Protocol.Tracing.DataCollectedEvent) => void): void;
|
4118
4471
|
|
@@ -4160,6 +4513,7 @@ export namespace ProtocolProxyApi {
|
|
4160
4513
|
* Continues loading of the paused response, optionally modifying the
|
4161
4514
|
* response headers. If either responseCode or headers are modified, all of them
|
4162
4515
|
* must be present.
|
4516
|
+
* @experimental
|
4163
4517
|
*/
|
4164
4518
|
continueResponse(params: Protocol.Fetch.ContinueResponseRequest): Promise<void>;
|
4165
4519
|
|