devtools-protocol 0.0.1498010 → 0.0.1501221

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 (54) hide show
  1. package/json/browser_protocol.json +17905 -17687
  2. package/package.json +1 -1
  3. package/pdl/browser_protocol.pdl +47 -13824
  4. package/pdl/domains/Accessibility.pdl +290 -0
  5. package/pdl/domains/Animation.pdl +195 -0
  6. package/pdl/domains/Audits.pdl +755 -0
  7. package/pdl/domains/Autofill.pdl +106 -0
  8. package/pdl/domains/BackgroundService.pdl +77 -0
  9. package/pdl/domains/BluetoothEmulation.pdl +227 -0
  10. package/pdl/domains/Browser.pdl +345 -0
  11. package/pdl/domains/CSS.pdl +996 -0
  12. package/pdl/domains/CacheStorage.pdl +125 -0
  13. package/pdl/domains/Cast.pdl +62 -0
  14. package/pdl/domains/DOM.pdl +932 -0
  15. package/pdl/domains/DOMDebugger.pdl +128 -0
  16. package/pdl/domains/DOMSnapshot.pdl +319 -0
  17. package/pdl/domains/DOMStorage.pdl +72 -0
  18. package/pdl/domains/DeviceAccess.pdl +43 -0
  19. package/pdl/domains/DeviceOrientation.pdl +20 -0
  20. package/pdl/domains/Emulation.pdl +608 -0
  21. package/pdl/domains/EventBreakpoints.pdl +24 -0
  22. package/pdl/domains/Extensions.pdl +72 -0
  23. package/pdl/domains/FedCm.pdl +100 -0
  24. package/pdl/domains/Fetch.pdl +251 -0
  25. package/pdl/domains/FileSystem.pdl +41 -0
  26. package/pdl/domains/HeadlessExperimental.pdl +56 -0
  27. package/pdl/domains/IO.pdl +45 -0
  28. package/pdl/domains/IndexedDB.pdl +226 -0
  29. package/pdl/domains/Input.pdl +336 -0
  30. package/pdl/domains/Inspector.pdl +25 -0
  31. package/pdl/domains/LayerTree.pdl +178 -0
  32. package/pdl/domains/Log.pdl +93 -0
  33. package/pdl/domains/Media.pdl +106 -0
  34. package/pdl/domains/Memory.pdl +112 -0
  35. package/pdl/domains/Network.pdl +2039 -0
  36. package/pdl/domains/Overlay.pdl +498 -0
  37. package/pdl/domains/PWA.pdl +142 -0
  38. package/pdl/domains/Page.pdl +1767 -0
  39. package/pdl/domains/Performance.pdl +54 -0
  40. package/pdl/domains/PerformanceTimeline.pdl +71 -0
  41. package/pdl/domains/Preload.pdl +290 -0
  42. package/pdl/domains/Security.pdl +196 -0
  43. package/pdl/domains/ServiceWorker.pdl +121 -0
  44. package/pdl/domains/Storage.pdl +913 -0
  45. package/pdl/domains/SystemInfo.pdl +145 -0
  46. package/pdl/domains/Target.pdl +325 -0
  47. package/pdl/domains/Tethering.pdl +28 -0
  48. package/pdl/domains/Tracing.pdl +157 -0
  49. package/pdl/domains/WebAudio.pdl +205 -0
  50. package/pdl/domains/WebAuthn.pdl +230 -0
  51. package/types/protocol-mapping.d.ts +659 -635
  52. package/types/protocol-proxy-api.d.ts +543 -522
  53. package/types/protocol-tests-proxy-api.d.ts +628 -607
  54. package/types/protocol.d.ts +8064 -7914
@@ -132,6 +132,23 @@ export namespace ProtocolMapping {
132
132
  * events afterwards if enabled and recording.
133
133
  */
134
134
  'BackgroundService.backgroundServiceEventReceived': [Protocol.BackgroundService.BackgroundServiceEventReceivedEvent];
135
+ /**
136
+ * Event for when a GATT operation of |type| to the peripheral with |address|
137
+ * happened.
138
+ */
139
+ 'BluetoothEmulation.gattOperationReceived': [Protocol.BluetoothEmulation.GattOperationReceivedEvent];
140
+ /**
141
+ * Event for when a characteristic operation of |type| to the characteristic
142
+ * respresented by |characteristicId| happened. |data| and |writeType| is
143
+ * expected to exist when |type| is write.
144
+ */
145
+ 'BluetoothEmulation.characteristicOperationReceived': [Protocol.BluetoothEmulation.CharacteristicOperationReceivedEvent];
146
+ /**
147
+ * Event for when a descriptor operation of |type| to the descriptor
148
+ * respresented by |descriptorId| happened. |data| is expected to exist when
149
+ * |type| is write.
150
+ */
151
+ 'BluetoothEmulation.descriptorOperationReceived': [Protocol.BluetoothEmulation.DescriptorOperationReceivedEvent];
135
152
  /**
136
153
  * Fired when page is about to start a download.
137
154
  */
@@ -242,10 +259,40 @@ export namespace ProtocolMapping {
242
259
  'DOMStorage.domStorageItemRemoved': [Protocol.DOMStorage.DomStorageItemRemovedEvent];
243
260
  'DOMStorage.domStorageItemUpdated': [Protocol.DOMStorage.DomStorageItemUpdatedEvent];
244
261
  'DOMStorage.domStorageItemsCleared': [Protocol.DOMStorage.DomStorageItemsClearedEvent];
262
+ /**
263
+ * A device request opened a user prompt to select a device. Respond with the
264
+ * selectPrompt or cancelPrompt command.
265
+ */
266
+ 'DeviceAccess.deviceRequestPrompted': [Protocol.DeviceAccess.DeviceRequestPromptedEvent];
245
267
  /**
246
268
  * Notification sent after the virtual time budget for the current VirtualTimePolicy has run out.
247
269
  */
248
270
  'Emulation.virtualTimeBudgetExpired': [];
271
+ 'FedCm.dialogShown': [Protocol.FedCm.DialogShownEvent];
272
+ /**
273
+ * Triggered when a dialog is closed, either by user action, JS abort,
274
+ * or a command below.
275
+ */
276
+ 'FedCm.dialogClosed': [Protocol.FedCm.DialogClosedEvent];
277
+ /**
278
+ * Issued when the domain is enabled and the request URL matches the
279
+ * specified filter. The request is paused until the client responds
280
+ * with one of continueRequest, failRequest or fulfillRequest.
281
+ * The stage of the request can be determined by presence of responseErrorReason
282
+ * and responseStatusCode -- the request is at the response stage if either
283
+ * of these fields is present and in the request stage otherwise.
284
+ * Redirect responses and subsequent requests are reported similarly to regular
285
+ * responses and requests. Redirect responses may be distinguished by the value
286
+ * of `responseStatusCode` (which is one of 301, 302, 303, 307, 308) along with
287
+ * presence of the `location` header. Requests resulting from a redirect will
288
+ * have `redirectedRequestId` field set.
289
+ */
290
+ 'Fetch.requestPaused': [Protocol.Fetch.RequestPausedEvent];
291
+ /**
292
+ * Issued when the domain is enabled with handleAuthRequests set to true.
293
+ * The request is paused until client responds with continueWithAuth.
294
+ */
295
+ 'Fetch.authRequired': [Protocol.Fetch.AuthRequiredEvent];
249
296
  /**
250
297
  * Emitted only when `Input.setInterceptDrags` is enabled. Use this data with `Input.dispatchDragEvent` to
251
298
  * restore normal drag and drop behavior.
@@ -269,6 +316,30 @@ export namespace ProtocolMapping {
269
316
  * Issued when new message was logged.
270
317
  */
271
318
  'Log.entryAdded': [Protocol.Log.EntryAddedEvent];
319
+ /**
320
+ * This can be called multiple times, and can be used to set / override /
321
+ * remove player properties. A null propValue indicates removal.
322
+ */
323
+ 'Media.playerPropertiesChanged': [Protocol.Media.PlayerPropertiesChangedEvent];
324
+ /**
325
+ * Send events as a list, allowing them to be batched on the browser for less
326
+ * congestion. If batched, events must ALWAYS be in chronological order.
327
+ */
328
+ 'Media.playerEventsAdded': [Protocol.Media.PlayerEventsAddedEvent];
329
+ /**
330
+ * Send a list of any messages that need to be delivered.
331
+ */
332
+ 'Media.playerMessagesLogged': [Protocol.Media.PlayerMessagesLoggedEvent];
333
+ /**
334
+ * Send a list of any errors that need to be delivered.
335
+ */
336
+ 'Media.playerErrorsRaised': [Protocol.Media.PlayerErrorsRaisedEvent];
337
+ /**
338
+ * Called whenever a player is created, or when a new agent joins and receives
339
+ * a list of active players. If an agent is restored, it will receive the full
340
+ * list of player ids and all events again.
341
+ */
342
+ 'Media.playersCreated': [Protocol.Media.PlayersCreatedEvent];
272
343
  /**
273
344
  * Fired when data chunk was received over the network.
274
345
  */
@@ -599,6 +670,27 @@ export namespace ProtocolMapping {
599
670
  * Sent when a performance timeline event is added. See reportPerformanceTimeline method.
600
671
  */
601
672
  'PerformanceTimeline.timelineEventAdded': [Protocol.PerformanceTimeline.TimelineEventAddedEvent];
673
+ /**
674
+ * Upsert. Currently, it is only emitted when a rule set added.
675
+ */
676
+ 'Preload.ruleSetUpdated': [Protocol.Preload.RuleSetUpdatedEvent];
677
+ 'Preload.ruleSetRemoved': [Protocol.Preload.RuleSetRemovedEvent];
678
+ /**
679
+ * Fired when a preload enabled state is updated.
680
+ */
681
+ 'Preload.preloadEnabledStateUpdated': [Protocol.Preload.PreloadEnabledStateUpdatedEvent];
682
+ /**
683
+ * Fired when a prefetch attempt is updated.
684
+ */
685
+ 'Preload.prefetchStatusUpdated': [Protocol.Preload.PrefetchStatusUpdatedEvent];
686
+ /**
687
+ * Fired when a prerender attempt is updated.
688
+ */
689
+ 'Preload.prerenderStatusUpdated': [Protocol.Preload.PrerenderStatusUpdatedEvent];
690
+ /**
691
+ * Send a list of sources for all preloading attempts in a document.
692
+ */
693
+ 'Preload.preloadingAttemptSourcesUpdated': [Protocol.Preload.PreloadingAttemptSourcesUpdatedEvent];
602
694
  /**
603
695
  * There is a certificate error. If overriding certificate errors is enabled, then it should be
604
696
  * handled with the `handleCertificateError` command. Note: this event does not fire if the
@@ -712,25 +804,6 @@ export namespace ProtocolMapping {
712
804
  * delivered via dataCollected events.
713
805
  */
714
806
  'Tracing.tracingComplete': [Protocol.Tracing.TracingCompleteEvent];
715
- /**
716
- * Issued when the domain is enabled and the request URL matches the
717
- * specified filter. The request is paused until the client responds
718
- * with one of continueRequest, failRequest or fulfillRequest.
719
- * The stage of the request can be determined by presence of responseErrorReason
720
- * and responseStatusCode -- the request is at the response stage if either
721
- * of these fields is present and in the request stage otherwise.
722
- * Redirect responses and subsequent requests are reported similarly to regular
723
- * responses and requests. Redirect responses may be distinguished by the value
724
- * of `responseStatusCode` (which is one of 301, 302, 303, 307, 308) along with
725
- * presence of the `location` header. Requests resulting from a redirect will
726
- * have `redirectedRequestId` field set.
727
- */
728
- 'Fetch.requestPaused': [Protocol.Fetch.RequestPausedEvent];
729
- /**
730
- * Issued when the domain is enabled with handleAuthRequests set to true.
731
- * The request is paused until client responds with continueWithAuth.
732
- */
733
- 'Fetch.authRequired': [Protocol.Fetch.AuthRequiredEvent];
734
807
  /**
735
808
  * Notifies that a new BaseAudioContext has been created.
736
809
  */
@@ -801,79 +874,6 @@ export namespace ProtocolMapping {
801
874
  * Triggered when a credential is used in a webauthn assertion.
802
875
  */
803
876
  'WebAuthn.credentialAsserted': [Protocol.WebAuthn.CredentialAssertedEvent];
804
- /**
805
- * This can be called multiple times, and can be used to set / override /
806
- * remove player properties. A null propValue indicates removal.
807
- */
808
- 'Media.playerPropertiesChanged': [Protocol.Media.PlayerPropertiesChangedEvent];
809
- /**
810
- * Send events as a list, allowing them to be batched on the browser for less
811
- * congestion. If batched, events must ALWAYS be in chronological order.
812
- */
813
- 'Media.playerEventsAdded': [Protocol.Media.PlayerEventsAddedEvent];
814
- /**
815
- * Send a list of any messages that need to be delivered.
816
- */
817
- 'Media.playerMessagesLogged': [Protocol.Media.PlayerMessagesLoggedEvent];
818
- /**
819
- * Send a list of any errors that need to be delivered.
820
- */
821
- 'Media.playerErrorsRaised': [Protocol.Media.PlayerErrorsRaisedEvent];
822
- /**
823
- * Called whenever a player is created, or when a new agent joins and receives
824
- * a list of active players. If an agent is restored, it will receive the full
825
- * list of player ids and all events again.
826
- */
827
- 'Media.playersCreated': [Protocol.Media.PlayersCreatedEvent];
828
- /**
829
- * A device request opened a user prompt to select a device. Respond with the
830
- * selectPrompt or cancelPrompt command.
831
- */
832
- 'DeviceAccess.deviceRequestPrompted': [Protocol.DeviceAccess.DeviceRequestPromptedEvent];
833
- /**
834
- * Upsert. Currently, it is only emitted when a rule set added.
835
- */
836
- 'Preload.ruleSetUpdated': [Protocol.Preload.RuleSetUpdatedEvent];
837
- 'Preload.ruleSetRemoved': [Protocol.Preload.RuleSetRemovedEvent];
838
- /**
839
- * Fired when a preload enabled state is updated.
840
- */
841
- 'Preload.preloadEnabledStateUpdated': [Protocol.Preload.PreloadEnabledStateUpdatedEvent];
842
- /**
843
- * Fired when a prefetch attempt is updated.
844
- */
845
- 'Preload.prefetchStatusUpdated': [Protocol.Preload.PrefetchStatusUpdatedEvent];
846
- /**
847
- * Fired when a prerender attempt is updated.
848
- */
849
- 'Preload.prerenderStatusUpdated': [Protocol.Preload.PrerenderStatusUpdatedEvent];
850
- /**
851
- * Send a list of sources for all preloading attempts in a document.
852
- */
853
- 'Preload.preloadingAttemptSourcesUpdated': [Protocol.Preload.PreloadingAttemptSourcesUpdatedEvent];
854
- 'FedCm.dialogShown': [Protocol.FedCm.DialogShownEvent];
855
- /**
856
- * Triggered when a dialog is closed, either by user action, JS abort,
857
- * or a command below.
858
- */
859
- 'FedCm.dialogClosed': [Protocol.FedCm.DialogClosedEvent];
860
- /**
861
- * Event for when a GATT operation of |type| to the peripheral with |address|
862
- * happened.
863
- */
864
- 'BluetoothEmulation.gattOperationReceived': [Protocol.BluetoothEmulation.GattOperationReceivedEvent];
865
- /**
866
- * Event for when a characteristic operation of |type| to the characteristic
867
- * respresented by |characteristicId| happened. |data| and |writeType| is
868
- * expected to exist when |type| is write.
869
- */
870
- 'BluetoothEmulation.characteristicOperationReceived': [Protocol.BluetoothEmulation.CharacteristicOperationReceivedEvent];
871
- /**
872
- * Event for when a descriptor operation of |type| to the descriptor
873
- * respresented by |descriptorId| happened. |data| is expected to exist when
874
- * |type| is write.
875
- */
876
- 'BluetoothEmulation.descriptorOperationReceived': [Protocol.BluetoothEmulation.DescriptorOperationReceivedEvent];
877
877
  }
878
878
 
879
879
  export interface Commands {
@@ -1617,56 +1617,6 @@ export namespace ProtocolMapping {
1617
1617
  paramsType: [];
1618
1618
  returnType: Protocol.Audits.CheckFormsIssuesResponse;
1619
1619
  };
1620
- /**
1621
- * Installs an unpacked extension from the filesystem similar to
1622
- * --load-extension CLI flags. Returns extension ID once the extension
1623
- * has been installed. Available if the client is connected using the
1624
- * --remote-debugging-pipe flag and the --enable-unsafe-extension-debugging
1625
- * flag is set.
1626
- */
1627
- 'Extensions.loadUnpacked': {
1628
- paramsType: [Protocol.Extensions.LoadUnpackedRequest];
1629
- returnType: Protocol.Extensions.LoadUnpackedResponse;
1630
- };
1631
- /**
1632
- * Uninstalls an unpacked extension (others not supported) from the profile.
1633
- * Available if the client is connected using the --remote-debugging-pipe flag
1634
- * and the --enable-unsafe-extension-debugging.
1635
- */
1636
- 'Extensions.uninstall': {
1637
- paramsType: [Protocol.Extensions.UninstallRequest];
1638
- returnType: void;
1639
- };
1640
- /**
1641
- * Gets data from extension storage in the given `storageArea`. If `keys` is
1642
- * specified, these are used to filter the result.
1643
- */
1644
- 'Extensions.getStorageItems': {
1645
- paramsType: [Protocol.Extensions.GetStorageItemsRequest];
1646
- returnType: Protocol.Extensions.GetStorageItemsResponse;
1647
- };
1648
- /**
1649
- * Removes `keys` from extension storage in the given `storageArea`.
1650
- */
1651
- 'Extensions.removeStorageItems': {
1652
- paramsType: [Protocol.Extensions.RemoveStorageItemsRequest];
1653
- returnType: void;
1654
- };
1655
- /**
1656
- * Clears extension storage in the given `storageArea`.
1657
- */
1658
- 'Extensions.clearStorageItems': {
1659
- paramsType: [Protocol.Extensions.ClearStorageItemsRequest];
1660
- returnType: void;
1661
- };
1662
- /**
1663
- * Sets `values` in extension storage in the given `storageArea`. The provided `values`
1664
- * will be merged with existing values in the storage area.
1665
- */
1666
- 'Extensions.setStorageItems': {
1667
- paramsType: [Protocol.Extensions.SetStorageItemsRequest];
1668
- returnType: void;
1669
- };
1670
1620
  /**
1671
1621
  * Trigger autofill on a form identified by the fieldId.
1672
1622
  * If the field and related form cannot be autofilled, returns an error.
@@ -1725,30 +1675,150 @@ export namespace ProtocolMapping {
1725
1675
  returnType: void;
1726
1676
  };
1727
1677
  /**
1728
- * Set permission settings for given origin.
1678
+ * Enable the BluetoothEmulation domain.
1729
1679
  */
1730
- 'Browser.setPermission': {
1731
- paramsType: [Protocol.Browser.SetPermissionRequest];
1680
+ 'BluetoothEmulation.enable': {
1681
+ paramsType: [Protocol.BluetoothEmulation.EnableRequest];
1732
1682
  returnType: void;
1733
1683
  };
1734
1684
  /**
1735
- * Grant specific permissions to the given origin and reject all others.
1685
+ * Set the state of the simulated central.
1736
1686
  */
1737
- 'Browser.grantPermissions': {
1738
- paramsType: [Protocol.Browser.GrantPermissionsRequest];
1687
+ 'BluetoothEmulation.setSimulatedCentralState': {
1688
+ paramsType: [Protocol.BluetoothEmulation.SetSimulatedCentralStateRequest];
1739
1689
  returnType: void;
1740
1690
  };
1741
1691
  /**
1742
- * Reset all permission management for all origins.
1692
+ * Disable the BluetoothEmulation domain.
1743
1693
  */
1744
- 'Browser.resetPermissions': {
1745
- paramsType: [Protocol.Browser.ResetPermissionsRequest?];
1694
+ 'BluetoothEmulation.disable': {
1695
+ paramsType: [];
1746
1696
  returnType: void;
1747
1697
  };
1748
1698
  /**
1749
- * Set the behavior when downloading a file.
1699
+ * Simulates a peripheral with |address|, |name| and |knownServiceUuids|
1700
+ * that has already been connected to the system.
1750
1701
  */
1751
- 'Browser.setDownloadBehavior': {
1702
+ 'BluetoothEmulation.simulatePreconnectedPeripheral': {
1703
+ paramsType: [Protocol.BluetoothEmulation.SimulatePreconnectedPeripheralRequest];
1704
+ returnType: void;
1705
+ };
1706
+ /**
1707
+ * Simulates an advertisement packet described in |entry| being received by
1708
+ * the central.
1709
+ */
1710
+ 'BluetoothEmulation.simulateAdvertisement': {
1711
+ paramsType: [Protocol.BluetoothEmulation.SimulateAdvertisementRequest];
1712
+ returnType: void;
1713
+ };
1714
+ /**
1715
+ * Simulates the response code from the peripheral with |address| for a
1716
+ * GATT operation of |type|. The |code| value follows the HCI Error Codes from
1717
+ * Bluetooth Core Specification Vol 2 Part D 1.3 List Of Error Codes.
1718
+ */
1719
+ 'BluetoothEmulation.simulateGATTOperationResponse': {
1720
+ paramsType: [Protocol.BluetoothEmulation.SimulateGATTOperationResponseRequest];
1721
+ returnType: void;
1722
+ };
1723
+ /**
1724
+ * Simulates the response from the characteristic with |characteristicId| for a
1725
+ * characteristic operation of |type|. The |code| value follows the Error
1726
+ * Codes from Bluetooth Core Specification Vol 3 Part F 3.4.1.1 Error Response.
1727
+ * The |data| is expected to exist when simulating a successful read operation
1728
+ * response.
1729
+ */
1730
+ 'BluetoothEmulation.simulateCharacteristicOperationResponse': {
1731
+ paramsType: [Protocol.BluetoothEmulation.SimulateCharacteristicOperationResponseRequest];
1732
+ returnType: void;
1733
+ };
1734
+ /**
1735
+ * Simulates the response from the descriptor with |descriptorId| for a
1736
+ * descriptor operation of |type|. The |code| value follows the Error
1737
+ * Codes from Bluetooth Core Specification Vol 3 Part F 3.4.1.1 Error Response.
1738
+ * The |data| is expected to exist when simulating a successful read operation
1739
+ * response.
1740
+ */
1741
+ 'BluetoothEmulation.simulateDescriptorOperationResponse': {
1742
+ paramsType: [Protocol.BluetoothEmulation.SimulateDescriptorOperationResponseRequest];
1743
+ returnType: void;
1744
+ };
1745
+ /**
1746
+ * Adds a service with |serviceUuid| to the peripheral with |address|.
1747
+ */
1748
+ 'BluetoothEmulation.addService': {
1749
+ paramsType: [Protocol.BluetoothEmulation.AddServiceRequest];
1750
+ returnType: Protocol.BluetoothEmulation.AddServiceResponse;
1751
+ };
1752
+ /**
1753
+ * Removes the service respresented by |serviceId| from the simulated central.
1754
+ */
1755
+ 'BluetoothEmulation.removeService': {
1756
+ paramsType: [Protocol.BluetoothEmulation.RemoveServiceRequest];
1757
+ returnType: void;
1758
+ };
1759
+ /**
1760
+ * Adds a characteristic with |characteristicUuid| and |properties| to the
1761
+ * service represented by |serviceId|.
1762
+ */
1763
+ 'BluetoothEmulation.addCharacteristic': {
1764
+ paramsType: [Protocol.BluetoothEmulation.AddCharacteristicRequest];
1765
+ returnType: Protocol.BluetoothEmulation.AddCharacteristicResponse;
1766
+ };
1767
+ /**
1768
+ * Removes the characteristic respresented by |characteristicId| from the
1769
+ * simulated central.
1770
+ */
1771
+ 'BluetoothEmulation.removeCharacteristic': {
1772
+ paramsType: [Protocol.BluetoothEmulation.RemoveCharacteristicRequest];
1773
+ returnType: void;
1774
+ };
1775
+ /**
1776
+ * Adds a descriptor with |descriptorUuid| to the characteristic respresented
1777
+ * by |characteristicId|.
1778
+ */
1779
+ 'BluetoothEmulation.addDescriptor': {
1780
+ paramsType: [Protocol.BluetoothEmulation.AddDescriptorRequest];
1781
+ returnType: Protocol.BluetoothEmulation.AddDescriptorResponse;
1782
+ };
1783
+ /**
1784
+ * Removes the descriptor with |descriptorId| from the simulated central.
1785
+ */
1786
+ 'BluetoothEmulation.removeDescriptor': {
1787
+ paramsType: [Protocol.BluetoothEmulation.RemoveDescriptorRequest];
1788
+ returnType: void;
1789
+ };
1790
+ /**
1791
+ * Simulates a GATT disconnection from the peripheral with |address|.
1792
+ */
1793
+ 'BluetoothEmulation.simulateGATTDisconnection': {
1794
+ paramsType: [Protocol.BluetoothEmulation.SimulateGATTDisconnectionRequest];
1795
+ returnType: void;
1796
+ };
1797
+ /**
1798
+ * Set permission settings for given origin.
1799
+ */
1800
+ 'Browser.setPermission': {
1801
+ paramsType: [Protocol.Browser.SetPermissionRequest];
1802
+ returnType: void;
1803
+ };
1804
+ /**
1805
+ * Grant specific permissions to the given origin and reject all others.
1806
+ */
1807
+ 'Browser.grantPermissions': {
1808
+ paramsType: [Protocol.Browser.GrantPermissionsRequest];
1809
+ returnType: void;
1810
+ };
1811
+ /**
1812
+ * Reset all permission management for all origins.
1813
+ */
1814
+ 'Browser.resetPermissions': {
1815
+ paramsType: [Protocol.Browser.ResetPermissionsRequest?];
1816
+ returnType: void;
1817
+ };
1818
+ /**
1819
+ * Set the behavior when downloading a file.
1820
+ */
1821
+ 'Browser.setDownloadBehavior': {
1752
1822
  paramsType: [Protocol.Browser.SetDownloadBehaviorRequest];
1753
1823
  returnType: void;
1754
1824
  };
@@ -2704,27 +2774,6 @@ export namespace ProtocolMapping {
2704
2774
  paramsType: [Protocol.DOMDebugger.SetXHRBreakpointRequest];
2705
2775
  returnType: void;
2706
2776
  };
2707
- /**
2708
- * Sets breakpoint on particular native event.
2709
- */
2710
- 'EventBreakpoints.setInstrumentationBreakpoint': {
2711
- paramsType: [Protocol.EventBreakpoints.SetInstrumentationBreakpointRequest];
2712
- returnType: void;
2713
- };
2714
- /**
2715
- * Removes breakpoint on particular native event.
2716
- */
2717
- 'EventBreakpoints.removeInstrumentationBreakpoint': {
2718
- paramsType: [Protocol.EventBreakpoints.RemoveInstrumentationBreakpointRequest];
2719
- returnType: void;
2720
- };
2721
- /**
2722
- * Removes all breakpoints
2723
- */
2724
- 'EventBreakpoints.disable': {
2725
- paramsType: [];
2726
- returnType: void;
2727
- };
2728
2777
  /**
2729
2778
  * Disables DOM snapshot agent for the given page.
2730
2779
  */
@@ -2789,6 +2838,34 @@ export namespace ProtocolMapping {
2789
2838
  paramsType: [Protocol.DOMStorage.SetDOMStorageItemRequest];
2790
2839
  returnType: void;
2791
2840
  };
2841
+ /**
2842
+ * Enable events in this domain.
2843
+ */
2844
+ 'DeviceAccess.enable': {
2845
+ paramsType: [];
2846
+ returnType: void;
2847
+ };
2848
+ /**
2849
+ * Disable events in this domain.
2850
+ */
2851
+ 'DeviceAccess.disable': {
2852
+ paramsType: [];
2853
+ returnType: void;
2854
+ };
2855
+ /**
2856
+ * Select a device in response to a DeviceAccess.deviceRequestPrompted event.
2857
+ */
2858
+ 'DeviceAccess.selectPrompt': {
2859
+ paramsType: [Protocol.DeviceAccess.SelectPromptRequest];
2860
+ returnType: void;
2861
+ };
2862
+ /**
2863
+ * Cancel a prompt in response to a DeviceAccess.deviceRequestPrompted event.
2864
+ */
2865
+ 'DeviceAccess.cancelPrompt': {
2866
+ paramsType: [Protocol.DeviceAccess.CancelPromptRequest];
2867
+ returnType: void;
2868
+ };
2792
2869
  /**
2793
2870
  * Clears the overridden Device Orientation.
2794
2871
  */
@@ -3118,94 +3195,302 @@ export namespace ProtocolMapping {
3118
3195
  returnType: void;
3119
3196
  };
3120
3197
  /**
3121
- * Sends a BeginFrame to the target and returns when the frame was completed. Optionally captures a
3122
- * screenshot from the resulting frame. Requires that the target was created with enabled
3123
- * BeginFrameControl. Designed for use with --run-all-compositor-stages-before-draw, see also
3124
- * https://goo.gle/chrome-headless-rendering for more background.
3198
+ * Returns device's screen configuration.
3125
3199
  */
3126
- 'HeadlessExperimental.beginFrame': {
3127
- paramsType: [Protocol.HeadlessExperimental.BeginFrameRequest?];
3128
- returnType: Protocol.HeadlessExperimental.BeginFrameResponse;
3200
+ 'Emulation.getScreenInfos': {
3201
+ paramsType: [];
3202
+ returnType: Protocol.Emulation.GetScreenInfosResponse;
3129
3203
  };
3130
3204
  /**
3131
- * Disables headless events for the target.
3205
+ * Add a new screen to the device. Only supported in headless mode.
3132
3206
  */
3133
- 'HeadlessExperimental.disable': {
3134
- paramsType: [];
3135
- returnType: void;
3207
+ 'Emulation.addScreen': {
3208
+ paramsType: [Protocol.Emulation.AddScreenRequest];
3209
+ returnType: Protocol.Emulation.AddScreenResponse;
3136
3210
  };
3137
3211
  /**
3138
- * Enables headless events for the target.
3212
+ * Remove screen from the device. Only supported in headless mode.
3139
3213
  */
3140
- 'HeadlessExperimental.enable': {
3141
- paramsType: [];
3214
+ 'Emulation.removeScreen': {
3215
+ paramsType: [Protocol.Emulation.RemoveScreenRequest];
3142
3216
  returnType: void;
3143
3217
  };
3144
3218
  /**
3145
- * Close the stream, discard any temporary backing storage.
3219
+ * Sets breakpoint on particular native event.
3146
3220
  */
3147
- 'IO.close': {
3148
- paramsType: [Protocol.IO.CloseRequest];
3221
+ 'EventBreakpoints.setInstrumentationBreakpoint': {
3222
+ paramsType: [Protocol.EventBreakpoints.SetInstrumentationBreakpointRequest];
3149
3223
  returnType: void;
3150
3224
  };
3151
3225
  /**
3152
- * Read a chunk of the stream
3226
+ * Removes breakpoint on particular native event.
3153
3227
  */
3154
- 'IO.read': {
3155
- paramsType: [Protocol.IO.ReadRequest];
3156
- returnType: Protocol.IO.ReadResponse;
3228
+ 'EventBreakpoints.removeInstrumentationBreakpoint': {
3229
+ paramsType: [Protocol.EventBreakpoints.RemoveInstrumentationBreakpointRequest];
3230
+ returnType: void;
3157
3231
  };
3158
3232
  /**
3159
- * Return UUID of Blob object specified by a remote object id.
3233
+ * Removes all breakpoints
3160
3234
  */
3161
- 'IO.resolveBlob': {
3162
- paramsType: [Protocol.IO.ResolveBlobRequest];
3163
- returnType: Protocol.IO.ResolveBlobResponse;
3164
- };
3165
- 'FileSystem.getDirectory': {
3166
- paramsType: [Protocol.FileSystem.GetDirectoryRequest];
3167
- returnType: Protocol.FileSystem.GetDirectoryResponse;
3235
+ 'EventBreakpoints.disable': {
3236
+ paramsType: [];
3237
+ returnType: void;
3168
3238
  };
3169
3239
  /**
3170
- * Clears all entries from an object store.
3240
+ * Installs an unpacked extension from the filesystem similar to
3241
+ * --load-extension CLI flags. Returns extension ID once the extension
3242
+ * has been installed. Available if the client is connected using the
3243
+ * --remote-debugging-pipe flag and the --enable-unsafe-extension-debugging
3244
+ * flag is set.
3171
3245
  */
3172
- 'IndexedDB.clearObjectStore': {
3173
- paramsType: [Protocol.IndexedDB.ClearObjectStoreRequest];
3174
- returnType: void;
3246
+ 'Extensions.loadUnpacked': {
3247
+ paramsType: [Protocol.Extensions.LoadUnpackedRequest];
3248
+ returnType: Protocol.Extensions.LoadUnpackedResponse;
3175
3249
  };
3176
3250
  /**
3177
- * Deletes a database.
3251
+ * Uninstalls an unpacked extension (others not supported) from the profile.
3252
+ * Available if the client is connected using the --remote-debugging-pipe flag
3253
+ * and the --enable-unsafe-extension-debugging.
3178
3254
  */
3179
- 'IndexedDB.deleteDatabase': {
3180
- paramsType: [Protocol.IndexedDB.DeleteDatabaseRequest];
3255
+ 'Extensions.uninstall': {
3256
+ paramsType: [Protocol.Extensions.UninstallRequest];
3181
3257
  returnType: void;
3182
3258
  };
3183
3259
  /**
3184
- * Delete a range of entries from an object store
3260
+ * Gets data from extension storage in the given `storageArea`. If `keys` is
3261
+ * specified, these are used to filter the result.
3185
3262
  */
3186
- 'IndexedDB.deleteObjectStoreEntries': {
3187
- paramsType: [Protocol.IndexedDB.DeleteObjectStoreEntriesRequest];
3188
- returnType: void;
3263
+ 'Extensions.getStorageItems': {
3264
+ paramsType: [Protocol.Extensions.GetStorageItemsRequest];
3265
+ returnType: Protocol.Extensions.GetStorageItemsResponse;
3189
3266
  };
3190
3267
  /**
3191
- * Disables events from backend.
3268
+ * Removes `keys` from extension storage in the given `storageArea`.
3192
3269
  */
3193
- 'IndexedDB.disable': {
3194
- paramsType: [];
3270
+ 'Extensions.removeStorageItems': {
3271
+ paramsType: [Protocol.Extensions.RemoveStorageItemsRequest];
3195
3272
  returnType: void;
3196
3273
  };
3197
3274
  /**
3198
- * Enables events from backend.
3275
+ * Clears extension storage in the given `storageArea`.
3199
3276
  */
3200
- 'IndexedDB.enable': {
3201
- paramsType: [];
3277
+ 'Extensions.clearStorageItems': {
3278
+ paramsType: [Protocol.Extensions.ClearStorageItemsRequest];
3202
3279
  returnType: void;
3203
3280
  };
3204
3281
  /**
3205
- * Requests data from object store or index.
3282
+ * Sets `values` in extension storage in the given `storageArea`. The provided `values`
3283
+ * will be merged with existing values in the storage area.
3206
3284
  */
3207
- 'IndexedDB.requestData': {
3208
- paramsType: [Protocol.IndexedDB.RequestDataRequest];
3285
+ 'Extensions.setStorageItems': {
3286
+ paramsType: [Protocol.Extensions.SetStorageItemsRequest];
3287
+ returnType: void;
3288
+ };
3289
+ 'FedCm.enable': {
3290
+ paramsType: [Protocol.FedCm.EnableRequest?];
3291
+ returnType: void;
3292
+ };
3293
+ 'FedCm.disable': {
3294
+ paramsType: [];
3295
+ returnType: void;
3296
+ };
3297
+ 'FedCm.selectAccount': {
3298
+ paramsType: [Protocol.FedCm.SelectAccountRequest];
3299
+ returnType: void;
3300
+ };
3301
+ 'FedCm.clickDialogButton': {
3302
+ paramsType: [Protocol.FedCm.ClickDialogButtonRequest];
3303
+ returnType: void;
3304
+ };
3305
+ 'FedCm.openUrl': {
3306
+ paramsType: [Protocol.FedCm.OpenUrlRequest];
3307
+ returnType: void;
3308
+ };
3309
+ 'FedCm.dismissDialog': {
3310
+ paramsType: [Protocol.FedCm.DismissDialogRequest];
3311
+ returnType: void;
3312
+ };
3313
+ /**
3314
+ * Resets the cooldown time, if any, to allow the next FedCM call to show
3315
+ * a dialog even if one was recently dismissed by the user.
3316
+ */
3317
+ 'FedCm.resetCooldown': {
3318
+ paramsType: [];
3319
+ returnType: void;
3320
+ };
3321
+ /**
3322
+ * Disables the fetch domain.
3323
+ */
3324
+ 'Fetch.disable': {
3325
+ paramsType: [];
3326
+ returnType: void;
3327
+ };
3328
+ /**
3329
+ * Enables issuing of requestPaused events. A request will be paused until client
3330
+ * calls one of failRequest, fulfillRequest or continueRequest/continueWithAuth.
3331
+ */
3332
+ 'Fetch.enable': {
3333
+ paramsType: [Protocol.Fetch.EnableRequest?];
3334
+ returnType: void;
3335
+ };
3336
+ /**
3337
+ * Causes the request to fail with specified reason.
3338
+ */
3339
+ 'Fetch.failRequest': {
3340
+ paramsType: [Protocol.Fetch.FailRequestRequest];
3341
+ returnType: void;
3342
+ };
3343
+ /**
3344
+ * Provides response to the request.
3345
+ */
3346
+ 'Fetch.fulfillRequest': {
3347
+ paramsType: [Protocol.Fetch.FulfillRequestRequest];
3348
+ returnType: void;
3349
+ };
3350
+ /**
3351
+ * Continues the request, optionally modifying some of its parameters.
3352
+ */
3353
+ 'Fetch.continueRequest': {
3354
+ paramsType: [Protocol.Fetch.ContinueRequestRequest];
3355
+ returnType: void;
3356
+ };
3357
+ /**
3358
+ * Continues a request supplying authChallengeResponse following authRequired event.
3359
+ */
3360
+ 'Fetch.continueWithAuth': {
3361
+ paramsType: [Protocol.Fetch.ContinueWithAuthRequest];
3362
+ returnType: void;
3363
+ };
3364
+ /**
3365
+ * Continues loading of the paused response, optionally modifying the
3366
+ * response headers. If either responseCode or headers are modified, all of them
3367
+ * must be present.
3368
+ */
3369
+ 'Fetch.continueResponse': {
3370
+ paramsType: [Protocol.Fetch.ContinueResponseRequest];
3371
+ returnType: void;
3372
+ };
3373
+ /**
3374
+ * Causes the body of the response to be received from the server and
3375
+ * returned as a single string. May only be issued for a request that
3376
+ * is paused in the Response stage and is mutually exclusive with
3377
+ * takeResponseBodyForInterceptionAsStream. Calling other methods that
3378
+ * affect the request or disabling fetch domain before body is received
3379
+ * results in an undefined behavior.
3380
+ * Note that the response body is not available for redirects. Requests
3381
+ * paused in the _redirect received_ state may be differentiated by
3382
+ * `responseCode` and presence of `location` response header, see
3383
+ * comments to `requestPaused` for details.
3384
+ */
3385
+ 'Fetch.getResponseBody': {
3386
+ paramsType: [Protocol.Fetch.GetResponseBodyRequest];
3387
+ returnType: Protocol.Fetch.GetResponseBodyResponse;
3388
+ };
3389
+ /**
3390
+ * Returns a handle to the stream representing the response body.
3391
+ * The request must be paused in the HeadersReceived stage.
3392
+ * Note that after this command the request can't be continued
3393
+ * as is -- client either needs to cancel it or to provide the
3394
+ * response body.
3395
+ * The stream only supports sequential read, IO.read will fail if the position
3396
+ * is specified.
3397
+ * This method is mutually exclusive with getResponseBody.
3398
+ * Calling other methods that affect the request or disabling fetch
3399
+ * domain before body is received results in an undefined behavior.
3400
+ */
3401
+ 'Fetch.takeResponseBodyAsStream': {
3402
+ paramsType: [Protocol.Fetch.TakeResponseBodyAsStreamRequest];
3403
+ returnType: Protocol.Fetch.TakeResponseBodyAsStreamResponse;
3404
+ };
3405
+ 'FileSystem.getDirectory': {
3406
+ paramsType: [Protocol.FileSystem.GetDirectoryRequest];
3407
+ returnType: Protocol.FileSystem.GetDirectoryResponse;
3408
+ };
3409
+ /**
3410
+ * Sends a BeginFrame to the target and returns when the frame was completed. Optionally captures a
3411
+ * screenshot from the resulting frame. Requires that the target was created with enabled
3412
+ * BeginFrameControl. Designed for use with --run-all-compositor-stages-before-draw, see also
3413
+ * https://goo.gle/chrome-headless-rendering for more background.
3414
+ */
3415
+ 'HeadlessExperimental.beginFrame': {
3416
+ paramsType: [Protocol.HeadlessExperimental.BeginFrameRequest?];
3417
+ returnType: Protocol.HeadlessExperimental.BeginFrameResponse;
3418
+ };
3419
+ /**
3420
+ * Disables headless events for the target.
3421
+ */
3422
+ 'HeadlessExperimental.disable': {
3423
+ paramsType: [];
3424
+ returnType: void;
3425
+ };
3426
+ /**
3427
+ * Enables headless events for the target.
3428
+ */
3429
+ 'HeadlessExperimental.enable': {
3430
+ paramsType: [];
3431
+ returnType: void;
3432
+ };
3433
+ /**
3434
+ * Close the stream, discard any temporary backing storage.
3435
+ */
3436
+ 'IO.close': {
3437
+ paramsType: [Protocol.IO.CloseRequest];
3438
+ returnType: void;
3439
+ };
3440
+ /**
3441
+ * Read a chunk of the stream
3442
+ */
3443
+ 'IO.read': {
3444
+ paramsType: [Protocol.IO.ReadRequest];
3445
+ returnType: Protocol.IO.ReadResponse;
3446
+ };
3447
+ /**
3448
+ * Return UUID of Blob object specified by a remote object id.
3449
+ */
3450
+ 'IO.resolveBlob': {
3451
+ paramsType: [Protocol.IO.ResolveBlobRequest];
3452
+ returnType: Protocol.IO.ResolveBlobResponse;
3453
+ };
3454
+ /**
3455
+ * Clears all entries from an object store.
3456
+ */
3457
+ 'IndexedDB.clearObjectStore': {
3458
+ paramsType: [Protocol.IndexedDB.ClearObjectStoreRequest];
3459
+ returnType: void;
3460
+ };
3461
+ /**
3462
+ * Deletes a database.
3463
+ */
3464
+ 'IndexedDB.deleteDatabase': {
3465
+ paramsType: [Protocol.IndexedDB.DeleteDatabaseRequest];
3466
+ returnType: void;
3467
+ };
3468
+ /**
3469
+ * Delete a range of entries from an object store
3470
+ */
3471
+ 'IndexedDB.deleteObjectStoreEntries': {
3472
+ paramsType: [Protocol.IndexedDB.DeleteObjectStoreEntriesRequest];
3473
+ returnType: void;
3474
+ };
3475
+ /**
3476
+ * Disables events from backend.
3477
+ */
3478
+ 'IndexedDB.disable': {
3479
+ paramsType: [];
3480
+ returnType: void;
3481
+ };
3482
+ /**
3483
+ * Enables events from backend.
3484
+ */
3485
+ 'IndexedDB.enable': {
3486
+ paramsType: [];
3487
+ returnType: void;
3488
+ };
3489
+ /**
3490
+ * Requests data from object store or index.
3491
+ */
3492
+ 'IndexedDB.requestData': {
3493
+ paramsType: [Protocol.IndexedDB.RequestDataRequest];
3209
3494
  returnType: Protocol.IndexedDB.RequestDataResponse;
3210
3495
  };
3211
3496
  /**
@@ -3434,6 +3719,20 @@ export namespace ProtocolMapping {
3434
3719
  paramsType: [];
3435
3720
  returnType: void;
3436
3721
  };
3722
+ /**
3723
+ * Enables the Media domain
3724
+ */
3725
+ 'Media.enable': {
3726
+ paramsType: [];
3727
+ returnType: void;
3728
+ };
3729
+ /**
3730
+ * Disables the Media domain.
3731
+ */
3732
+ 'Media.disable': {
3733
+ paramsType: [];
3734
+ returnType: void;
3735
+ };
3437
3736
  /**
3438
3737
  * Retruns current DOM object counters.
3439
3738
  */
@@ -3845,6 +4144,9 @@ export namespace ProtocolMapping {
3845
4144
  };
3846
4145
  /**
3847
4146
  * Highlights given rectangle. Coordinates are absolute with respect to the main frame viewport.
4147
+ * Issue: the method does not handle device pixel ratio (DPR) correctly.
4148
+ * The coordinates currently have to be adjusted by the client
4149
+ * if DPR is not 1 (see crbug.com/437807128).
3848
4150
  */
3849
4151
  'Overlay.highlightRect': {
3850
4152
  paramsType: [Protocol.Overlay.HighlightRectRequest];
@@ -3974,38 +4276,135 @@ export namespace ProtocolMapping {
3974
4276
  returnType: void;
3975
4277
  };
3976
4278
  /**
3977
- * Deprecated, please use addScriptToEvaluateOnNewDocument instead.
3978
- */
3979
- 'Page.addScriptToEvaluateOnLoad': {
3980
- paramsType: [Protocol.Page.AddScriptToEvaluateOnLoadRequest];
3981
- returnType: Protocol.Page.AddScriptToEvaluateOnLoadResponse;
3982
- };
3983
- /**
3984
- * Evaluates given script in every frame upon creation (before loading frame's scripts).
3985
- */
3986
- 'Page.addScriptToEvaluateOnNewDocument': {
3987
- paramsType: [Protocol.Page.AddScriptToEvaluateOnNewDocumentRequest];
3988
- returnType: Protocol.Page.AddScriptToEvaluateOnNewDocumentResponse;
3989
- };
3990
- /**
3991
- * Brings page to front (activates tab).
3992
- */
3993
- 'Page.bringToFront': {
3994
- paramsType: [];
3995
- returnType: void;
3996
- };
3997
- /**
3998
- * Capture page screenshot.
4279
+ * Returns the following OS state for the given manifest id.
3999
4280
  */
4000
- 'Page.captureScreenshot': {
4001
- paramsType: [Protocol.Page.CaptureScreenshotRequest?];
4002
- returnType: Protocol.Page.CaptureScreenshotResponse;
4281
+ 'PWA.getOsAppState': {
4282
+ paramsType: [Protocol.PWA.GetOsAppStateRequest];
4283
+ returnType: Protocol.PWA.GetOsAppStateResponse;
4003
4284
  };
4004
4285
  /**
4005
- * Returns a snapshot of the page as a string. For MHTML format, the serialization includes
4006
- * iframes, shadow DOM, external resources, and element-inline styles.
4007
- */
4008
- 'Page.captureSnapshot': {
4286
+ * Installs the given manifest identity, optionally using the given installUrlOrBundleUrl
4287
+ *
4288
+ * IWA-specific install description:
4289
+ * manifestId corresponds to isolated-app:// + web_package::SignedWebBundleId
4290
+ *
4291
+ * File installation mode:
4292
+ * The installUrlOrBundleUrl can be either file:// or http(s):// pointing
4293
+ * to a signed web bundle (.swbn). In this case SignedWebBundleId must correspond to
4294
+ * The .swbn file's signing key.
4295
+ *
4296
+ * Dev proxy installation mode:
4297
+ * installUrlOrBundleUrl must be http(s):// that serves dev mode IWA.
4298
+ * web_package::SignedWebBundleId must be of type dev proxy.
4299
+ *
4300
+ * The advantage of dev proxy mode is that all changes to IWA
4301
+ * automatically will be reflected in the running app without
4302
+ * reinstallation.
4303
+ *
4304
+ * To generate bundle id for proxy mode:
4305
+ * 1. Generate 32 random bytes.
4306
+ * 2. Add a specific suffix 0x00 at the end.
4307
+ * 3. Encode the entire sequence using Base32 without padding.
4308
+ *
4309
+ * If Chrome is not in IWA dev
4310
+ * mode, the installation will fail, regardless of the state of the allowlist.
4311
+ */
4312
+ 'PWA.install': {
4313
+ paramsType: [Protocol.PWA.InstallRequest];
4314
+ returnType: void;
4315
+ };
4316
+ /**
4317
+ * Uninstalls the given manifest_id and closes any opened app windows.
4318
+ */
4319
+ 'PWA.uninstall': {
4320
+ paramsType: [Protocol.PWA.UninstallRequest];
4321
+ returnType: void;
4322
+ };
4323
+ /**
4324
+ * Launches the installed web app, or an url in the same web app instead of the
4325
+ * default start url if it is provided. Returns a page Target.TargetID which
4326
+ * can be used to attach to via Target.attachToTarget or similar APIs.
4327
+ */
4328
+ 'PWA.launch': {
4329
+ paramsType: [Protocol.PWA.LaunchRequest];
4330
+ returnType: Protocol.PWA.LaunchResponse;
4331
+ };
4332
+ /**
4333
+ * Opens one or more local files from an installed web app identified by its
4334
+ * manifestId. The web app needs to have file handlers registered to process
4335
+ * the files. The API returns one or more page Target.TargetIDs which can be
4336
+ * used to attach to via Target.attachToTarget or similar APIs.
4337
+ * If some files in the parameters cannot be handled by the web app, they will
4338
+ * be ignored. If none of the files can be handled, this API returns an error.
4339
+ * If no files are provided as the parameter, this API also returns an error.
4340
+ *
4341
+ * According to the definition of the file handlers in the manifest file, one
4342
+ * Target.TargetID may represent a page handling one or more files. The order
4343
+ * of the returned Target.TargetIDs is not guaranteed.
4344
+ *
4345
+ * TODO(crbug.com/339454034): Check the existences of the input files.
4346
+ */
4347
+ 'PWA.launchFilesInApp': {
4348
+ paramsType: [Protocol.PWA.LaunchFilesInAppRequest];
4349
+ returnType: Protocol.PWA.LaunchFilesInAppResponse;
4350
+ };
4351
+ /**
4352
+ * Opens the current page in its web app identified by the manifest id, needs
4353
+ * to be called on a page target. This function returns immediately without
4354
+ * waiting for the app to finish loading.
4355
+ */
4356
+ 'PWA.openCurrentPageInApp': {
4357
+ paramsType: [Protocol.PWA.OpenCurrentPageInAppRequest];
4358
+ returnType: void;
4359
+ };
4360
+ /**
4361
+ * Changes user settings of the web app identified by its manifestId. If the
4362
+ * app was not installed, this command returns an error. Unset parameters will
4363
+ * be ignored; unrecognized values will cause an error.
4364
+ *
4365
+ * Unlike the ones defined in the manifest files of the web apps, these
4366
+ * settings are provided by the browser and controlled by the users, they
4367
+ * impact the way the browser handling the web apps.
4368
+ *
4369
+ * See the comment of each parameter.
4370
+ */
4371
+ 'PWA.changeAppUserSettings': {
4372
+ paramsType: [Protocol.PWA.ChangeAppUserSettingsRequest];
4373
+ returnType: void;
4374
+ };
4375
+ /**
4376
+ * Deprecated, please use addScriptToEvaluateOnNewDocument instead.
4377
+ */
4378
+ 'Page.addScriptToEvaluateOnLoad': {
4379
+ paramsType: [Protocol.Page.AddScriptToEvaluateOnLoadRequest];
4380
+ returnType: Protocol.Page.AddScriptToEvaluateOnLoadResponse;
4381
+ };
4382
+ /**
4383
+ * Evaluates given script in every frame upon creation (before loading frame's scripts).
4384
+ */
4385
+ 'Page.addScriptToEvaluateOnNewDocument': {
4386
+ paramsType: [Protocol.Page.AddScriptToEvaluateOnNewDocumentRequest];
4387
+ returnType: Protocol.Page.AddScriptToEvaluateOnNewDocumentResponse;
4388
+ };
4389
+ /**
4390
+ * Brings page to front (activates tab).
4391
+ */
4392
+ 'Page.bringToFront': {
4393
+ paramsType: [];
4394
+ returnType: void;
4395
+ };
4396
+ /**
4397
+ * Capture page screenshot.
4398
+ */
4399
+ 'Page.captureScreenshot': {
4400
+ paramsType: [Protocol.Page.CaptureScreenshotRequest?];
4401
+ returnType: Protocol.Page.CaptureScreenshotResponse;
4402
+ };
4403
+ /**
4404
+ * Returns a snapshot of the page as a string. For MHTML format, the serialization includes
4405
+ * iframes, shadow DOM, external resources, and element-inline styles.
4406
+ */
4407
+ 'Page.captureSnapshot': {
4009
4408
  paramsType: [Protocol.Page.CaptureSnapshotRequest?];
4010
4409
  returnType: Protocol.Page.CaptureSnapshotResponse;
4011
4410
  };
@@ -4452,6 +4851,14 @@ export namespace ProtocolMapping {
4452
4851
  paramsType: [Protocol.PerformanceTimeline.EnableRequest];
4453
4852
  returnType: void;
4454
4853
  };
4854
+ 'Preload.enable': {
4855
+ paramsType: [];
4856
+ returnType: void;
4857
+ };
4858
+ 'Preload.disable': {
4859
+ paramsType: [];
4860
+ returnType: void;
4861
+ };
4455
4862
  /**
4456
4863
  * Disables tracking security state changes.
4457
4864
  */
@@ -5019,90 +5426,6 @@ export namespace ProtocolMapping {
5019
5426
  paramsType: [Protocol.Tracing.StartRequest?];
5020
5427
  returnType: void;
5021
5428
  };
5022
- /**
5023
- * Disables the fetch domain.
5024
- */
5025
- 'Fetch.disable': {
5026
- paramsType: [];
5027
- returnType: void;
5028
- };
5029
- /**
5030
- * Enables issuing of requestPaused events. A request will be paused until client
5031
- * calls one of failRequest, fulfillRequest or continueRequest/continueWithAuth.
5032
- */
5033
- 'Fetch.enable': {
5034
- paramsType: [Protocol.Fetch.EnableRequest?];
5035
- returnType: void;
5036
- };
5037
- /**
5038
- * Causes the request to fail with specified reason.
5039
- */
5040
- 'Fetch.failRequest': {
5041
- paramsType: [Protocol.Fetch.FailRequestRequest];
5042
- returnType: void;
5043
- };
5044
- /**
5045
- * Provides response to the request.
5046
- */
5047
- 'Fetch.fulfillRequest': {
5048
- paramsType: [Protocol.Fetch.FulfillRequestRequest];
5049
- returnType: void;
5050
- };
5051
- /**
5052
- * Continues the request, optionally modifying some of its parameters.
5053
- */
5054
- 'Fetch.continueRequest': {
5055
- paramsType: [Protocol.Fetch.ContinueRequestRequest];
5056
- returnType: void;
5057
- };
5058
- /**
5059
- * Continues a request supplying authChallengeResponse following authRequired event.
5060
- */
5061
- 'Fetch.continueWithAuth': {
5062
- paramsType: [Protocol.Fetch.ContinueWithAuthRequest];
5063
- returnType: void;
5064
- };
5065
- /**
5066
- * Continues loading of the paused response, optionally modifying the
5067
- * response headers. If either responseCode or headers are modified, all of them
5068
- * must be present.
5069
- */
5070
- 'Fetch.continueResponse': {
5071
- paramsType: [Protocol.Fetch.ContinueResponseRequest];
5072
- returnType: void;
5073
- };
5074
- /**
5075
- * Causes the body of the response to be received from the server and
5076
- * returned as a single string. May only be issued for a request that
5077
- * is paused in the Response stage and is mutually exclusive with
5078
- * takeResponseBodyForInterceptionAsStream. Calling other methods that
5079
- * affect the request or disabling fetch domain before body is received
5080
- * results in an undefined behavior.
5081
- * Note that the response body is not available for redirects. Requests
5082
- * paused in the _redirect received_ state may be differentiated by
5083
- * `responseCode` and presence of `location` response header, see
5084
- * comments to `requestPaused` for details.
5085
- */
5086
- 'Fetch.getResponseBody': {
5087
- paramsType: [Protocol.Fetch.GetResponseBodyRequest];
5088
- returnType: Protocol.Fetch.GetResponseBodyResponse;
5089
- };
5090
- /**
5091
- * Returns a handle to the stream representing the response body.
5092
- * The request must be paused in the HeadersReceived stage.
5093
- * Note that after this command the request can't be continued
5094
- * as is -- client either needs to cancel it or to provide the
5095
- * response body.
5096
- * The stream only supports sequential read, IO.read will fail if the position
5097
- * is specified.
5098
- * This method is mutually exclusive with getResponseBody.
5099
- * Calling other methods that affect the request or disabling fetch
5100
- * domain before body is received results in an undefined behavior.
5101
- */
5102
- 'Fetch.takeResponseBodyAsStream': {
5103
- paramsType: [Protocol.Fetch.TakeResponseBodyAsStreamRequest];
5104
- returnType: Protocol.Fetch.TakeResponseBodyAsStreamResponse;
5105
- };
5106
5429
  /**
5107
5430
  * Enables the WebAudio domain and starts sending context lifetime events.
5108
5431
  */
@@ -5220,305 +5543,6 @@ export namespace ProtocolMapping {
5220
5543
  paramsType: [Protocol.WebAuthn.SetCredentialPropertiesRequest];
5221
5544
  returnType: void;
5222
5545
  };
5223
- /**
5224
- * Enables the Media domain
5225
- */
5226
- 'Media.enable': {
5227
- paramsType: [];
5228
- returnType: void;
5229
- };
5230
- /**
5231
- * Disables the Media domain.
5232
- */
5233
- 'Media.disable': {
5234
- paramsType: [];
5235
- returnType: void;
5236
- };
5237
- /**
5238
- * Enable events in this domain.
5239
- */
5240
- 'DeviceAccess.enable': {
5241
- paramsType: [];
5242
- returnType: void;
5243
- };
5244
- /**
5245
- * Disable events in this domain.
5246
- */
5247
- 'DeviceAccess.disable': {
5248
- paramsType: [];
5249
- returnType: void;
5250
- };
5251
- /**
5252
- * Select a device in response to a DeviceAccess.deviceRequestPrompted event.
5253
- */
5254
- 'DeviceAccess.selectPrompt': {
5255
- paramsType: [Protocol.DeviceAccess.SelectPromptRequest];
5256
- returnType: void;
5257
- };
5258
- /**
5259
- * Cancel a prompt in response to a DeviceAccess.deviceRequestPrompted event.
5260
- */
5261
- 'DeviceAccess.cancelPrompt': {
5262
- paramsType: [Protocol.DeviceAccess.CancelPromptRequest];
5263
- returnType: void;
5264
- };
5265
- 'Preload.enable': {
5266
- paramsType: [];
5267
- returnType: void;
5268
- };
5269
- 'Preload.disable': {
5270
- paramsType: [];
5271
- returnType: void;
5272
- };
5273
- 'FedCm.enable': {
5274
- paramsType: [Protocol.FedCm.EnableRequest?];
5275
- returnType: void;
5276
- };
5277
- 'FedCm.disable': {
5278
- paramsType: [];
5279
- returnType: void;
5280
- };
5281
- 'FedCm.selectAccount': {
5282
- paramsType: [Protocol.FedCm.SelectAccountRequest];
5283
- returnType: void;
5284
- };
5285
- 'FedCm.clickDialogButton': {
5286
- paramsType: [Protocol.FedCm.ClickDialogButtonRequest];
5287
- returnType: void;
5288
- };
5289
- 'FedCm.openUrl': {
5290
- paramsType: [Protocol.FedCm.OpenUrlRequest];
5291
- returnType: void;
5292
- };
5293
- 'FedCm.dismissDialog': {
5294
- paramsType: [Protocol.FedCm.DismissDialogRequest];
5295
- returnType: void;
5296
- };
5297
- /**
5298
- * Resets the cooldown time, if any, to allow the next FedCM call to show
5299
- * a dialog even if one was recently dismissed by the user.
5300
- */
5301
- 'FedCm.resetCooldown': {
5302
- paramsType: [];
5303
- returnType: void;
5304
- };
5305
- /**
5306
- * Returns the following OS state for the given manifest id.
5307
- */
5308
- 'PWA.getOsAppState': {
5309
- paramsType: [Protocol.PWA.GetOsAppStateRequest];
5310
- returnType: Protocol.PWA.GetOsAppStateResponse;
5311
- };
5312
- /**
5313
- * Installs the given manifest identity, optionally using the given installUrlOrBundleUrl
5314
- *
5315
- * IWA-specific install description:
5316
- * manifestId corresponds to isolated-app:// + web_package::SignedWebBundleId
5317
- *
5318
- * File installation mode:
5319
- * The installUrlOrBundleUrl can be either file:// or http(s):// pointing
5320
- * to a signed web bundle (.swbn). In this case SignedWebBundleId must correspond to
5321
- * The .swbn file's signing key.
5322
- *
5323
- * Dev proxy installation mode:
5324
- * installUrlOrBundleUrl must be http(s):// that serves dev mode IWA.
5325
- * web_package::SignedWebBundleId must be of type dev proxy.
5326
- *
5327
- * The advantage of dev proxy mode is that all changes to IWA
5328
- * automatically will be reflected in the running app without
5329
- * reinstallation.
5330
- *
5331
- * To generate bundle id for proxy mode:
5332
- * 1. Generate 32 random bytes.
5333
- * 2. Add a specific suffix 0x00 at the end.
5334
- * 3. Encode the entire sequence using Base32 without padding.
5335
- *
5336
- * If Chrome is not in IWA dev
5337
- * mode, the installation will fail, regardless of the state of the allowlist.
5338
- */
5339
- 'PWA.install': {
5340
- paramsType: [Protocol.PWA.InstallRequest];
5341
- returnType: void;
5342
- };
5343
- /**
5344
- * Uninstalls the given manifest_id and closes any opened app windows.
5345
- */
5346
- 'PWA.uninstall': {
5347
- paramsType: [Protocol.PWA.UninstallRequest];
5348
- returnType: void;
5349
- };
5350
- /**
5351
- * Launches the installed web app, or an url in the same web app instead of the
5352
- * default start url if it is provided. Returns a page Target.TargetID which
5353
- * can be used to attach to via Target.attachToTarget or similar APIs.
5354
- */
5355
- 'PWA.launch': {
5356
- paramsType: [Protocol.PWA.LaunchRequest];
5357
- returnType: Protocol.PWA.LaunchResponse;
5358
- };
5359
- /**
5360
- * Opens one or more local files from an installed web app identified by its
5361
- * manifestId. The web app needs to have file handlers registered to process
5362
- * the files. The API returns one or more page Target.TargetIDs which can be
5363
- * used to attach to via Target.attachToTarget or similar APIs.
5364
- * If some files in the parameters cannot be handled by the web app, they will
5365
- * be ignored. If none of the files can be handled, this API returns an error.
5366
- * If no files are provided as the parameter, this API also returns an error.
5367
- *
5368
- * According to the definition of the file handlers in the manifest file, one
5369
- * Target.TargetID may represent a page handling one or more files. The order
5370
- * of the returned Target.TargetIDs is not guaranteed.
5371
- *
5372
- * TODO(crbug.com/339454034): Check the existences of the input files.
5373
- */
5374
- 'PWA.launchFilesInApp': {
5375
- paramsType: [Protocol.PWA.LaunchFilesInAppRequest];
5376
- returnType: Protocol.PWA.LaunchFilesInAppResponse;
5377
- };
5378
- /**
5379
- * Opens the current page in its web app identified by the manifest id, needs
5380
- * to be called on a page target. This function returns immediately without
5381
- * waiting for the app to finish loading.
5382
- */
5383
- 'PWA.openCurrentPageInApp': {
5384
- paramsType: [Protocol.PWA.OpenCurrentPageInAppRequest];
5385
- returnType: void;
5386
- };
5387
- /**
5388
- * Changes user settings of the web app identified by its manifestId. If the
5389
- * app was not installed, this command returns an error. Unset parameters will
5390
- * be ignored; unrecognized values will cause an error.
5391
- *
5392
- * Unlike the ones defined in the manifest files of the web apps, these
5393
- * settings are provided by the browser and controlled by the users, they
5394
- * impact the way the browser handling the web apps.
5395
- *
5396
- * See the comment of each parameter.
5397
- */
5398
- 'PWA.changeAppUserSettings': {
5399
- paramsType: [Protocol.PWA.ChangeAppUserSettingsRequest];
5400
- returnType: void;
5401
- };
5402
- /**
5403
- * Enable the BluetoothEmulation domain.
5404
- */
5405
- 'BluetoothEmulation.enable': {
5406
- paramsType: [Protocol.BluetoothEmulation.EnableRequest];
5407
- returnType: void;
5408
- };
5409
- /**
5410
- * Set the state of the simulated central.
5411
- */
5412
- 'BluetoothEmulation.setSimulatedCentralState': {
5413
- paramsType: [Protocol.BluetoothEmulation.SetSimulatedCentralStateRequest];
5414
- returnType: void;
5415
- };
5416
- /**
5417
- * Disable the BluetoothEmulation domain.
5418
- */
5419
- 'BluetoothEmulation.disable': {
5420
- paramsType: [];
5421
- returnType: void;
5422
- };
5423
- /**
5424
- * Simulates a peripheral with |address|, |name| and |knownServiceUuids|
5425
- * that has already been connected to the system.
5426
- */
5427
- 'BluetoothEmulation.simulatePreconnectedPeripheral': {
5428
- paramsType: [Protocol.BluetoothEmulation.SimulatePreconnectedPeripheralRequest];
5429
- returnType: void;
5430
- };
5431
- /**
5432
- * Simulates an advertisement packet described in |entry| being received by
5433
- * the central.
5434
- */
5435
- 'BluetoothEmulation.simulateAdvertisement': {
5436
- paramsType: [Protocol.BluetoothEmulation.SimulateAdvertisementRequest];
5437
- returnType: void;
5438
- };
5439
- /**
5440
- * Simulates the response code from the peripheral with |address| for a
5441
- * GATT operation of |type|. The |code| value follows the HCI Error Codes from
5442
- * Bluetooth Core Specification Vol 2 Part D 1.3 List Of Error Codes.
5443
- */
5444
- 'BluetoothEmulation.simulateGATTOperationResponse': {
5445
- paramsType: [Protocol.BluetoothEmulation.SimulateGATTOperationResponseRequest];
5446
- returnType: void;
5447
- };
5448
- /**
5449
- * Simulates the response from the characteristic with |characteristicId| for a
5450
- * characteristic operation of |type|. The |code| value follows the Error
5451
- * Codes from Bluetooth Core Specification Vol 3 Part F 3.4.1.1 Error Response.
5452
- * The |data| is expected to exist when simulating a successful read operation
5453
- * response.
5454
- */
5455
- 'BluetoothEmulation.simulateCharacteristicOperationResponse': {
5456
- paramsType: [Protocol.BluetoothEmulation.SimulateCharacteristicOperationResponseRequest];
5457
- returnType: void;
5458
- };
5459
- /**
5460
- * Simulates the response from the descriptor with |descriptorId| for a
5461
- * descriptor operation of |type|. The |code| value follows the Error
5462
- * Codes from Bluetooth Core Specification Vol 3 Part F 3.4.1.1 Error Response.
5463
- * The |data| is expected to exist when simulating a successful read operation
5464
- * response.
5465
- */
5466
- 'BluetoothEmulation.simulateDescriptorOperationResponse': {
5467
- paramsType: [Protocol.BluetoothEmulation.SimulateDescriptorOperationResponseRequest];
5468
- returnType: void;
5469
- };
5470
- /**
5471
- * Adds a service with |serviceUuid| to the peripheral with |address|.
5472
- */
5473
- 'BluetoothEmulation.addService': {
5474
- paramsType: [Protocol.BluetoothEmulation.AddServiceRequest];
5475
- returnType: Protocol.BluetoothEmulation.AddServiceResponse;
5476
- };
5477
- /**
5478
- * Removes the service respresented by |serviceId| from the simulated central.
5479
- */
5480
- 'BluetoothEmulation.removeService': {
5481
- paramsType: [Protocol.BluetoothEmulation.RemoveServiceRequest];
5482
- returnType: void;
5483
- };
5484
- /**
5485
- * Adds a characteristic with |characteristicUuid| and |properties| to the
5486
- * service represented by |serviceId|.
5487
- */
5488
- 'BluetoothEmulation.addCharacteristic': {
5489
- paramsType: [Protocol.BluetoothEmulation.AddCharacteristicRequest];
5490
- returnType: Protocol.BluetoothEmulation.AddCharacteristicResponse;
5491
- };
5492
- /**
5493
- * Removes the characteristic respresented by |characteristicId| from the
5494
- * simulated central.
5495
- */
5496
- 'BluetoothEmulation.removeCharacteristic': {
5497
- paramsType: [Protocol.BluetoothEmulation.RemoveCharacteristicRequest];
5498
- returnType: void;
5499
- };
5500
- /**
5501
- * Adds a descriptor with |descriptorUuid| to the characteristic respresented
5502
- * by |characteristicId|.
5503
- */
5504
- 'BluetoothEmulation.addDescriptor': {
5505
- paramsType: [Protocol.BluetoothEmulation.AddDescriptorRequest];
5506
- returnType: Protocol.BluetoothEmulation.AddDescriptorResponse;
5507
- };
5508
- /**
5509
- * Removes the descriptor with |descriptorId| from the simulated central.
5510
- */
5511
- 'BluetoothEmulation.removeDescriptor': {
5512
- paramsType: [Protocol.BluetoothEmulation.RemoveDescriptorRequest];
5513
- returnType: void;
5514
- };
5515
- /**
5516
- * Simulates a GATT disconnection from the peripheral with |address|.
5517
- */
5518
- 'BluetoothEmulation.simulateGATTDisconnection': {
5519
- paramsType: [Protocol.BluetoothEmulation.SimulateGATTDisconnectionRequest];
5520
- returnType: void;
5521
- };
5522
5546
  }
5523
5547
  }
5524
5548