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.
@@ -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. Is only available
3513
- * if Page.setGenerateCompilationCache is enabled.
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