devtools-protocol 0.0.1498597 → 0.0.1501779

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.
Files changed (55) hide show
  1. package/json/browser_protocol.json +17960 -17689
  2. package/json/js_protocol.json +6 -0
  3. package/package.json +1 -1
  4. package/pdl/browser_protocol.pdl +47 -13824
  5. package/pdl/domains/Accessibility.pdl +290 -0
  6. package/pdl/domains/Animation.pdl +195 -0
  7. package/pdl/domains/Audits.pdl +755 -0
  8. package/pdl/domains/Autofill.pdl +106 -0
  9. package/pdl/domains/BackgroundService.pdl +77 -0
  10. package/pdl/domains/BluetoothEmulation.pdl +227 -0
  11. package/pdl/domains/Browser.pdl +345 -0
  12. package/pdl/domains/CSS.pdl +996 -0
  13. package/pdl/domains/CacheStorage.pdl +125 -0
  14. package/pdl/domains/Cast.pdl +62 -0
  15. package/pdl/domains/DOM.pdl +932 -0
  16. package/pdl/domains/DOMDebugger.pdl +128 -0
  17. package/pdl/domains/DOMSnapshot.pdl +319 -0
  18. package/pdl/domains/DOMStorage.pdl +72 -0
  19. package/pdl/domains/DeviceAccess.pdl +43 -0
  20. package/pdl/domains/DeviceOrientation.pdl +20 -0
  21. package/pdl/domains/Emulation.pdl +608 -0
  22. package/pdl/domains/EventBreakpoints.pdl +24 -0
  23. package/pdl/domains/Extensions.pdl +72 -0
  24. package/pdl/domains/FedCm.pdl +100 -0
  25. package/pdl/domains/Fetch.pdl +251 -0
  26. package/pdl/domains/FileSystem.pdl +41 -0
  27. package/pdl/domains/HeadlessExperimental.pdl +56 -0
  28. package/pdl/domains/IO.pdl +45 -0
  29. package/pdl/domains/IndexedDB.pdl +226 -0
  30. package/pdl/domains/Input.pdl +336 -0
  31. package/pdl/domains/Inspector.pdl +25 -0
  32. package/pdl/domains/LayerTree.pdl +178 -0
  33. package/pdl/domains/Log.pdl +93 -0
  34. package/pdl/domains/Media.pdl +106 -0
  35. package/pdl/domains/Memory.pdl +112 -0
  36. package/pdl/domains/Network.pdl +2039 -0
  37. package/pdl/domains/Overlay.pdl +498 -0
  38. package/pdl/domains/PWA.pdl +142 -0
  39. package/pdl/domains/Page.pdl +1767 -0
  40. package/pdl/domains/Performance.pdl +54 -0
  41. package/pdl/domains/PerformanceTimeline.pdl +71 -0
  42. package/pdl/domains/Preload.pdl +290 -0
  43. package/pdl/domains/Security.pdl +196 -0
  44. package/pdl/domains/ServiceWorker.pdl +121 -0
  45. package/pdl/domains/Storage.pdl +913 -0
  46. package/pdl/domains/SystemInfo.pdl +145 -0
  47. package/pdl/domains/Target.pdl +327 -0
  48. package/pdl/domains/Tethering.pdl +28 -0
  49. package/pdl/domains/Tracing.pdl +157 -0
  50. package/pdl/domains/WebAudio.pdl +205 -0
  51. package/pdl/domains/WebAuthn.pdl +230 -0
  52. package/types/protocol-mapping.d.ts +992 -615
  53. package/types/protocol-proxy-api.d.ts +543 -522
  54. package/types/protocol-tests-proxy-api.d.ts +628 -607
  55. package/types/protocol.d.ts +8059 -7903
@@ -28,12 +28,12 @@ export namespace ProtocolTestsProxyApi {
28
28
 
29
29
  Audits: AuditsApi;
30
30
 
31
- Extensions: ExtensionsApi;
32
-
33
31
  Autofill: AutofillApi;
34
32
 
35
33
  BackgroundService: BackgroundServiceApi;
36
34
 
35
+ BluetoothEmulation: BluetoothEmulationApi;
36
+
37
37
  Browser: BrowserApi;
38
38
 
39
39
  CSS: CSSApi;
@@ -46,22 +46,30 @@ export namespace ProtocolTestsProxyApi {
46
46
 
47
47
  DOMDebugger: DOMDebuggerApi;
48
48
 
49
- EventBreakpoints: EventBreakpointsApi;
50
-
51
49
  DOMSnapshot: DOMSnapshotApi;
52
50
 
53
51
  DOMStorage: DOMStorageApi;
54
52
 
53
+ DeviceAccess: DeviceAccessApi;
54
+
55
55
  DeviceOrientation: DeviceOrientationApi;
56
56
 
57
57
  Emulation: EmulationApi;
58
58
 
59
- HeadlessExperimental: HeadlessExperimentalApi;
59
+ EventBreakpoints: EventBreakpointsApi;
60
60
 
61
- IO: IOApi;
61
+ Extensions: ExtensionsApi;
62
+
63
+ FedCm: FedCmApi;
64
+
65
+ Fetch: FetchApi;
62
66
 
63
67
  FileSystem: FileSystemApi;
64
68
 
69
+ HeadlessExperimental: HeadlessExperimentalApi;
70
+
71
+ IO: IOApi;
72
+
65
73
  IndexedDB: IndexedDBApi;
66
74
 
67
75
  Input: InputApi;
@@ -72,18 +80,24 @@ export namespace ProtocolTestsProxyApi {
72
80
 
73
81
  Log: LogApi;
74
82
 
83
+ Media: MediaApi;
84
+
75
85
  Memory: MemoryApi;
76
86
 
77
87
  Network: NetworkApi;
78
88
 
79
89
  Overlay: OverlayApi;
80
90
 
91
+ PWA: PWAApi;
92
+
81
93
  Page: PageApi;
82
94
 
83
95
  Performance: PerformanceApi;
84
96
 
85
97
  PerformanceTimeline: PerformanceTimelineApi;
86
98
 
99
+ Preload: PreloadApi;
100
+
87
101
  Security: SecurityApi;
88
102
 
89
103
  ServiceWorker: ServiceWorkerApi;
@@ -98,24 +112,10 @@ export namespace ProtocolTestsProxyApi {
98
112
 
99
113
  Tracing: TracingApi;
100
114
 
101
- Fetch: FetchApi;
102
-
103
115
  WebAudio: WebAudioApi;
104
116
 
105
117
  WebAuthn: WebAuthnApi;
106
118
 
107
- Media: MediaApi;
108
-
109
- DeviceAccess: DeviceAccessApi;
110
-
111
- Preload: PreloadApi;
112
-
113
- FedCm: FedCmApi;
114
-
115
- PWA: PWAApi;
116
-
117
- BluetoothEmulation: BluetoothEmulationApi;
118
-
119
119
  }
120
120
 
121
121
 
@@ -911,47 +911,6 @@ export namespace ProtocolTestsProxyApi {
911
911
 
912
912
  }
913
913
 
914
- export interface ExtensionsApi {
915
- /**
916
- * Installs an unpacked extension from the filesystem similar to
917
- * --load-extension CLI flags. Returns extension ID once the extension
918
- * has been installed. Available if the client is connected using the
919
- * --remote-debugging-pipe flag and the --enable-unsafe-extension-debugging
920
- * flag is set.
921
- */
922
- loadUnpacked(params: Protocol.Extensions.LoadUnpackedRequest): Promise<{id: number, result: Protocol.Extensions.LoadUnpackedResponse, sessionId: string}>;
923
-
924
- /**
925
- * Uninstalls an unpacked extension (others not supported) from the profile.
926
- * Available if the client is connected using the --remote-debugging-pipe flag
927
- * and the --enable-unsafe-extension-debugging.
928
- */
929
- uninstall(params: Protocol.Extensions.UninstallRequest): Promise<{id: number, result: void, sessionId: string}>;
930
-
931
- /**
932
- * Gets data from extension storage in the given `storageArea`. If `keys` is
933
- * specified, these are used to filter the result.
934
- */
935
- getStorageItems(params: Protocol.Extensions.GetStorageItemsRequest): Promise<{id: number, result: Protocol.Extensions.GetStorageItemsResponse, sessionId: string}>;
936
-
937
- /**
938
- * Removes `keys` from extension storage in the given `storageArea`.
939
- */
940
- removeStorageItems(params: Protocol.Extensions.RemoveStorageItemsRequest): Promise<{id: number, result: void, sessionId: string}>;
941
-
942
- /**
943
- * Clears extension storage in the given `storageArea`.
944
- */
945
- clearStorageItems(params: Protocol.Extensions.ClearStorageItemsRequest): Promise<{id: number, result: void, sessionId: string}>;
946
-
947
- /**
948
- * Sets `values` in extension storage in the given `storageArea`. The provided `values`
949
- * will be merged with existing values in the storage area.
950
- */
951
- setStorageItems(params: Protocol.Extensions.SetStorageItemsRequest): Promise<{id: number, result: void, sessionId: string}>;
952
-
953
- }
954
-
955
914
  export interface AutofillApi {
956
915
  /**
957
916
  * Trigger autofill on a form identified by the fieldId.
@@ -1021,6 +980,125 @@ export namespace ProtocolTestsProxyApi {
1021
980
 
1022
981
  }
1023
982
 
983
+ export interface BluetoothEmulationApi {
984
+ /**
985
+ * Enable the BluetoothEmulation domain.
986
+ */
987
+ enable(params: Protocol.BluetoothEmulation.EnableRequest): Promise<{id: number, result: void, sessionId: string}>;
988
+
989
+ /**
990
+ * Set the state of the simulated central.
991
+ */
992
+ setSimulatedCentralState(params: Protocol.BluetoothEmulation.SetSimulatedCentralStateRequest): Promise<{id: number, result: void, sessionId: string}>;
993
+
994
+ /**
995
+ * Disable the BluetoothEmulation domain.
996
+ */
997
+ disable(): Promise<{id: number, result: void, sessionId: string}>;
998
+
999
+ /**
1000
+ * Simulates a peripheral with |address|, |name| and |knownServiceUuids|
1001
+ * that has already been connected to the system.
1002
+ */
1003
+ simulatePreconnectedPeripheral(params: Protocol.BluetoothEmulation.SimulatePreconnectedPeripheralRequest): Promise<{id: number, result: void, sessionId: string}>;
1004
+
1005
+ /**
1006
+ * Simulates an advertisement packet described in |entry| being received by
1007
+ * the central.
1008
+ */
1009
+ simulateAdvertisement(params: Protocol.BluetoothEmulation.SimulateAdvertisementRequest): Promise<{id: number, result: void, sessionId: string}>;
1010
+
1011
+ /**
1012
+ * Simulates the response code from the peripheral with |address| for a
1013
+ * GATT operation of |type|. The |code| value follows the HCI Error Codes from
1014
+ * Bluetooth Core Specification Vol 2 Part D 1.3 List Of Error Codes.
1015
+ */
1016
+ simulateGATTOperationResponse(params: Protocol.BluetoothEmulation.SimulateGATTOperationResponseRequest): Promise<{id: number, result: void, sessionId: string}>;
1017
+
1018
+ /**
1019
+ * Simulates the response from the characteristic with |characteristicId| for a
1020
+ * characteristic operation of |type|. The |code| value follows the Error
1021
+ * Codes from Bluetooth Core Specification Vol 3 Part F 3.4.1.1 Error Response.
1022
+ * The |data| is expected to exist when simulating a successful read operation
1023
+ * response.
1024
+ */
1025
+ simulateCharacteristicOperationResponse(params: Protocol.BluetoothEmulation.SimulateCharacteristicOperationResponseRequest): Promise<{id: number, result: void, sessionId: string}>;
1026
+
1027
+ /**
1028
+ * Simulates the response from the descriptor with |descriptorId| for a
1029
+ * descriptor operation of |type|. The |code| value follows the Error
1030
+ * Codes from Bluetooth Core Specification Vol 3 Part F 3.4.1.1 Error Response.
1031
+ * The |data| is expected to exist when simulating a successful read operation
1032
+ * response.
1033
+ */
1034
+ simulateDescriptorOperationResponse(params: Protocol.BluetoothEmulation.SimulateDescriptorOperationResponseRequest): Promise<{id: number, result: void, sessionId: string}>;
1035
+
1036
+ /**
1037
+ * Adds a service with |serviceUuid| to the peripheral with |address|.
1038
+ */
1039
+ addService(params: Protocol.BluetoothEmulation.AddServiceRequest): Promise<{id: number, result: Protocol.BluetoothEmulation.AddServiceResponse, sessionId: string}>;
1040
+
1041
+ /**
1042
+ * Removes the service respresented by |serviceId| from the simulated central.
1043
+ */
1044
+ removeService(params: Protocol.BluetoothEmulation.RemoveServiceRequest): Promise<{id: number, result: void, sessionId: string}>;
1045
+
1046
+ /**
1047
+ * Adds a characteristic with |characteristicUuid| and |properties| to the
1048
+ * service represented by |serviceId|.
1049
+ */
1050
+ addCharacteristic(params: Protocol.BluetoothEmulation.AddCharacteristicRequest): Promise<{id: number, result: Protocol.BluetoothEmulation.AddCharacteristicResponse, sessionId: string}>;
1051
+
1052
+ /**
1053
+ * Removes the characteristic respresented by |characteristicId| from the
1054
+ * simulated central.
1055
+ */
1056
+ removeCharacteristic(params: Protocol.BluetoothEmulation.RemoveCharacteristicRequest): Promise<{id: number, result: void, sessionId: string}>;
1057
+
1058
+ /**
1059
+ * Adds a descriptor with |descriptorUuid| to the characteristic respresented
1060
+ * by |characteristicId|.
1061
+ */
1062
+ addDescriptor(params: Protocol.BluetoothEmulation.AddDescriptorRequest): Promise<{id: number, result: Protocol.BluetoothEmulation.AddDescriptorResponse, sessionId: string}>;
1063
+
1064
+ /**
1065
+ * Removes the descriptor with |descriptorId| from the simulated central.
1066
+ */
1067
+ removeDescriptor(params: Protocol.BluetoothEmulation.RemoveDescriptorRequest): Promise<{id: number, result: void, sessionId: string}>;
1068
+
1069
+ /**
1070
+ * Simulates a GATT disconnection from the peripheral with |address|.
1071
+ */
1072
+ simulateGATTDisconnection(params: Protocol.BluetoothEmulation.SimulateGATTDisconnectionRequest): Promise<{id: number, result: void, sessionId: string}>;
1073
+
1074
+ /**
1075
+ * Event for when a GATT operation of |type| to the peripheral with |address|
1076
+ * happened.
1077
+ */
1078
+ onGattOperationReceived(listener: (event: { params: Protocol.BluetoothEmulation.GattOperationReceivedEvent }) => void): void;
1079
+ offGattOperationReceived(listener: (event: { params: Protocol.BluetoothEmulation.GattOperationReceivedEvent }) => void): void;
1080
+ onceGattOperationReceived(eventMatcher?: (event: { params: Protocol.BluetoothEmulation.GattOperationReceivedEvent }) => boolean): Promise<{ params: Protocol.BluetoothEmulation.GattOperationReceivedEvent }>;
1081
+
1082
+ /**
1083
+ * Event for when a characteristic operation of |type| to the characteristic
1084
+ * respresented by |characteristicId| happened. |data| and |writeType| is
1085
+ * expected to exist when |type| is write.
1086
+ */
1087
+ onCharacteristicOperationReceived(listener: (event: { params: Protocol.BluetoothEmulation.CharacteristicOperationReceivedEvent }) => void): void;
1088
+ offCharacteristicOperationReceived(listener: (event: { params: Protocol.BluetoothEmulation.CharacteristicOperationReceivedEvent }) => void): void;
1089
+ onceCharacteristicOperationReceived(eventMatcher?: (event: { params: Protocol.BluetoothEmulation.CharacteristicOperationReceivedEvent }) => boolean): Promise<{ params: Protocol.BluetoothEmulation.CharacteristicOperationReceivedEvent }>;
1090
+
1091
+ /**
1092
+ * Event for when a descriptor operation of |type| to the descriptor
1093
+ * respresented by |descriptorId| happened. |data| is expected to exist when
1094
+ * |type| is write.
1095
+ */
1096
+ onDescriptorOperationReceived(listener: (event: { params: Protocol.BluetoothEmulation.DescriptorOperationReceivedEvent }) => void): void;
1097
+ offDescriptorOperationReceived(listener: (event: { params: Protocol.BluetoothEmulation.DescriptorOperationReceivedEvent }) => void): void;
1098
+ onceDescriptorOperationReceived(eventMatcher?: (event: { params: Protocol.BluetoothEmulation.DescriptorOperationReceivedEvent }) => boolean): Promise<{ params: Protocol.BluetoothEmulation.DescriptorOperationReceivedEvent }>;
1099
+
1100
+ }
1101
+
1024
1102
  export interface BrowserApi {
1025
1103
  /**
1026
1104
  * Set permission settings for given origin.
@@ -2015,24 +2093,6 @@ export namespace ProtocolTestsProxyApi {
2015
2093
 
2016
2094
  }
2017
2095
 
2018
- export interface EventBreakpointsApi {
2019
- /**
2020
- * Sets breakpoint on particular native event.
2021
- */
2022
- setInstrumentationBreakpoint(params: Protocol.EventBreakpoints.SetInstrumentationBreakpointRequest): Promise<{id: number, result: void, sessionId: string}>;
2023
-
2024
- /**
2025
- * Removes breakpoint on particular native event.
2026
- */
2027
- removeInstrumentationBreakpoint(params: Protocol.EventBreakpoints.RemoveInstrumentationBreakpointRequest): Promise<{id: number, result: void, sessionId: string}>;
2028
-
2029
- /**
2030
- * Removes all breakpoints
2031
- */
2032
- disable(): Promise<{id: number, result: void, sessionId: string}>;
2033
-
2034
- }
2035
-
2036
2096
  export interface DOMSnapshotApi {
2037
2097
  /**
2038
2098
  * Disables DOM snapshot agent for the given page.
@@ -2100,6 +2160,37 @@ export namespace ProtocolTestsProxyApi {
2100
2160
 
2101
2161
  }
2102
2162
 
2163
+ export interface DeviceAccessApi {
2164
+ /**
2165
+ * Enable events in this domain.
2166
+ */
2167
+ enable(): Promise<{id: number, result: void, sessionId: string}>;
2168
+
2169
+ /**
2170
+ * Disable events in this domain.
2171
+ */
2172
+ disable(): Promise<{id: number, result: void, sessionId: string}>;
2173
+
2174
+ /**
2175
+ * Select a device in response to a DeviceAccess.deviceRequestPrompted event.
2176
+ */
2177
+ selectPrompt(params: Protocol.DeviceAccess.SelectPromptRequest): Promise<{id: number, result: void, sessionId: string}>;
2178
+
2179
+ /**
2180
+ * Cancel a prompt in response to a DeviceAccess.deviceRequestPrompted event.
2181
+ */
2182
+ cancelPrompt(params: Protocol.DeviceAccess.CancelPromptRequest): Promise<{id: number, result: void, sessionId: string}>;
2183
+
2184
+ /**
2185
+ * A device request opened a user prompt to select a device. Respond with the
2186
+ * selectPrompt or cancelPrompt command.
2187
+ */
2188
+ onDeviceRequestPrompted(listener: (event: { params: Protocol.DeviceAccess.DeviceRequestPromptedEvent }) => void): void;
2189
+ offDeviceRequestPrompted(listener: (event: { params: Protocol.DeviceAccess.DeviceRequestPromptedEvent }) => void): void;
2190
+ onceDeviceRequestPrompted(eventMatcher?: (event: { params: Protocol.DeviceAccess.DeviceRequestPromptedEvent }) => boolean): Promise<{ params: Protocol.DeviceAccess.DeviceRequestPromptedEvent }>;
2191
+
2192
+ }
2193
+
2103
2194
  export interface DeviceOrientationApi {
2104
2195
  /**
2105
2196
  * Clears the overridden Device Orientation.
@@ -2385,16 +2476,226 @@ export namespace ProtocolTestsProxyApi {
2385
2476
  setSmallViewportHeightDifferenceOverride(params: Protocol.Emulation.SetSmallViewportHeightDifferenceOverrideRequest): Promise<{id: number, result: void, sessionId: string}>;
2386
2477
 
2387
2478
  /**
2388
- * Notification sent after the virtual time budget for the current VirtualTimePolicy has run out.
2479
+ * Returns device's screen configuration.
2389
2480
  * @experimental
2390
2481
  */
2391
- onVirtualTimeBudgetExpired(listener: () => void): void;
2392
- offVirtualTimeBudgetExpired(listener: () => void): void;
2393
- onceVirtualTimeBudgetExpired(eventMatcher?: () => boolean): Promise<void>;
2394
-
2395
- }
2482
+ getScreenInfos(): Promise<{id: number, result: Protocol.Emulation.GetScreenInfosResponse, sessionId: string}>;
2396
2483
 
2397
- export interface HeadlessExperimentalApi {
2484
+ /**
2485
+ * Add a new screen to the device. Only supported in headless mode.
2486
+ * @experimental
2487
+ */
2488
+ addScreen(params: Protocol.Emulation.AddScreenRequest): Promise<{id: number, result: Protocol.Emulation.AddScreenResponse, sessionId: string}>;
2489
+
2490
+ /**
2491
+ * Remove screen from the device. Only supported in headless mode.
2492
+ * @experimental
2493
+ */
2494
+ removeScreen(params: Protocol.Emulation.RemoveScreenRequest): Promise<{id: number, result: void, sessionId: string}>;
2495
+
2496
+ /**
2497
+ * Notification sent after the virtual time budget for the current VirtualTimePolicy has run out.
2498
+ * @experimental
2499
+ */
2500
+ onVirtualTimeBudgetExpired(listener: () => void): void;
2501
+ offVirtualTimeBudgetExpired(listener: () => void): void;
2502
+ onceVirtualTimeBudgetExpired(eventMatcher?: () => boolean): Promise<void>;
2503
+
2504
+ }
2505
+
2506
+ export interface EventBreakpointsApi {
2507
+ /**
2508
+ * Sets breakpoint on particular native event.
2509
+ */
2510
+ setInstrumentationBreakpoint(params: Protocol.EventBreakpoints.SetInstrumentationBreakpointRequest): Promise<{id: number, result: void, sessionId: string}>;
2511
+
2512
+ /**
2513
+ * Removes breakpoint on particular native event.
2514
+ */
2515
+ removeInstrumentationBreakpoint(params: Protocol.EventBreakpoints.RemoveInstrumentationBreakpointRequest): Promise<{id: number, result: void, sessionId: string}>;
2516
+
2517
+ /**
2518
+ * Removes all breakpoints
2519
+ */
2520
+ disable(): Promise<{id: number, result: void, sessionId: string}>;
2521
+
2522
+ }
2523
+
2524
+ export interface ExtensionsApi {
2525
+ /**
2526
+ * Installs an unpacked extension from the filesystem similar to
2527
+ * --load-extension CLI flags. Returns extension ID once the extension
2528
+ * has been installed. Available if the client is connected using the
2529
+ * --remote-debugging-pipe flag and the --enable-unsafe-extension-debugging
2530
+ * flag is set.
2531
+ */
2532
+ loadUnpacked(params: Protocol.Extensions.LoadUnpackedRequest): Promise<{id: number, result: Protocol.Extensions.LoadUnpackedResponse, sessionId: string}>;
2533
+
2534
+ /**
2535
+ * Uninstalls an unpacked extension (others not supported) from the profile.
2536
+ * Available if the client is connected using the --remote-debugging-pipe flag
2537
+ * and the --enable-unsafe-extension-debugging.
2538
+ */
2539
+ uninstall(params: Protocol.Extensions.UninstallRequest): Promise<{id: number, result: void, sessionId: string}>;
2540
+
2541
+ /**
2542
+ * Gets data from extension storage in the given `storageArea`. If `keys` is
2543
+ * specified, these are used to filter the result.
2544
+ */
2545
+ getStorageItems(params: Protocol.Extensions.GetStorageItemsRequest): Promise<{id: number, result: Protocol.Extensions.GetStorageItemsResponse, sessionId: string}>;
2546
+
2547
+ /**
2548
+ * Removes `keys` from extension storage in the given `storageArea`.
2549
+ */
2550
+ removeStorageItems(params: Protocol.Extensions.RemoveStorageItemsRequest): Promise<{id: number, result: void, sessionId: string}>;
2551
+
2552
+ /**
2553
+ * Clears extension storage in the given `storageArea`.
2554
+ */
2555
+ clearStorageItems(params: Protocol.Extensions.ClearStorageItemsRequest): Promise<{id: number, result: void, sessionId: string}>;
2556
+
2557
+ /**
2558
+ * Sets `values` in extension storage in the given `storageArea`. The provided `values`
2559
+ * will be merged with existing values in the storage area.
2560
+ */
2561
+ setStorageItems(params: Protocol.Extensions.SetStorageItemsRequest): Promise<{id: number, result: void, sessionId: string}>;
2562
+
2563
+ }
2564
+
2565
+ export interface FedCmApi {
2566
+ enable(params: Protocol.FedCm.EnableRequest): Promise<{id: number, result: void, sessionId: string}>;
2567
+
2568
+ disable(): Promise<{id: number, result: void, sessionId: string}>;
2569
+
2570
+ selectAccount(params: Protocol.FedCm.SelectAccountRequest): Promise<{id: number, result: void, sessionId: string}>;
2571
+
2572
+ clickDialogButton(params: Protocol.FedCm.ClickDialogButtonRequest): Promise<{id: number, result: void, sessionId: string}>;
2573
+
2574
+ openUrl(params: Protocol.FedCm.OpenUrlRequest): Promise<{id: number, result: void, sessionId: string}>;
2575
+
2576
+ dismissDialog(params: Protocol.FedCm.DismissDialogRequest): Promise<{id: number, result: void, sessionId: string}>;
2577
+
2578
+ /**
2579
+ * Resets the cooldown time, if any, to allow the next FedCM call to show
2580
+ * a dialog even if one was recently dismissed by the user.
2581
+ */
2582
+ resetCooldown(): Promise<{id: number, result: void, sessionId: string}>;
2583
+
2584
+ onDialogShown(listener: (event: { params: Protocol.FedCm.DialogShownEvent }) => void): void;
2585
+ offDialogShown(listener: (event: { params: Protocol.FedCm.DialogShownEvent }) => void): void;
2586
+ onceDialogShown(eventMatcher?: (event: { params: Protocol.FedCm.DialogShownEvent }) => boolean): Promise<{ params: Protocol.FedCm.DialogShownEvent }>;
2587
+
2588
+ /**
2589
+ * Triggered when a dialog is closed, either by user action, JS abort,
2590
+ * or a command below.
2591
+ */
2592
+ onDialogClosed(listener: (event: { params: Protocol.FedCm.DialogClosedEvent }) => void): void;
2593
+ offDialogClosed(listener: (event: { params: Protocol.FedCm.DialogClosedEvent }) => void): void;
2594
+ onceDialogClosed(eventMatcher?: (event: { params: Protocol.FedCm.DialogClosedEvent }) => boolean): Promise<{ params: Protocol.FedCm.DialogClosedEvent }>;
2595
+
2596
+ }
2597
+
2598
+ export interface FetchApi {
2599
+ /**
2600
+ * Disables the fetch domain.
2601
+ */
2602
+ disable(): Promise<{id: number, result: void, sessionId: string}>;
2603
+
2604
+ /**
2605
+ * Enables issuing of requestPaused events. A request will be paused until client
2606
+ * calls one of failRequest, fulfillRequest or continueRequest/continueWithAuth.
2607
+ */
2608
+ enable(params: Protocol.Fetch.EnableRequest): Promise<{id: number, result: void, sessionId: string}>;
2609
+
2610
+ /**
2611
+ * Causes the request to fail with specified reason.
2612
+ */
2613
+ failRequest(params: Protocol.Fetch.FailRequestRequest): Promise<{id: number, result: void, sessionId: string}>;
2614
+
2615
+ /**
2616
+ * Provides response to the request.
2617
+ */
2618
+ fulfillRequest(params: Protocol.Fetch.FulfillRequestRequest): Promise<{id: number, result: void, sessionId: string}>;
2619
+
2620
+ /**
2621
+ * Continues the request, optionally modifying some of its parameters.
2622
+ */
2623
+ continueRequest(params: Protocol.Fetch.ContinueRequestRequest): Promise<{id: number, result: void, sessionId: string}>;
2624
+
2625
+ /**
2626
+ * Continues a request supplying authChallengeResponse following authRequired event.
2627
+ */
2628
+ continueWithAuth(params: Protocol.Fetch.ContinueWithAuthRequest): Promise<{id: number, result: void, sessionId: string}>;
2629
+
2630
+ /**
2631
+ * Continues loading of the paused response, optionally modifying the
2632
+ * response headers. If either responseCode or headers are modified, all of them
2633
+ * must be present.
2634
+ * @experimental
2635
+ */
2636
+ continueResponse(params: Protocol.Fetch.ContinueResponseRequest): Promise<{id: number, result: void, sessionId: string}>;
2637
+
2638
+ /**
2639
+ * Causes the body of the response to be received from the server and
2640
+ * returned as a single string. May only be issued for a request that
2641
+ * is paused in the Response stage and is mutually exclusive with
2642
+ * takeResponseBodyForInterceptionAsStream. Calling other methods that
2643
+ * affect the request or disabling fetch domain before body is received
2644
+ * results in an undefined behavior.
2645
+ * Note that the response body is not available for redirects. Requests
2646
+ * paused in the _redirect received_ state may be differentiated by
2647
+ * `responseCode` and presence of `location` response header, see
2648
+ * comments to `requestPaused` for details.
2649
+ */
2650
+ getResponseBody(params: Protocol.Fetch.GetResponseBodyRequest): Promise<{id: number, result: Protocol.Fetch.GetResponseBodyResponse, sessionId: string}>;
2651
+
2652
+ /**
2653
+ * Returns a handle to the stream representing the response body.
2654
+ * The request must be paused in the HeadersReceived stage.
2655
+ * Note that after this command the request can't be continued
2656
+ * as is -- client either needs to cancel it or to provide the
2657
+ * response body.
2658
+ * The stream only supports sequential read, IO.read will fail if the position
2659
+ * is specified.
2660
+ * This method is mutually exclusive with getResponseBody.
2661
+ * Calling other methods that affect the request or disabling fetch
2662
+ * domain before body is received results in an undefined behavior.
2663
+ */
2664
+ takeResponseBodyAsStream(params: Protocol.Fetch.TakeResponseBodyAsStreamRequest): Promise<{id: number, result: Protocol.Fetch.TakeResponseBodyAsStreamResponse, sessionId: string}>;
2665
+
2666
+ /**
2667
+ * Issued when the domain is enabled and the request URL matches the
2668
+ * specified filter. The request is paused until the client responds
2669
+ * with one of continueRequest, failRequest or fulfillRequest.
2670
+ * The stage of the request can be determined by presence of responseErrorReason
2671
+ * and responseStatusCode -- the request is at the response stage if either
2672
+ * of these fields is present and in the request stage otherwise.
2673
+ * Redirect responses and subsequent requests are reported similarly to regular
2674
+ * responses and requests. Redirect responses may be distinguished by the value
2675
+ * of `responseStatusCode` (which is one of 301, 302, 303, 307, 308) along with
2676
+ * presence of the `location` header. Requests resulting from a redirect will
2677
+ * have `redirectedRequestId` field set.
2678
+ */
2679
+ onRequestPaused(listener: (event: { params: Protocol.Fetch.RequestPausedEvent }) => void): void;
2680
+ offRequestPaused(listener: (event: { params: Protocol.Fetch.RequestPausedEvent }) => void): void;
2681
+ onceRequestPaused(eventMatcher?: (event: { params: Protocol.Fetch.RequestPausedEvent }) => boolean): Promise<{ params: Protocol.Fetch.RequestPausedEvent }>;
2682
+
2683
+ /**
2684
+ * Issued when the domain is enabled with handleAuthRequests set to true.
2685
+ * The request is paused until client responds with continueWithAuth.
2686
+ */
2687
+ onAuthRequired(listener: (event: { params: Protocol.Fetch.AuthRequiredEvent }) => void): void;
2688
+ offAuthRequired(listener: (event: { params: Protocol.Fetch.AuthRequiredEvent }) => void): void;
2689
+ onceAuthRequired(eventMatcher?: (event: { params: Protocol.Fetch.AuthRequiredEvent }) => boolean): Promise<{ params: Protocol.Fetch.AuthRequiredEvent }>;
2690
+
2691
+ }
2692
+
2693
+ export interface FileSystemApi {
2694
+ getDirectory(params: Protocol.FileSystem.GetDirectoryRequest): Promise<{id: number, result: Protocol.FileSystem.GetDirectoryResponse, sessionId: string}>;
2695
+
2696
+ }
2697
+
2698
+ export interface HeadlessExperimentalApi {
2398
2699
  /**
2399
2700
  * Sends a BeginFrame to the target and returns when the frame was completed. Optionally captures a
2400
2701
  * screenshot from the resulting frame. Requires that the target was created with enabled
@@ -2435,11 +2736,6 @@ export namespace ProtocolTestsProxyApi {
2435
2736
 
2436
2737
  }
2437
2738
 
2438
- export interface FileSystemApi {
2439
- getDirectory(params: Protocol.FileSystem.GetDirectoryRequest): Promise<{id: number, result: Protocol.FileSystem.GetDirectoryResponse, sessionId: string}>;
2440
-
2441
- }
2442
-
2443
2739
  export interface IndexedDBApi {
2444
2740
  /**
2445
2741
  * Clears all entries from an object store.
@@ -2700,42 +2996,94 @@ export namespace ProtocolTestsProxyApi {
2700
2996
 
2701
2997
  }
2702
2998
 
2703
- export interface MemoryApi {
2999
+ export interface MediaApi {
2704
3000
  /**
2705
- * Retruns current DOM object counters.
3001
+ * Enables the Media domain
2706
3002
  */
2707
- getDOMCounters(): Promise<{id: number, result: Protocol.Memory.GetDOMCountersResponse, sessionId: string}>;
3003
+ enable(): Promise<{id: number, result: void, sessionId: string}>;
2708
3004
 
2709
3005
  /**
2710
- * Retruns DOM object counters after preparing renderer for leak detection.
3006
+ * Disables the Media domain.
2711
3007
  */
2712
- getDOMCountersForLeakDetection(): Promise<{id: number, result: Protocol.Memory.GetDOMCountersForLeakDetectionResponse, sessionId: string}>;
3008
+ disable(): Promise<{id: number, result: void, sessionId: string}>;
2713
3009
 
2714
3010
  /**
2715
- * Prepares for leak detection by terminating workers, stopping spellcheckers,
2716
- * dropping non-essential internal caches, running garbage collections, etc.
3011
+ * This can be called multiple times, and can be used to set / override /
3012
+ * remove player properties. A null propValue indicates removal.
2717
3013
  */
2718
- prepareForLeakDetection(): Promise<{id: number, result: void, sessionId: string}>;
3014
+ onPlayerPropertiesChanged(listener: (event: { params: Protocol.Media.PlayerPropertiesChangedEvent }) => void): void;
3015
+ offPlayerPropertiesChanged(listener: (event: { params: Protocol.Media.PlayerPropertiesChangedEvent }) => void): void;
3016
+ oncePlayerPropertiesChanged(eventMatcher?: (event: { params: Protocol.Media.PlayerPropertiesChangedEvent }) => boolean): Promise<{ params: Protocol.Media.PlayerPropertiesChangedEvent }>;
2719
3017
 
2720
3018
  /**
2721
- * Simulate OomIntervention by purging V8 memory.
3019
+ * Send events as a list, allowing them to be batched on the browser for less
3020
+ * congestion. If batched, events must ALWAYS be in chronological order.
2722
3021
  */
2723
- forciblyPurgeJavaScriptMemory(): Promise<{id: number, result: void, sessionId: string}>;
3022
+ onPlayerEventsAdded(listener: (event: { params: Protocol.Media.PlayerEventsAddedEvent }) => void): void;
3023
+ offPlayerEventsAdded(listener: (event: { params: Protocol.Media.PlayerEventsAddedEvent }) => void): void;
3024
+ oncePlayerEventsAdded(eventMatcher?: (event: { params: Protocol.Media.PlayerEventsAddedEvent }) => boolean): Promise<{ params: Protocol.Media.PlayerEventsAddedEvent }>;
2724
3025
 
2725
3026
  /**
2726
- * Enable/disable suppressing memory pressure notifications in all processes.
3027
+ * Send a list of any messages that need to be delivered.
2727
3028
  */
2728
- setPressureNotificationsSuppressed(params: Protocol.Memory.SetPressureNotificationsSuppressedRequest): Promise<{id: number, result: void, sessionId: string}>;
3029
+ onPlayerMessagesLogged(listener: (event: { params: Protocol.Media.PlayerMessagesLoggedEvent }) => void): void;
3030
+ offPlayerMessagesLogged(listener: (event: { params: Protocol.Media.PlayerMessagesLoggedEvent }) => void): void;
3031
+ oncePlayerMessagesLogged(eventMatcher?: (event: { params: Protocol.Media.PlayerMessagesLoggedEvent }) => boolean): Promise<{ params: Protocol.Media.PlayerMessagesLoggedEvent }>;
2729
3032
 
2730
3033
  /**
2731
- * Simulate a memory pressure notification in all processes.
3034
+ * Send a list of any errors that need to be delivered.
2732
3035
  */
2733
- simulatePressureNotification(params: Protocol.Memory.SimulatePressureNotificationRequest): Promise<{id: number, result: void, sessionId: string}>;
3036
+ onPlayerErrorsRaised(listener: (event: { params: Protocol.Media.PlayerErrorsRaisedEvent }) => void): void;
3037
+ offPlayerErrorsRaised(listener: (event: { params: Protocol.Media.PlayerErrorsRaisedEvent }) => void): void;
3038
+ oncePlayerErrorsRaised(eventMatcher?: (event: { params: Protocol.Media.PlayerErrorsRaisedEvent }) => boolean): Promise<{ params: Protocol.Media.PlayerErrorsRaisedEvent }>;
2734
3039
 
2735
3040
  /**
2736
- * Start collecting native memory profile.
2737
- */
2738
- startSampling(params: Protocol.Memory.StartSamplingRequest): Promise<{id: number, result: void, sessionId: string}>;
3041
+ * Called whenever a player is created, or when a new agent joins and receives
3042
+ * a list of active players. If an agent is restored, it will receive the full
3043
+ * list of player ids and all events again.
3044
+ */
3045
+ onPlayersCreated(listener: (event: { params: Protocol.Media.PlayersCreatedEvent }) => void): void;
3046
+ offPlayersCreated(listener: (event: { params: Protocol.Media.PlayersCreatedEvent }) => void): void;
3047
+ oncePlayersCreated(eventMatcher?: (event: { params: Protocol.Media.PlayersCreatedEvent }) => boolean): Promise<{ params: Protocol.Media.PlayersCreatedEvent }>;
3048
+
3049
+ }
3050
+
3051
+ export interface MemoryApi {
3052
+ /**
3053
+ * Retruns current DOM object counters.
3054
+ */
3055
+ getDOMCounters(): Promise<{id: number, result: Protocol.Memory.GetDOMCountersResponse, sessionId: string}>;
3056
+
3057
+ /**
3058
+ * Retruns DOM object counters after preparing renderer for leak detection.
3059
+ */
3060
+ getDOMCountersForLeakDetection(): Promise<{id: number, result: Protocol.Memory.GetDOMCountersForLeakDetectionResponse, sessionId: string}>;
3061
+
3062
+ /**
3063
+ * Prepares for leak detection by terminating workers, stopping spellcheckers,
3064
+ * dropping non-essential internal caches, running garbage collections, etc.
3065
+ */
3066
+ prepareForLeakDetection(): Promise<{id: number, result: void, sessionId: string}>;
3067
+
3068
+ /**
3069
+ * Simulate OomIntervention by purging V8 memory.
3070
+ */
3071
+ forciblyPurgeJavaScriptMemory(): Promise<{id: number, result: void, sessionId: string}>;
3072
+
3073
+ /**
3074
+ * Enable/disable suppressing memory pressure notifications in all processes.
3075
+ */
3076
+ setPressureNotificationsSuppressed(params: Protocol.Memory.SetPressureNotificationsSuppressedRequest): Promise<{id: number, result: void, sessionId: string}>;
3077
+
3078
+ /**
3079
+ * Simulate a memory pressure notification in all processes.
3080
+ */
3081
+ simulatePressureNotification(params: Protocol.Memory.SimulatePressureNotificationRequest): Promise<{id: number, result: void, sessionId: string}>;
3082
+
3083
+ /**
3084
+ * Start collecting native memory profile.
3085
+ */
3086
+ startSampling(params: Protocol.Memory.StartSamplingRequest): Promise<{id: number, result: void, sessionId: string}>;
2739
3087
 
2740
3088
  /**
2741
3089
  * Stop collecting native memory profile.
@@ -3380,6 +3728,9 @@ export namespace ProtocolTestsProxyApi {
3380
3728
 
3381
3729
  /**
3382
3730
  * Highlights given rectangle. Coordinates are absolute with respect to the main frame viewport.
3731
+ * Issue: the method does not handle device pixel ratio (DPR) correctly.
3732
+ * The coordinates currently have to be adjusted by the client
3733
+ * if DPR is not 1 (see crbug.com/437807128).
3383
3734
  */
3384
3735
  highlightRect(params: Protocol.Overlay.HighlightRectRequest): Promise<{id: number, result: void, sessionId: string}>;
3385
3736
 
@@ -3501,6 +3852,92 @@ export namespace ProtocolTestsProxyApi {
3501
3852
 
3502
3853
  }
3503
3854
 
3855
+ export interface PWAApi {
3856
+ /**
3857
+ * Returns the following OS state for the given manifest id.
3858
+ */
3859
+ getOsAppState(params: Protocol.PWA.GetOsAppStateRequest): Promise<{id: number, result: Protocol.PWA.GetOsAppStateResponse, sessionId: string}>;
3860
+
3861
+ /**
3862
+ * Installs the given manifest identity, optionally using the given installUrlOrBundleUrl
3863
+ *
3864
+ * IWA-specific install description:
3865
+ * manifestId corresponds to isolated-app:// + web_package::SignedWebBundleId
3866
+ *
3867
+ * File installation mode:
3868
+ * The installUrlOrBundleUrl can be either file:// or http(s):// pointing
3869
+ * to a signed web bundle (.swbn). In this case SignedWebBundleId must correspond to
3870
+ * The .swbn file's signing key.
3871
+ *
3872
+ * Dev proxy installation mode:
3873
+ * installUrlOrBundleUrl must be http(s):// that serves dev mode IWA.
3874
+ * web_package::SignedWebBundleId must be of type dev proxy.
3875
+ *
3876
+ * The advantage of dev proxy mode is that all changes to IWA
3877
+ * automatically will be reflected in the running app without
3878
+ * reinstallation.
3879
+ *
3880
+ * To generate bundle id for proxy mode:
3881
+ * 1. Generate 32 random bytes.
3882
+ * 2. Add a specific suffix 0x00 at the end.
3883
+ * 3. Encode the entire sequence using Base32 without padding.
3884
+ *
3885
+ * If Chrome is not in IWA dev
3886
+ * mode, the installation will fail, regardless of the state of the allowlist.
3887
+ */
3888
+ install(params: Protocol.PWA.InstallRequest): Promise<{id: number, result: void, sessionId: string}>;
3889
+
3890
+ /**
3891
+ * Uninstalls the given manifest_id and closes any opened app windows.
3892
+ */
3893
+ uninstall(params: Protocol.PWA.UninstallRequest): Promise<{id: number, result: void, sessionId: string}>;
3894
+
3895
+ /**
3896
+ * Launches the installed web app, or an url in the same web app instead of the
3897
+ * default start url if it is provided. Returns a page Target.TargetID which
3898
+ * can be used to attach to via Target.attachToTarget or similar APIs.
3899
+ */
3900
+ launch(params: Protocol.PWA.LaunchRequest): Promise<{id: number, result: Protocol.PWA.LaunchResponse, sessionId: string}>;
3901
+
3902
+ /**
3903
+ * Opens one or more local files from an installed web app identified by its
3904
+ * manifestId. The web app needs to have file handlers registered to process
3905
+ * the files. The API returns one or more page Target.TargetIDs which can be
3906
+ * used to attach to via Target.attachToTarget or similar APIs.
3907
+ * If some files in the parameters cannot be handled by the web app, they will
3908
+ * be ignored. If none of the files can be handled, this API returns an error.
3909
+ * If no files are provided as the parameter, this API also returns an error.
3910
+ *
3911
+ * According to the definition of the file handlers in the manifest file, one
3912
+ * Target.TargetID may represent a page handling one or more files. The order
3913
+ * of the returned Target.TargetIDs is not guaranteed.
3914
+ *
3915
+ * TODO(crbug.com/339454034): Check the existences of the input files.
3916
+ */
3917
+ launchFilesInApp(params: Protocol.PWA.LaunchFilesInAppRequest): Promise<{id: number, result: Protocol.PWA.LaunchFilesInAppResponse, sessionId: string}>;
3918
+
3919
+ /**
3920
+ * Opens the current page in its web app identified by the manifest id, needs
3921
+ * to be called on a page target. This function returns immediately without
3922
+ * waiting for the app to finish loading.
3923
+ */
3924
+ openCurrentPageInApp(params: Protocol.PWA.OpenCurrentPageInAppRequest): Promise<{id: number, result: void, sessionId: string}>;
3925
+
3926
+ /**
3927
+ * Changes user settings of the web app identified by its manifestId. If the
3928
+ * app was not installed, this command returns an error. Unset parameters will
3929
+ * be ignored; unrecognized values will cause an error.
3930
+ *
3931
+ * Unlike the ones defined in the manifest files of the web apps, these
3932
+ * settings are provided by the browser and controlled by the users, they
3933
+ * impact the way the browser handling the web apps.
3934
+ *
3935
+ * See the comment of each parameter.
3936
+ */
3937
+ changeAppUserSettings(params: Protocol.PWA.ChangeAppUserSettingsRequest): Promise<{id: number, result: void, sessionId: string}>;
3938
+
3939
+ }
3940
+
3504
3941
  export interface PageApi {
3505
3942
  /**
3506
3943
  * Deprecated, please use addScriptToEvaluateOnNewDocument instead.
@@ -4150,6 +4587,52 @@ export namespace ProtocolTestsProxyApi {
4150
4587
 
4151
4588
  }
4152
4589
 
4590
+ export interface PreloadApi {
4591
+ enable(): Promise<{id: number, result: void, sessionId: string}>;
4592
+
4593
+ disable(): Promise<{id: number, result: void, sessionId: string}>;
4594
+
4595
+ /**
4596
+ * Upsert. Currently, it is only emitted when a rule set added.
4597
+ */
4598
+ onRuleSetUpdated(listener: (event: { params: Protocol.Preload.RuleSetUpdatedEvent }) => void): void;
4599
+ offRuleSetUpdated(listener: (event: { params: Protocol.Preload.RuleSetUpdatedEvent }) => void): void;
4600
+ onceRuleSetUpdated(eventMatcher?: (event: { params: Protocol.Preload.RuleSetUpdatedEvent }) => boolean): Promise<{ params: Protocol.Preload.RuleSetUpdatedEvent }>;
4601
+
4602
+ onRuleSetRemoved(listener: (event: { params: Protocol.Preload.RuleSetRemovedEvent }) => void): void;
4603
+ offRuleSetRemoved(listener: (event: { params: Protocol.Preload.RuleSetRemovedEvent }) => void): void;
4604
+ onceRuleSetRemoved(eventMatcher?: (event: { params: Protocol.Preload.RuleSetRemovedEvent }) => boolean): Promise<{ params: Protocol.Preload.RuleSetRemovedEvent }>;
4605
+
4606
+ /**
4607
+ * Fired when a preload enabled state is updated.
4608
+ */
4609
+ onPreloadEnabledStateUpdated(listener: (event: { params: Protocol.Preload.PreloadEnabledStateUpdatedEvent }) => void): void;
4610
+ offPreloadEnabledStateUpdated(listener: (event: { params: Protocol.Preload.PreloadEnabledStateUpdatedEvent }) => void): void;
4611
+ oncePreloadEnabledStateUpdated(eventMatcher?: (event: { params: Protocol.Preload.PreloadEnabledStateUpdatedEvent }) => boolean): Promise<{ params: Protocol.Preload.PreloadEnabledStateUpdatedEvent }>;
4612
+
4613
+ /**
4614
+ * Fired when a prefetch attempt is updated.
4615
+ */
4616
+ onPrefetchStatusUpdated(listener: (event: { params: Protocol.Preload.PrefetchStatusUpdatedEvent }) => void): void;
4617
+ offPrefetchStatusUpdated(listener: (event: { params: Protocol.Preload.PrefetchStatusUpdatedEvent }) => void): void;
4618
+ oncePrefetchStatusUpdated(eventMatcher?: (event: { params: Protocol.Preload.PrefetchStatusUpdatedEvent }) => boolean): Promise<{ params: Protocol.Preload.PrefetchStatusUpdatedEvent }>;
4619
+
4620
+ /**
4621
+ * Fired when a prerender attempt is updated.
4622
+ */
4623
+ onPrerenderStatusUpdated(listener: (event: { params: Protocol.Preload.PrerenderStatusUpdatedEvent }) => void): void;
4624
+ offPrerenderStatusUpdated(listener: (event: { params: Protocol.Preload.PrerenderStatusUpdatedEvent }) => void): void;
4625
+ oncePrerenderStatusUpdated(eventMatcher?: (event: { params: Protocol.Preload.PrerenderStatusUpdatedEvent }) => boolean): Promise<{ params: Protocol.Preload.PrerenderStatusUpdatedEvent }>;
4626
+
4627
+ /**
4628
+ * Send a list of sources for all preloading attempts in a document.
4629
+ */
4630
+ onPreloadingAttemptSourcesUpdated(listener: (event: { params: Protocol.Preload.PreloadingAttemptSourcesUpdatedEvent }) => void): void;
4631
+ offPreloadingAttemptSourcesUpdated(listener: (event: { params: Protocol.Preload.PreloadingAttemptSourcesUpdatedEvent }) => void): void;
4632
+ oncePreloadingAttemptSourcesUpdated(eventMatcher?: (event: { params: Protocol.Preload.PreloadingAttemptSourcesUpdatedEvent }) => boolean): Promise<{ params: Protocol.Preload.PreloadingAttemptSourcesUpdatedEvent }>;
4633
+
4634
+ }
4635
+
4153
4636
  export interface SecurityApi {
4154
4637
  /**
4155
4638
  * Disables tracking security state changes.
@@ -4837,165 +5320,70 @@ export namespace ProtocolTestsProxyApi {
4837
5320
 
4838
5321
  }
4839
5322
 
4840
- export interface FetchApi {
5323
+ export interface WebAudioApi {
4841
5324
  /**
4842
- * Disables the fetch domain.
5325
+ * Enables the WebAudio domain and starts sending context lifetime events.
5326
+ */
5327
+ enable(): Promise<{id: number, result: void, sessionId: string}>;
5328
+
5329
+ /**
5330
+ * Disables the WebAudio domain.
4843
5331
  */
4844
5332
  disable(): Promise<{id: number, result: void, sessionId: string}>;
4845
5333
 
4846
5334
  /**
4847
- * Enables issuing of requestPaused events. A request will be paused until client
4848
- * calls one of failRequest, fulfillRequest or continueRequest/continueWithAuth.
5335
+ * Fetch the realtime data from the registered contexts.
4849
5336
  */
4850
- enable(params: Protocol.Fetch.EnableRequest): Promise<{id: number, result: void, sessionId: string}>;
5337
+ getRealtimeData(params: Protocol.WebAudio.GetRealtimeDataRequest): Promise<{id: number, result: Protocol.WebAudio.GetRealtimeDataResponse, sessionId: string}>;
4851
5338
 
4852
5339
  /**
4853
- * Causes the request to fail with specified reason.
5340
+ * Notifies that a new BaseAudioContext has been created.
4854
5341
  */
4855
- failRequest(params: Protocol.Fetch.FailRequestRequest): Promise<{id: number, result: void, sessionId: string}>;
5342
+ onContextCreated(listener: (event: { params: Protocol.WebAudio.ContextCreatedEvent }) => void): void;
5343
+ offContextCreated(listener: (event: { params: Protocol.WebAudio.ContextCreatedEvent }) => void): void;
5344
+ onceContextCreated(eventMatcher?: (event: { params: Protocol.WebAudio.ContextCreatedEvent }) => boolean): Promise<{ params: Protocol.WebAudio.ContextCreatedEvent }>;
4856
5345
 
4857
5346
  /**
4858
- * Provides response to the request.
5347
+ * Notifies that an existing BaseAudioContext will be destroyed.
4859
5348
  */
4860
- fulfillRequest(params: Protocol.Fetch.FulfillRequestRequest): Promise<{id: number, result: void, sessionId: string}>;
5349
+ onContextWillBeDestroyed(listener: (event: { params: Protocol.WebAudio.ContextWillBeDestroyedEvent }) => void): void;
5350
+ offContextWillBeDestroyed(listener: (event: { params: Protocol.WebAudio.ContextWillBeDestroyedEvent }) => void): void;
5351
+ onceContextWillBeDestroyed(eventMatcher?: (event: { params: Protocol.WebAudio.ContextWillBeDestroyedEvent }) => boolean): Promise<{ params: Protocol.WebAudio.ContextWillBeDestroyedEvent }>;
4861
5352
 
4862
5353
  /**
4863
- * Continues the request, optionally modifying some of its parameters.
5354
+ * Notifies that existing BaseAudioContext has changed some properties (id stays the same)..
4864
5355
  */
4865
- continueRequest(params: Protocol.Fetch.ContinueRequestRequest): Promise<{id: number, result: void, sessionId: string}>;
5356
+ onContextChanged(listener: (event: { params: Protocol.WebAudio.ContextChangedEvent }) => void): void;
5357
+ offContextChanged(listener: (event: { params: Protocol.WebAudio.ContextChangedEvent }) => void): void;
5358
+ onceContextChanged(eventMatcher?: (event: { params: Protocol.WebAudio.ContextChangedEvent }) => boolean): Promise<{ params: Protocol.WebAudio.ContextChangedEvent }>;
4866
5359
 
4867
5360
  /**
4868
- * Continues a request supplying authChallengeResponse following authRequired event.
5361
+ * Notifies that the construction of an AudioListener has finished.
4869
5362
  */
4870
- continueWithAuth(params: Protocol.Fetch.ContinueWithAuthRequest): Promise<{id: number, result: void, sessionId: string}>;
5363
+ onAudioListenerCreated(listener: (event: { params: Protocol.WebAudio.AudioListenerCreatedEvent }) => void): void;
5364
+ offAudioListenerCreated(listener: (event: { params: Protocol.WebAudio.AudioListenerCreatedEvent }) => void): void;
5365
+ onceAudioListenerCreated(eventMatcher?: (event: { params: Protocol.WebAudio.AudioListenerCreatedEvent }) => boolean): Promise<{ params: Protocol.WebAudio.AudioListenerCreatedEvent }>;
4871
5366
 
4872
5367
  /**
4873
- * Continues loading of the paused response, optionally modifying the
4874
- * response headers. If either responseCode or headers are modified, all of them
4875
- * must be present.
4876
- * @experimental
5368
+ * Notifies that a new AudioListener has been created.
4877
5369
  */
4878
- continueResponse(params: Protocol.Fetch.ContinueResponseRequest): Promise<{id: number, result: void, sessionId: string}>;
5370
+ onAudioListenerWillBeDestroyed(listener: (event: { params: Protocol.WebAudio.AudioListenerWillBeDestroyedEvent }) => void): void;
5371
+ offAudioListenerWillBeDestroyed(listener: (event: { params: Protocol.WebAudio.AudioListenerWillBeDestroyedEvent }) => void): void;
5372
+ onceAudioListenerWillBeDestroyed(eventMatcher?: (event: { params: Protocol.WebAudio.AudioListenerWillBeDestroyedEvent }) => boolean): Promise<{ params: Protocol.WebAudio.AudioListenerWillBeDestroyedEvent }>;
4879
5373
 
4880
5374
  /**
4881
- * Causes the body of the response to be received from the server and
4882
- * returned as a single string. May only be issued for a request that
4883
- * is paused in the Response stage and is mutually exclusive with
4884
- * takeResponseBodyForInterceptionAsStream. Calling other methods that
4885
- * affect the request or disabling fetch domain before body is received
4886
- * results in an undefined behavior.
4887
- * Note that the response body is not available for redirects. Requests
4888
- * paused in the _redirect received_ state may be differentiated by
4889
- * `responseCode` and presence of `location` response header, see
4890
- * comments to `requestPaused` for details.
5375
+ * Notifies that a new AudioNode has been created.
4891
5376
  */
4892
- getResponseBody(params: Protocol.Fetch.GetResponseBodyRequest): Promise<{id: number, result: Protocol.Fetch.GetResponseBodyResponse, sessionId: string}>;
5377
+ onAudioNodeCreated(listener: (event: { params: Protocol.WebAudio.AudioNodeCreatedEvent }) => void): void;
5378
+ offAudioNodeCreated(listener: (event: { params: Protocol.WebAudio.AudioNodeCreatedEvent }) => void): void;
5379
+ onceAudioNodeCreated(eventMatcher?: (event: { params: Protocol.WebAudio.AudioNodeCreatedEvent }) => boolean): Promise<{ params: Protocol.WebAudio.AudioNodeCreatedEvent }>;
4893
5380
 
4894
5381
  /**
4895
- * Returns a handle to the stream representing the response body.
4896
- * The request must be paused in the HeadersReceived stage.
4897
- * Note that after this command the request can't be continued
4898
- * as is -- client either needs to cancel it or to provide the
4899
- * response body.
4900
- * The stream only supports sequential read, IO.read will fail if the position
4901
- * is specified.
4902
- * This method is mutually exclusive with getResponseBody.
4903
- * Calling other methods that affect the request or disabling fetch
4904
- * domain before body is received results in an undefined behavior.
5382
+ * Notifies that an existing AudioNode has been destroyed.
4905
5383
  */
4906
- takeResponseBodyAsStream(params: Protocol.Fetch.TakeResponseBodyAsStreamRequest): Promise<{id: number, result: Protocol.Fetch.TakeResponseBodyAsStreamResponse, sessionId: string}>;
4907
-
4908
- /**
4909
- * Issued when the domain is enabled and the request URL matches the
4910
- * specified filter. The request is paused until the client responds
4911
- * with one of continueRequest, failRequest or fulfillRequest.
4912
- * The stage of the request can be determined by presence of responseErrorReason
4913
- * and responseStatusCode -- the request is at the response stage if either
4914
- * of these fields is present and in the request stage otherwise.
4915
- * Redirect responses and subsequent requests are reported similarly to regular
4916
- * responses and requests. Redirect responses may be distinguished by the value
4917
- * of `responseStatusCode` (which is one of 301, 302, 303, 307, 308) along with
4918
- * presence of the `location` header. Requests resulting from a redirect will
4919
- * have `redirectedRequestId` field set.
4920
- */
4921
- onRequestPaused(listener: (event: { params: Protocol.Fetch.RequestPausedEvent }) => void): void;
4922
- offRequestPaused(listener: (event: { params: Protocol.Fetch.RequestPausedEvent }) => void): void;
4923
- onceRequestPaused(eventMatcher?: (event: { params: Protocol.Fetch.RequestPausedEvent }) => boolean): Promise<{ params: Protocol.Fetch.RequestPausedEvent }>;
4924
-
4925
- /**
4926
- * Issued when the domain is enabled with handleAuthRequests set to true.
4927
- * The request is paused until client responds with continueWithAuth.
4928
- */
4929
- onAuthRequired(listener: (event: { params: Protocol.Fetch.AuthRequiredEvent }) => void): void;
4930
- offAuthRequired(listener: (event: { params: Protocol.Fetch.AuthRequiredEvent }) => void): void;
4931
- onceAuthRequired(eventMatcher?: (event: { params: Protocol.Fetch.AuthRequiredEvent }) => boolean): Promise<{ params: Protocol.Fetch.AuthRequiredEvent }>;
4932
-
4933
- }
4934
-
4935
- export interface WebAudioApi {
4936
- /**
4937
- * Enables the WebAudio domain and starts sending context lifetime events.
4938
- */
4939
- enable(): Promise<{id: number, result: void, sessionId: string}>;
4940
-
4941
- /**
4942
- * Disables the WebAudio domain.
4943
- */
4944
- disable(): Promise<{id: number, result: void, sessionId: string}>;
4945
-
4946
- /**
4947
- * Fetch the realtime data from the registered contexts.
4948
- */
4949
- getRealtimeData(params: Protocol.WebAudio.GetRealtimeDataRequest): Promise<{id: number, result: Protocol.WebAudio.GetRealtimeDataResponse, sessionId: string}>;
4950
-
4951
- /**
4952
- * Notifies that a new BaseAudioContext has been created.
4953
- */
4954
- onContextCreated(listener: (event: { params: Protocol.WebAudio.ContextCreatedEvent }) => void): void;
4955
- offContextCreated(listener: (event: { params: Protocol.WebAudio.ContextCreatedEvent }) => void): void;
4956
- onceContextCreated(eventMatcher?: (event: { params: Protocol.WebAudio.ContextCreatedEvent }) => boolean): Promise<{ params: Protocol.WebAudio.ContextCreatedEvent }>;
4957
-
4958
- /**
4959
- * Notifies that an existing BaseAudioContext will be destroyed.
4960
- */
4961
- onContextWillBeDestroyed(listener: (event: { params: Protocol.WebAudio.ContextWillBeDestroyedEvent }) => void): void;
4962
- offContextWillBeDestroyed(listener: (event: { params: Protocol.WebAudio.ContextWillBeDestroyedEvent }) => void): void;
4963
- onceContextWillBeDestroyed(eventMatcher?: (event: { params: Protocol.WebAudio.ContextWillBeDestroyedEvent }) => boolean): Promise<{ params: Protocol.WebAudio.ContextWillBeDestroyedEvent }>;
4964
-
4965
- /**
4966
- * Notifies that existing BaseAudioContext has changed some properties (id stays the same)..
4967
- */
4968
- onContextChanged(listener: (event: { params: Protocol.WebAudio.ContextChangedEvent }) => void): void;
4969
- offContextChanged(listener: (event: { params: Protocol.WebAudio.ContextChangedEvent }) => void): void;
4970
- onceContextChanged(eventMatcher?: (event: { params: Protocol.WebAudio.ContextChangedEvent }) => boolean): Promise<{ params: Protocol.WebAudio.ContextChangedEvent }>;
4971
-
4972
- /**
4973
- * Notifies that the construction of an AudioListener has finished.
4974
- */
4975
- onAudioListenerCreated(listener: (event: { params: Protocol.WebAudio.AudioListenerCreatedEvent }) => void): void;
4976
- offAudioListenerCreated(listener: (event: { params: Protocol.WebAudio.AudioListenerCreatedEvent }) => void): void;
4977
- onceAudioListenerCreated(eventMatcher?: (event: { params: Protocol.WebAudio.AudioListenerCreatedEvent }) => boolean): Promise<{ params: Protocol.WebAudio.AudioListenerCreatedEvent }>;
4978
-
4979
- /**
4980
- * Notifies that a new AudioListener has been created.
4981
- */
4982
- onAudioListenerWillBeDestroyed(listener: (event: { params: Protocol.WebAudio.AudioListenerWillBeDestroyedEvent }) => void): void;
4983
- offAudioListenerWillBeDestroyed(listener: (event: { params: Protocol.WebAudio.AudioListenerWillBeDestroyedEvent }) => void): void;
4984
- onceAudioListenerWillBeDestroyed(eventMatcher?: (event: { params: Protocol.WebAudio.AudioListenerWillBeDestroyedEvent }) => boolean): Promise<{ params: Protocol.WebAudio.AudioListenerWillBeDestroyedEvent }>;
4985
-
4986
- /**
4987
- * Notifies that a new AudioNode has been created.
4988
- */
4989
- onAudioNodeCreated(listener: (event: { params: Protocol.WebAudio.AudioNodeCreatedEvent }) => void): void;
4990
- offAudioNodeCreated(listener: (event: { params: Protocol.WebAudio.AudioNodeCreatedEvent }) => void): void;
4991
- onceAudioNodeCreated(eventMatcher?: (event: { params: Protocol.WebAudio.AudioNodeCreatedEvent }) => boolean): Promise<{ params: Protocol.WebAudio.AudioNodeCreatedEvent }>;
4992
-
4993
- /**
4994
- * Notifies that an existing AudioNode has been destroyed.
4995
- */
4996
- onAudioNodeWillBeDestroyed(listener: (event: { params: Protocol.WebAudio.AudioNodeWillBeDestroyedEvent }) => void): void;
4997
- offAudioNodeWillBeDestroyed(listener: (event: { params: Protocol.WebAudio.AudioNodeWillBeDestroyedEvent }) => void): void;
4998
- onceAudioNodeWillBeDestroyed(eventMatcher?: (event: { params: Protocol.WebAudio.AudioNodeWillBeDestroyedEvent }) => boolean): Promise<{ params: Protocol.WebAudio.AudioNodeWillBeDestroyedEvent }>;
5384
+ onAudioNodeWillBeDestroyed(listener: (event: { params: Protocol.WebAudio.AudioNodeWillBeDestroyedEvent }) => void): void;
5385
+ offAudioNodeWillBeDestroyed(listener: (event: { params: Protocol.WebAudio.AudioNodeWillBeDestroyedEvent }) => void): void;
5386
+ onceAudioNodeWillBeDestroyed(eventMatcher?: (event: { params: Protocol.WebAudio.AudioNodeWillBeDestroyedEvent }) => boolean): Promise<{ params: Protocol.WebAudio.AudioNodeWillBeDestroyedEvent }>;
4999
5387
 
5000
5388
  /**
5001
5389
  * Notifies that a new AudioParam has been created.
@@ -5143,373 +5531,6 @@ export namespace ProtocolTestsProxyApi {
5143
5531
  onceCredentialAsserted(eventMatcher?: (event: { params: Protocol.WebAuthn.CredentialAssertedEvent }) => boolean): Promise<{ params: Protocol.WebAuthn.CredentialAssertedEvent }>;
5144
5532
 
5145
5533
  }
5146
-
5147
- export interface MediaApi {
5148
- /**
5149
- * Enables the Media domain
5150
- */
5151
- enable(): Promise<{id: number, result: void, sessionId: string}>;
5152
-
5153
- /**
5154
- * Disables the Media domain.
5155
- */
5156
- disable(): Promise<{id: number, result: void, sessionId: string}>;
5157
-
5158
- /**
5159
- * This can be called multiple times, and can be used to set / override /
5160
- * remove player properties. A null propValue indicates removal.
5161
- */
5162
- onPlayerPropertiesChanged(listener: (event: { params: Protocol.Media.PlayerPropertiesChangedEvent }) => void): void;
5163
- offPlayerPropertiesChanged(listener: (event: { params: Protocol.Media.PlayerPropertiesChangedEvent }) => void): void;
5164
- oncePlayerPropertiesChanged(eventMatcher?: (event: { params: Protocol.Media.PlayerPropertiesChangedEvent }) => boolean): Promise<{ params: Protocol.Media.PlayerPropertiesChangedEvent }>;
5165
-
5166
- /**
5167
- * Send events as a list, allowing them to be batched on the browser for less
5168
- * congestion. If batched, events must ALWAYS be in chronological order.
5169
- */
5170
- onPlayerEventsAdded(listener: (event: { params: Protocol.Media.PlayerEventsAddedEvent }) => void): void;
5171
- offPlayerEventsAdded(listener: (event: { params: Protocol.Media.PlayerEventsAddedEvent }) => void): void;
5172
- oncePlayerEventsAdded(eventMatcher?: (event: { params: Protocol.Media.PlayerEventsAddedEvent }) => boolean): Promise<{ params: Protocol.Media.PlayerEventsAddedEvent }>;
5173
-
5174
- /**
5175
- * Send a list of any messages that need to be delivered.
5176
- */
5177
- onPlayerMessagesLogged(listener: (event: { params: Protocol.Media.PlayerMessagesLoggedEvent }) => void): void;
5178
- offPlayerMessagesLogged(listener: (event: { params: Protocol.Media.PlayerMessagesLoggedEvent }) => void): void;
5179
- oncePlayerMessagesLogged(eventMatcher?: (event: { params: Protocol.Media.PlayerMessagesLoggedEvent }) => boolean): Promise<{ params: Protocol.Media.PlayerMessagesLoggedEvent }>;
5180
-
5181
- /**
5182
- * Send a list of any errors that need to be delivered.
5183
- */
5184
- onPlayerErrorsRaised(listener: (event: { params: Protocol.Media.PlayerErrorsRaisedEvent }) => void): void;
5185
- offPlayerErrorsRaised(listener: (event: { params: Protocol.Media.PlayerErrorsRaisedEvent }) => void): void;
5186
- oncePlayerErrorsRaised(eventMatcher?: (event: { params: Protocol.Media.PlayerErrorsRaisedEvent }) => boolean): Promise<{ params: Protocol.Media.PlayerErrorsRaisedEvent }>;
5187
-
5188
- /**
5189
- * Called whenever a player is created, or when a new agent joins and receives
5190
- * a list of active players. If an agent is restored, it will receive the full
5191
- * list of player ids and all events again.
5192
- */
5193
- onPlayersCreated(listener: (event: { params: Protocol.Media.PlayersCreatedEvent }) => void): void;
5194
- offPlayersCreated(listener: (event: { params: Protocol.Media.PlayersCreatedEvent }) => void): void;
5195
- oncePlayersCreated(eventMatcher?: (event: { params: Protocol.Media.PlayersCreatedEvent }) => boolean): Promise<{ params: Protocol.Media.PlayersCreatedEvent }>;
5196
-
5197
- }
5198
-
5199
- export interface DeviceAccessApi {
5200
- /**
5201
- * Enable events in this domain.
5202
- */
5203
- enable(): Promise<{id: number, result: void, sessionId: string}>;
5204
-
5205
- /**
5206
- * Disable events in this domain.
5207
- */
5208
- disable(): Promise<{id: number, result: void, sessionId: string}>;
5209
-
5210
- /**
5211
- * Select a device in response to a DeviceAccess.deviceRequestPrompted event.
5212
- */
5213
- selectPrompt(params: Protocol.DeviceAccess.SelectPromptRequest): Promise<{id: number, result: void, sessionId: string}>;
5214
-
5215
- /**
5216
- * Cancel a prompt in response to a DeviceAccess.deviceRequestPrompted event.
5217
- */
5218
- cancelPrompt(params: Protocol.DeviceAccess.CancelPromptRequest): Promise<{id: number, result: void, sessionId: string}>;
5219
-
5220
- /**
5221
- * A device request opened a user prompt to select a device. Respond with the
5222
- * selectPrompt or cancelPrompt command.
5223
- */
5224
- onDeviceRequestPrompted(listener: (event: { params: Protocol.DeviceAccess.DeviceRequestPromptedEvent }) => void): void;
5225
- offDeviceRequestPrompted(listener: (event: { params: Protocol.DeviceAccess.DeviceRequestPromptedEvent }) => void): void;
5226
- onceDeviceRequestPrompted(eventMatcher?: (event: { params: Protocol.DeviceAccess.DeviceRequestPromptedEvent }) => boolean): Promise<{ params: Protocol.DeviceAccess.DeviceRequestPromptedEvent }>;
5227
-
5228
- }
5229
-
5230
- export interface PreloadApi {
5231
- enable(): Promise<{id: number, result: void, sessionId: string}>;
5232
-
5233
- disable(): Promise<{id: number, result: void, sessionId: string}>;
5234
-
5235
- /**
5236
- * Upsert. Currently, it is only emitted when a rule set added.
5237
- */
5238
- onRuleSetUpdated(listener: (event: { params: Protocol.Preload.RuleSetUpdatedEvent }) => void): void;
5239
- offRuleSetUpdated(listener: (event: { params: Protocol.Preload.RuleSetUpdatedEvent }) => void): void;
5240
- onceRuleSetUpdated(eventMatcher?: (event: { params: Protocol.Preload.RuleSetUpdatedEvent }) => boolean): Promise<{ params: Protocol.Preload.RuleSetUpdatedEvent }>;
5241
-
5242
- onRuleSetRemoved(listener: (event: { params: Protocol.Preload.RuleSetRemovedEvent }) => void): void;
5243
- offRuleSetRemoved(listener: (event: { params: Protocol.Preload.RuleSetRemovedEvent }) => void): void;
5244
- onceRuleSetRemoved(eventMatcher?: (event: { params: Protocol.Preload.RuleSetRemovedEvent }) => boolean): Promise<{ params: Protocol.Preload.RuleSetRemovedEvent }>;
5245
-
5246
- /**
5247
- * Fired when a preload enabled state is updated.
5248
- */
5249
- onPreloadEnabledStateUpdated(listener: (event: { params: Protocol.Preload.PreloadEnabledStateUpdatedEvent }) => void): void;
5250
- offPreloadEnabledStateUpdated(listener: (event: { params: Protocol.Preload.PreloadEnabledStateUpdatedEvent }) => void): void;
5251
- oncePreloadEnabledStateUpdated(eventMatcher?: (event: { params: Protocol.Preload.PreloadEnabledStateUpdatedEvent }) => boolean): Promise<{ params: Protocol.Preload.PreloadEnabledStateUpdatedEvent }>;
5252
-
5253
- /**
5254
- * Fired when a prefetch attempt is updated.
5255
- */
5256
- onPrefetchStatusUpdated(listener: (event: { params: Protocol.Preload.PrefetchStatusUpdatedEvent }) => void): void;
5257
- offPrefetchStatusUpdated(listener: (event: { params: Protocol.Preload.PrefetchStatusUpdatedEvent }) => void): void;
5258
- oncePrefetchStatusUpdated(eventMatcher?: (event: { params: Protocol.Preload.PrefetchStatusUpdatedEvent }) => boolean): Promise<{ params: Protocol.Preload.PrefetchStatusUpdatedEvent }>;
5259
-
5260
- /**
5261
- * Fired when a prerender attempt is updated.
5262
- */
5263
- onPrerenderStatusUpdated(listener: (event: { params: Protocol.Preload.PrerenderStatusUpdatedEvent }) => void): void;
5264
- offPrerenderStatusUpdated(listener: (event: { params: Protocol.Preload.PrerenderStatusUpdatedEvent }) => void): void;
5265
- oncePrerenderStatusUpdated(eventMatcher?: (event: { params: Protocol.Preload.PrerenderStatusUpdatedEvent }) => boolean): Promise<{ params: Protocol.Preload.PrerenderStatusUpdatedEvent }>;
5266
-
5267
- /**
5268
- * Send a list of sources for all preloading attempts in a document.
5269
- */
5270
- onPreloadingAttemptSourcesUpdated(listener: (event: { params: Protocol.Preload.PreloadingAttemptSourcesUpdatedEvent }) => void): void;
5271
- offPreloadingAttemptSourcesUpdated(listener: (event: { params: Protocol.Preload.PreloadingAttemptSourcesUpdatedEvent }) => void): void;
5272
- oncePreloadingAttemptSourcesUpdated(eventMatcher?: (event: { params: Protocol.Preload.PreloadingAttemptSourcesUpdatedEvent }) => boolean): Promise<{ params: Protocol.Preload.PreloadingAttemptSourcesUpdatedEvent }>;
5273
-
5274
- }
5275
-
5276
- export interface FedCmApi {
5277
- enable(params: Protocol.FedCm.EnableRequest): Promise<{id: number, result: void, sessionId: string}>;
5278
-
5279
- disable(): Promise<{id: number, result: void, sessionId: string}>;
5280
-
5281
- selectAccount(params: Protocol.FedCm.SelectAccountRequest): Promise<{id: number, result: void, sessionId: string}>;
5282
-
5283
- clickDialogButton(params: Protocol.FedCm.ClickDialogButtonRequest): Promise<{id: number, result: void, sessionId: string}>;
5284
-
5285
- openUrl(params: Protocol.FedCm.OpenUrlRequest): Promise<{id: number, result: void, sessionId: string}>;
5286
-
5287
- dismissDialog(params: Protocol.FedCm.DismissDialogRequest): Promise<{id: number, result: void, sessionId: string}>;
5288
-
5289
- /**
5290
- * Resets the cooldown time, if any, to allow the next FedCM call to show
5291
- * a dialog even if one was recently dismissed by the user.
5292
- */
5293
- resetCooldown(): Promise<{id: number, result: void, sessionId: string}>;
5294
-
5295
- onDialogShown(listener: (event: { params: Protocol.FedCm.DialogShownEvent }) => void): void;
5296
- offDialogShown(listener: (event: { params: Protocol.FedCm.DialogShownEvent }) => void): void;
5297
- onceDialogShown(eventMatcher?: (event: { params: Protocol.FedCm.DialogShownEvent }) => boolean): Promise<{ params: Protocol.FedCm.DialogShownEvent }>;
5298
-
5299
- /**
5300
- * Triggered when a dialog is closed, either by user action, JS abort,
5301
- * or a command below.
5302
- */
5303
- onDialogClosed(listener: (event: { params: Protocol.FedCm.DialogClosedEvent }) => void): void;
5304
- offDialogClosed(listener: (event: { params: Protocol.FedCm.DialogClosedEvent }) => void): void;
5305
- onceDialogClosed(eventMatcher?: (event: { params: Protocol.FedCm.DialogClosedEvent }) => boolean): Promise<{ params: Protocol.FedCm.DialogClosedEvent }>;
5306
-
5307
- }
5308
-
5309
- export interface PWAApi {
5310
- /**
5311
- * Returns the following OS state for the given manifest id.
5312
- */
5313
- getOsAppState(params: Protocol.PWA.GetOsAppStateRequest): Promise<{id: number, result: Protocol.PWA.GetOsAppStateResponse, sessionId: string}>;
5314
-
5315
- /**
5316
- * Installs the given manifest identity, optionally using the given installUrlOrBundleUrl
5317
- *
5318
- * IWA-specific install description:
5319
- * manifestId corresponds to isolated-app:// + web_package::SignedWebBundleId
5320
- *
5321
- * File installation mode:
5322
- * The installUrlOrBundleUrl can be either file:// or http(s):// pointing
5323
- * to a signed web bundle (.swbn). In this case SignedWebBundleId must correspond to
5324
- * The .swbn file's signing key.
5325
- *
5326
- * Dev proxy installation mode:
5327
- * installUrlOrBundleUrl must be http(s):// that serves dev mode IWA.
5328
- * web_package::SignedWebBundleId must be of type dev proxy.
5329
- *
5330
- * The advantage of dev proxy mode is that all changes to IWA
5331
- * automatically will be reflected in the running app without
5332
- * reinstallation.
5333
- *
5334
- * To generate bundle id for proxy mode:
5335
- * 1. Generate 32 random bytes.
5336
- * 2. Add a specific suffix 0x00 at the end.
5337
- * 3. Encode the entire sequence using Base32 without padding.
5338
- *
5339
- * If Chrome is not in IWA dev
5340
- * mode, the installation will fail, regardless of the state of the allowlist.
5341
- */
5342
- install(params: Protocol.PWA.InstallRequest): Promise<{id: number, result: void, sessionId: string}>;
5343
-
5344
- /**
5345
- * Uninstalls the given manifest_id and closes any opened app windows.
5346
- */
5347
- uninstall(params: Protocol.PWA.UninstallRequest): Promise<{id: number, result: void, sessionId: string}>;
5348
-
5349
- /**
5350
- * Launches the installed web app, or an url in the same web app instead of the
5351
- * default start url if it is provided. Returns a page Target.TargetID which
5352
- * can be used to attach to via Target.attachToTarget or similar APIs.
5353
- */
5354
- launch(params: Protocol.PWA.LaunchRequest): Promise<{id: number, result: Protocol.PWA.LaunchResponse, sessionId: string}>;
5355
-
5356
- /**
5357
- * Opens one or more local files from an installed web app identified by its
5358
- * manifestId. The web app needs to have file handlers registered to process
5359
- * the files. The API returns one or more page Target.TargetIDs which can be
5360
- * used to attach to via Target.attachToTarget or similar APIs.
5361
- * If some files in the parameters cannot be handled by the web app, they will
5362
- * be ignored. If none of the files can be handled, this API returns an error.
5363
- * If no files are provided as the parameter, this API also returns an error.
5364
- *
5365
- * According to the definition of the file handlers in the manifest file, one
5366
- * Target.TargetID may represent a page handling one or more files. The order
5367
- * of the returned Target.TargetIDs is not guaranteed.
5368
- *
5369
- * TODO(crbug.com/339454034): Check the existences of the input files.
5370
- */
5371
- launchFilesInApp(params: Protocol.PWA.LaunchFilesInAppRequest): Promise<{id: number, result: Protocol.PWA.LaunchFilesInAppResponse, sessionId: string}>;
5372
-
5373
- /**
5374
- * Opens the current page in its web app identified by the manifest id, needs
5375
- * to be called on a page target. This function returns immediately without
5376
- * waiting for the app to finish loading.
5377
- */
5378
- openCurrentPageInApp(params: Protocol.PWA.OpenCurrentPageInAppRequest): Promise<{id: number, result: void, sessionId: string}>;
5379
-
5380
- /**
5381
- * Changes user settings of the web app identified by its manifestId. If the
5382
- * app was not installed, this command returns an error. Unset parameters will
5383
- * be ignored; unrecognized values will cause an error.
5384
- *
5385
- * Unlike the ones defined in the manifest files of the web apps, these
5386
- * settings are provided by the browser and controlled by the users, they
5387
- * impact the way the browser handling the web apps.
5388
- *
5389
- * See the comment of each parameter.
5390
- */
5391
- changeAppUserSettings(params: Protocol.PWA.ChangeAppUserSettingsRequest): Promise<{id: number, result: void, sessionId: string}>;
5392
-
5393
- }
5394
-
5395
- export interface BluetoothEmulationApi {
5396
- /**
5397
- * Enable the BluetoothEmulation domain.
5398
- */
5399
- enable(params: Protocol.BluetoothEmulation.EnableRequest): Promise<{id: number, result: void, sessionId: string}>;
5400
-
5401
- /**
5402
- * Set the state of the simulated central.
5403
- */
5404
- setSimulatedCentralState(params: Protocol.BluetoothEmulation.SetSimulatedCentralStateRequest): Promise<{id: number, result: void, sessionId: string}>;
5405
-
5406
- /**
5407
- * Disable the BluetoothEmulation domain.
5408
- */
5409
- disable(): Promise<{id: number, result: void, sessionId: string}>;
5410
-
5411
- /**
5412
- * Simulates a peripheral with |address|, |name| and |knownServiceUuids|
5413
- * that has already been connected to the system.
5414
- */
5415
- simulatePreconnectedPeripheral(params: Protocol.BluetoothEmulation.SimulatePreconnectedPeripheralRequest): Promise<{id: number, result: void, sessionId: string}>;
5416
-
5417
- /**
5418
- * Simulates an advertisement packet described in |entry| being received by
5419
- * the central.
5420
- */
5421
- simulateAdvertisement(params: Protocol.BluetoothEmulation.SimulateAdvertisementRequest): Promise<{id: number, result: void, sessionId: string}>;
5422
-
5423
- /**
5424
- * Simulates the response code from the peripheral with |address| for a
5425
- * GATT operation of |type|. The |code| value follows the HCI Error Codes from
5426
- * Bluetooth Core Specification Vol 2 Part D 1.3 List Of Error Codes.
5427
- */
5428
- simulateGATTOperationResponse(params: Protocol.BluetoothEmulation.SimulateGATTOperationResponseRequest): Promise<{id: number, result: void, sessionId: string}>;
5429
-
5430
- /**
5431
- * Simulates the response from the characteristic with |characteristicId| for a
5432
- * characteristic operation of |type|. The |code| value follows the Error
5433
- * Codes from Bluetooth Core Specification Vol 3 Part F 3.4.1.1 Error Response.
5434
- * The |data| is expected to exist when simulating a successful read operation
5435
- * response.
5436
- */
5437
- simulateCharacteristicOperationResponse(params: Protocol.BluetoothEmulation.SimulateCharacteristicOperationResponseRequest): Promise<{id: number, result: void, sessionId: string}>;
5438
-
5439
- /**
5440
- * Simulates the response from the descriptor with |descriptorId| for a
5441
- * descriptor operation of |type|. The |code| value follows the Error
5442
- * Codes from Bluetooth Core Specification Vol 3 Part F 3.4.1.1 Error Response.
5443
- * The |data| is expected to exist when simulating a successful read operation
5444
- * response.
5445
- */
5446
- simulateDescriptorOperationResponse(params: Protocol.BluetoothEmulation.SimulateDescriptorOperationResponseRequest): Promise<{id: number, result: void, sessionId: string}>;
5447
-
5448
- /**
5449
- * Adds a service with |serviceUuid| to the peripheral with |address|.
5450
- */
5451
- addService(params: Protocol.BluetoothEmulation.AddServiceRequest): Promise<{id: number, result: Protocol.BluetoothEmulation.AddServiceResponse, sessionId: string}>;
5452
-
5453
- /**
5454
- * Removes the service respresented by |serviceId| from the simulated central.
5455
- */
5456
- removeService(params: Protocol.BluetoothEmulation.RemoveServiceRequest): Promise<{id: number, result: void, sessionId: string}>;
5457
-
5458
- /**
5459
- * Adds a characteristic with |characteristicUuid| and |properties| to the
5460
- * service represented by |serviceId|.
5461
- */
5462
- addCharacteristic(params: Protocol.BluetoothEmulation.AddCharacteristicRequest): Promise<{id: number, result: Protocol.BluetoothEmulation.AddCharacteristicResponse, sessionId: string}>;
5463
-
5464
- /**
5465
- * Removes the characteristic respresented by |characteristicId| from the
5466
- * simulated central.
5467
- */
5468
- removeCharacteristic(params: Protocol.BluetoothEmulation.RemoveCharacteristicRequest): Promise<{id: number, result: void, sessionId: string}>;
5469
-
5470
- /**
5471
- * Adds a descriptor with |descriptorUuid| to the characteristic respresented
5472
- * by |characteristicId|.
5473
- */
5474
- addDescriptor(params: Protocol.BluetoothEmulation.AddDescriptorRequest): Promise<{id: number, result: Protocol.BluetoothEmulation.AddDescriptorResponse, sessionId: string}>;
5475
-
5476
- /**
5477
- * Removes the descriptor with |descriptorId| from the simulated central.
5478
- */
5479
- removeDescriptor(params: Protocol.BluetoothEmulation.RemoveDescriptorRequest): Promise<{id: number, result: void, sessionId: string}>;
5480
-
5481
- /**
5482
- * Simulates a GATT disconnection from the peripheral with |address|.
5483
- */
5484
- simulateGATTDisconnection(params: Protocol.BluetoothEmulation.SimulateGATTDisconnectionRequest): Promise<{id: number, result: void, sessionId: string}>;
5485
-
5486
- /**
5487
- * Event for when a GATT operation of |type| to the peripheral with |address|
5488
- * happened.
5489
- */
5490
- onGattOperationReceived(listener: (event: { params: Protocol.BluetoothEmulation.GattOperationReceivedEvent }) => void): void;
5491
- offGattOperationReceived(listener: (event: { params: Protocol.BluetoothEmulation.GattOperationReceivedEvent }) => void): void;
5492
- onceGattOperationReceived(eventMatcher?: (event: { params: Protocol.BluetoothEmulation.GattOperationReceivedEvent }) => boolean): Promise<{ params: Protocol.BluetoothEmulation.GattOperationReceivedEvent }>;
5493
-
5494
- /**
5495
- * Event for when a characteristic operation of |type| to the characteristic
5496
- * respresented by |characteristicId| happened. |data| and |writeType| is
5497
- * expected to exist when |type| is write.
5498
- */
5499
- onCharacteristicOperationReceived(listener: (event: { params: Protocol.BluetoothEmulation.CharacteristicOperationReceivedEvent }) => void): void;
5500
- offCharacteristicOperationReceived(listener: (event: { params: Protocol.BluetoothEmulation.CharacteristicOperationReceivedEvent }) => void): void;
5501
- onceCharacteristicOperationReceived(eventMatcher?: (event: { params: Protocol.BluetoothEmulation.CharacteristicOperationReceivedEvent }) => boolean): Promise<{ params: Protocol.BluetoothEmulation.CharacteristicOperationReceivedEvent }>;
5502
-
5503
- /**
5504
- * Event for when a descriptor operation of |type| to the descriptor
5505
- * respresented by |descriptorId| happened. |data| is expected to exist when
5506
- * |type| is write.
5507
- */
5508
- onDescriptorOperationReceived(listener: (event: { params: Protocol.BluetoothEmulation.DescriptorOperationReceivedEvent }) => void): void;
5509
- offDescriptorOperationReceived(listener: (event: { params: Protocol.BluetoothEmulation.DescriptorOperationReceivedEvent }) => void): void;
5510
- onceDescriptorOperationReceived(eventMatcher?: (event: { params: Protocol.BluetoothEmulation.DescriptorOperationReceivedEvent }) => boolean): Promise<{ params: Protocol.BluetoothEmulation.DescriptorOperationReceivedEvent }>;
5511
-
5512
- }
5513
5534
  }
5514
5535
 
5515
5536
  export default ProtocolTestsProxyApi;