chrome-devtools-frontend 1.0.1021097 → 1.0.1021582

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 (600) hide show
  1. package/config/gni/devtools_grd_files.gni +15 -10
  2. package/front_end/.eslintrc.js +1 -0
  3. package/front_end/core/i18n/locales/en-US.json +118 -4
  4. package/front_end/core/i18n/locales/en-XL.json +118 -4
  5. package/front_end/models/bindings/DebuggerLanguagePlugins.ts +8 -0
  6. package/front_end/panels/application/components/FrameDetailsView.ts +3 -2
  7. package/front_end/panels/application/components/Prerender2.ts +188 -0
  8. package/front_end/panels/elements/CSSRuleValidator.ts +103 -13
  9. package/front_end/panels/elements/ElementsTreeElement.ts +3 -1
  10. package/front_end/panels/elements/StylePropertyTreeElement.ts +10 -8
  11. package/front_end/panels/elements/components/CSSHintDetailsView.ts +71 -0
  12. package/front_end/panels/elements/components/components.ts +2 -0
  13. package/front_end/panels/elements/components/cssHintDetailsView.css +36 -0
  14. package/front_end/panels/elements/stylesSectionTree.css +1 -1
  15. package/front_end/panels/network/components/RequestHeadersView.ts +2 -1
  16. package/front_end/services/puppeteer/PuppeteerConnection.ts +3 -5
  17. package/front_end/third_party/lit-html/directives.ts +1 -0
  18. package/front_end/third_party/lit-html/lit-html-tsconfig.json +1 -0
  19. package/front_end/third_party/puppeteer/package/README.md +136 -214
  20. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Accessibility.d.ts +6 -6
  21. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Accessibility.d.ts.map +1 -1
  22. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Accessibility.js +149 -85
  23. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Accessibility.js.map +1 -1
  24. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/AriaQueryHandler.d.ts.map +1 -1
  25. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/AriaQueryHandler.js +34 -10
  26. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/AriaQueryHandler.js.map +1 -1
  27. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Browser.d.ts +17 -36
  28. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Browser.d.ts.map +1 -1
  29. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Browser.js +217 -160
  30. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Browser.js.map +1 -1
  31. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/BrowserConnector.d.ts +5 -4
  32. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/BrowserConnector.d.ts.map +1 -1
  33. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/BrowserConnector.js +18 -13
  34. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/BrowserConnector.js.map +1 -1
  35. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/BrowserWebSocketTransport.d.ts +4 -1
  36. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/BrowserWebSocketTransport.d.ts.map +1 -1
  37. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/BrowserWebSocketTransport.js +30 -11
  38. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/BrowserWebSocketTransport.js.map +1 -1
  39. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Connection.d.ts +21 -20
  40. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Connection.d.ts.map +1 -1
  41. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Connection.js +125 -82
  42. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Connection.js.map +1 -1
  43. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ConsoleMessage.d.ts +1 -4
  44. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ConsoleMessage.d.ts.map +1 -1
  45. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ConsoleMessage.js +27 -9
  46. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ConsoleMessage.js.map +1 -1
  47. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Coverage.d.ts +6 -30
  48. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Coverage.d.ts.map +1 -1
  49. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Coverage.js +167 -131
  50. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Coverage.js.map +1 -1
  51. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/DOMWorld.d.ts +36 -67
  52. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/DOMWorld.d.ts.map +1 -1
  53. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/DOMWorld.js +359 -215
  54. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/DOMWorld.js.map +1 -1
  55. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Debug.d.ts +8 -4
  56. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Debug.d.ts.map +1 -1
  57. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Debug.js +9 -6
  58. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Debug.js.map +1 -1
  59. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/DeviceDescriptors.d.ts +21 -2
  60. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/DeviceDescriptors.d.ts.map +1 -1
  61. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/DeviceDescriptors.js +26 -6
  62. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/DeviceDescriptors.js.map +1 -1
  63. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Dialog.d.ts +2 -6
  64. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Dialog.d.ts.map +1 -1
  65. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Dialog.js +32 -15
  66. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Dialog.js.map +1 -1
  67. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ElementHandle.d.ts +355 -0
  68. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ElementHandle.d.ts.map +1 -0
  69. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ElementHandle.js +847 -0
  70. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ElementHandle.js.map +1 -0
  71. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/EmulationManager.d.ts +4 -3
  72. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/EmulationManager.d.ts.map +1 -1
  73. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/EmulationManager.js +25 -8
  74. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/EmulationManager.js.map +1 -1
  75. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Errors.d.ts +28 -6
  76. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Errors.d.ts.map +1 -1
  77. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Errors.js +27 -7
  78. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Errors.js.map +1 -1
  79. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/EventEmitter.d.ts.map +1 -1
  80. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/EventEmitter.js +1 -1
  81. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/EventEmitter.js.map +1 -1
  82. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ExecutionContext.d.ts +20 -19
  83. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ExecutionContext.d.ts.map +1 -1
  84. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ExecutionContext.js +146 -126
  85. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ExecutionContext.js.map +1 -1
  86. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/FileChooser.d.ts +4 -6
  87. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/FileChooser.d.ts.map +1 -1
  88. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/FileChooser.js +25 -10
  89. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/FileChooser.js.map +1 -1
  90. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/FrameManager.d.ts +53 -92
  91. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/FrameManager.d.ts.map +1 -1
  92. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/FrameManager.js +337 -320
  93. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/FrameManager.js.map +1 -1
  94. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/HTTPRequest.d.ts +16 -28
  95. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/HTTPRequest.d.ts.map +1 -1
  96. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/HTTPRequest.js +200 -147
  97. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/HTTPRequest.js.map +1 -1
  98. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/HTTPResponse.d.ts +1 -18
  99. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/HTTPResponse.d.ts.map +1 -1
  100. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/HTTPResponse.js +86 -60
  101. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/HTTPResponse.js.map +1 -1
  102. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Input.d.ts +18 -22
  103. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Input.d.ts.map +1 -1
  104. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Input.js +166 -117
  105. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Input.js.map +1 -1
  106. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/JSHandle.d.ts +46 -395
  107. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/JSHandle.d.ts.map +1 -1
  108. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/JSHandle.js +80 -842
  109. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/JSHandle.js.map +1 -1
  110. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/LifecycleWatcher.d.ts +4 -32
  111. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/LifecycleWatcher.d.ts.map +1 -1
  112. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/LifecycleWatcher.js +136 -108
  113. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/LifecycleWatcher.js.map +1 -1
  114. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkConditions.d.ts +25 -7
  115. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkConditions.d.ts.map +1 -1
  116. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkConditions.js +23 -2
  117. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkConditions.js.map +1 -1
  118. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkEventManager.d.ts +16 -11
  119. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkEventManager.d.ts.map +1 -1
  120. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkEventManager.js +39 -32
  121. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkEventManager.js.map +1 -1
  122. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkManager.d.ts +2 -42
  123. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkManager.d.ts.map +1 -1
  124. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkManager.js +315 -316
  125. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkManager.js.map +1 -1
  126. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/PDFOptions.d.ts +5 -3
  127. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/PDFOptions.d.ts.map +1 -1
  128. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/PDFOptions.js +2 -2
  129. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/PDFOptions.js.map +1 -1
  130. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Page.d.ts +246 -287
  131. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Page.d.ts.map +1 -1
  132. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Page.js +841 -700
  133. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Page.js.map +1 -1
  134. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Puppeteer.d.ts +37 -74
  135. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Puppeteer.d.ts.map +1 -1
  136. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Puppeteer.js +37 -89
  137. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Puppeteer.js.map +1 -1
  138. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/QueryHandler.d.ts +38 -13
  139. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/QueryHandler.d.ts.map +1 -1
  140. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/QueryHandler.js +79 -29
  141. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/QueryHandler.js.map +1 -1
  142. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/SecurityDetails.d.ts +1 -6
  143. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/SecurityDetails.d.ts.map +1 -1
  144. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/SecurityDetails.js +31 -12
  145. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/SecurityDetails.js.map +1 -1
  146. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Target.d.ts +6 -9
  147. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Target.d.ts.map +1 -1
  148. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Target.js +80 -40
  149. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Target.js.map +1 -1
  150. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/TaskQueue.d.ts +4 -1
  151. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/TaskQueue.d.ts.map +1 -1
  152. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/TaskQueue.js +24 -3
  153. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/TaskQueue.js.map +1 -1
  154. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/TimeoutSettings.d.ts +1 -2
  155. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/TimeoutSettings.d.ts.map +1 -1
  156. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/TimeoutSettings.js +28 -10
  157. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/TimeoutSettings.js.map +1 -1
  158. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Tracing.d.ts +4 -5
  159. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Tracing.d.ts.map +1 -1
  160. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Tracing.js +50 -23
  161. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Tracing.js.map +1 -1
  162. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/USKeyboardLayout.d.ts +1 -1
  163. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/USKeyboardLayout.d.ts.map +1 -1
  164. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/USKeyboardLayout.js +2 -2
  165. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/USKeyboardLayout.js.map +1 -1
  166. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/WebWorker.d.ts +9 -11
  167. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/WebWorker.d.ts.map +1 -1
  168. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/WebWorker.js +41 -31
  169. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/WebWorker.js.map +1 -1
  170. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/assert.d.ts +4 -3
  171. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/assert.d.ts.map +1 -1
  172. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/assert.js +6 -8
  173. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/assert.js.map +1 -1
  174. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/fetch.d.ts +5 -0
  175. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/fetch.d.ts.map +1 -1
  176. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/fetch.js +6 -3
  177. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/fetch.js.map +1 -1
  178. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/types.d.ts +48 -0
  179. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/types.d.ts.map +1 -0
  180. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/{EvalTypes.js → types.js} +1 -1
  181. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/types.js.map +1 -0
  182. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/util.d.ts +129 -0
  183. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/util.d.ts.map +1 -0
  184. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/{helper.js → util.js} +168 -87
  185. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/util.js.map +1 -0
  186. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/compat.d.ts +3 -0
  187. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/compat.d.ts.map +1 -1
  188. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/compat.js +3 -0
  189. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/compat.js.map +1 -1
  190. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/constants.d.ts +3 -0
  191. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/constants.d.ts.map +1 -1
  192. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/constants.js +3 -0
  193. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/constants.js.map +1 -1
  194. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/environment.d.ts +3 -0
  195. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/environment.d.ts.map +1 -1
  196. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/environment.js +3 -0
  197. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/environment.js.map +1 -1
  198. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/generated/version.d.ts +4 -1
  199. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/generated/version.d.ts.map +1 -1
  200. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/generated/version.js +4 -1
  201. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/generated/version.js.map +1 -1
  202. package/front_end/third_party/puppeteer/package/lib/{esm/puppeteer/initialize-node.d.ts → cjs/puppeteer/initializePuppeteer.d.ts} +5 -2
  203. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/initializePuppeteer.d.ts.map +1 -0
  204. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/{initialize-node.js → initializePuppeteer.js} +18 -14
  205. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/initializePuppeteer.js.map +1 -0
  206. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/BrowserFetcher.d.ts +4 -11
  207. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/BrowserFetcher.d.ts.map +1 -1
  208. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/BrowserFetcher.js +226 -158
  209. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/BrowserFetcher.js.map +1 -1
  210. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/BrowserRunner.d.ts +9 -11
  211. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/BrowserRunner.d.ts.map +1 -1
  212. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/BrowserRunner.js +116 -72
  213. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/BrowserRunner.js.map +1 -1
  214. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/ChromeLauncher.d.ts +27 -0
  215. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/ChromeLauncher.d.ts.map +1 -0
  216. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/ChromeLauncher.js +176 -0
  217. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/ChromeLauncher.js.map +1 -0
  218. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/FirefoxLauncher.d.ts +49 -0
  219. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/FirefoxLauncher.d.ts.map +1 -0
  220. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/FirefoxLauncher.js +361 -0
  221. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/FirefoxLauncher.js.map +1 -0
  222. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/LaunchOptions.d.ts.map +1 -1
  223. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/NodeWebSocketTransport.d.ts +6 -3
  224. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/NodeWebSocketTransport.d.ts.map +1 -1
  225. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/NodeWebSocketTransport.js +44 -12
  226. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/NodeWebSocketTransport.js.map +1 -1
  227. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/PipeTransport.d.ts +4 -20
  228. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/PipeTransport.d.ts.map +1 -1
  229. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/PipeTransport.js +60 -35
  230. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/PipeTransport.js.map +1 -1
  231. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/ProductLauncher.d.ts +31 -0
  232. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/ProductLauncher.d.ts.map +1 -0
  233. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/ProductLauncher.js +166 -0
  234. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/ProductLauncher.js.map +1 -0
  235. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/Puppeteer.d.ts +42 -41
  236. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/Puppeteer.d.ts.map +1 -1
  237. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/Puppeteer.js +69 -47
  238. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/Puppeteer.js.map +1 -1
  239. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/install.d.ts +6 -0
  240. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/install.d.ts.map +1 -1
  241. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/install.js +55 -32
  242. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/install.js.map +1 -1
  243. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/util.d.ts +10 -0
  244. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/util.d.ts.map +1 -0
  245. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/util.js +40 -0
  246. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/util.js.map +1 -0
  247. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/puppeteer-core.d.ts +23 -0
  248. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/puppeteer-core.d.ts.map +1 -0
  249. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/puppeteer-core.js +41 -0
  250. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/puppeteer-core.js.map +1 -0
  251. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/puppeteer.d.ts +26 -0
  252. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/puppeteer.d.ts.map +1 -0
  253. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/puppeteer.js +44 -0
  254. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/puppeteer.js.map +1 -0
  255. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/revisions.d.ts +6 -5
  256. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/revisions.d.ts.map +1 -1
  257. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/revisions.js +6 -3
  258. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/revisions.js.map +1 -1
  259. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/tsconfig.cjs.tsbuildinfo +1 -0
  260. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/tsconfig.tsbuildinfo +1 -0
  261. package/front_end/third_party/puppeteer/package/lib/{esm/puppeteer/api-docs-entry.js → cjs/puppeteer/types.d.ts} +46 -63
  262. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/types.d.ts.map +1 -0
  263. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/{api-docs-entry.js → types.js} +50 -51
  264. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/types.js.map +1 -0
  265. package/front_end/third_party/puppeteer/package/lib/cjs/vendor/mitt/src/index.d.ts +0 -1
  266. package/front_end/third_party/puppeteer/package/lib/cjs/vendor/mitt/src/index.js +11 -12
  267. package/front_end/third_party/puppeteer/package/lib/cjs/vendor/tsconfig.cjs.tsbuildinfo +1 -0
  268. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Accessibility.d.ts +6 -6
  269. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Accessibility.d.ts.map +1 -1
  270. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Accessibility.js +149 -85
  271. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Accessibility.js.map +1 -1
  272. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/AriaQueryHandler.d.ts.map +1 -1
  273. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/AriaQueryHandler.js +34 -10
  274. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/AriaQueryHandler.js.map +1 -1
  275. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Browser.d.ts +17 -36
  276. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Browser.d.ts.map +1 -1
  277. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Browser.js +217 -160
  278. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Browser.js.map +1 -1
  279. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/BrowserConnector.d.ts +5 -4
  280. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/BrowserConnector.d.ts.map +1 -1
  281. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/BrowserConnector.js +16 -11
  282. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/BrowserConnector.js.map +1 -1
  283. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/BrowserWebSocketTransport.d.ts +4 -1
  284. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/BrowserWebSocketTransport.d.ts.map +1 -1
  285. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/BrowserWebSocketTransport.js +30 -11
  286. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/BrowserWebSocketTransport.js.map +1 -1
  287. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Connection.d.ts +21 -20
  288. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Connection.d.ts.map +1 -1
  289. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Connection.js +125 -82
  290. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Connection.js.map +1 -1
  291. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ConsoleMessage.d.ts +1 -4
  292. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ConsoleMessage.d.ts.map +1 -1
  293. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ConsoleMessage.js +27 -9
  294. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ConsoleMessage.js.map +1 -1
  295. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Coverage.d.ts +6 -30
  296. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Coverage.d.ts.map +1 -1
  297. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Coverage.js +167 -131
  298. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Coverage.js.map +1 -1
  299. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/DOMWorld.d.ts +36 -67
  300. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/DOMWorld.d.ts.map +1 -1
  301. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/DOMWorld.js +335 -214
  302. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/DOMWorld.js.map +1 -1
  303. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Debug.d.ts +8 -4
  304. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Debug.d.ts.map +1 -1
  305. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Debug.js +9 -6
  306. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Debug.js.map +1 -1
  307. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/DeviceDescriptors.d.ts +21 -2
  308. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/DeviceDescriptors.d.ts.map +1 -1
  309. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/DeviceDescriptors.js +25 -5
  310. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/DeviceDescriptors.js.map +1 -1
  311. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Dialog.d.ts +2 -6
  312. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Dialog.d.ts.map +1 -1
  313. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Dialog.js +32 -15
  314. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Dialog.js.map +1 -1
  315. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ElementHandle.d.ts +355 -0
  316. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ElementHandle.d.ts.map +1 -0
  317. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ElementHandle.js +820 -0
  318. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ElementHandle.js.map +1 -0
  319. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EmulationManager.d.ts +4 -3
  320. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EmulationManager.d.ts.map +1 -1
  321. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EmulationManager.js +25 -8
  322. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EmulationManager.js.map +1 -1
  323. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Errors.d.ts +28 -6
  324. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Errors.d.ts.map +1 -1
  325. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Errors.js +26 -6
  326. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Errors.js.map +1 -1
  327. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EventEmitter.d.ts.map +1 -1
  328. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EventEmitter.js +1 -1
  329. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EventEmitter.js.map +1 -1
  330. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ExecutionContext.d.ts +20 -19
  331. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ExecutionContext.d.ts.map +1 -1
  332. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ExecutionContext.js +145 -125
  333. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ExecutionContext.js.map +1 -1
  334. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/FileChooser.d.ts +4 -6
  335. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/FileChooser.d.ts.map +1 -1
  336. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/FileChooser.js +25 -10
  337. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/FileChooser.js.map +1 -1
  338. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/FrameManager.d.ts +53 -92
  339. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/FrameManager.d.ts.map +1 -1
  340. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/FrameManager.js +337 -320
  341. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/FrameManager.js.map +1 -1
  342. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/HTTPRequest.d.ts +16 -28
  343. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/HTTPRequest.d.ts.map +1 -1
  344. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/HTTPRequest.js +199 -146
  345. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/HTTPRequest.js.map +1 -1
  346. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/HTTPResponse.d.ts +1 -18
  347. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/HTTPResponse.d.ts.map +1 -1
  348. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/HTTPResponse.js +86 -60
  349. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/HTTPResponse.js.map +1 -1
  350. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Input.d.ts +18 -22
  351. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Input.d.ts.map +1 -1
  352. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Input.js +167 -118
  353. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Input.js.map +1 -1
  354. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/JSHandle.d.ts +46 -395
  355. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/JSHandle.d.ts.map +1 -1
  356. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/JSHandle.js +80 -817
  357. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/JSHandle.js.map +1 -1
  358. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/LifecycleWatcher.d.ts +4 -32
  359. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/LifecycleWatcher.d.ts.map +1 -1
  360. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/LifecycleWatcher.js +135 -107
  361. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/LifecycleWatcher.js.map +1 -1
  362. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkConditions.d.ts +25 -7
  363. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkConditions.d.ts.map +1 -1
  364. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkConditions.js +23 -2
  365. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkConditions.js.map +1 -1
  366. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkEventManager.d.ts +16 -11
  367. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkEventManager.d.ts.map +1 -1
  368. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkEventManager.js +39 -32
  369. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkEventManager.js.map +1 -1
  370. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkManager.d.ts +2 -42
  371. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkManager.d.ts.map +1 -1
  372. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkManager.js +312 -313
  373. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkManager.js.map +1 -1
  374. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/PDFOptions.d.ts +5 -3
  375. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/PDFOptions.d.ts.map +1 -1
  376. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/PDFOptions.js +1 -1
  377. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/PDFOptions.js.map +1 -1
  378. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Page.d.ts +246 -287
  379. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Page.d.ts.map +1 -1
  380. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Page.js +819 -701
  381. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Page.js.map +1 -1
  382. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Puppeteer.d.ts +37 -74
  383. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Puppeteer.d.ts.map +1 -1
  384. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Puppeteer.js +39 -91
  385. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Puppeteer.js.map +1 -1
  386. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/QueryHandler.d.ts +38 -13
  387. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/QueryHandler.d.ts.map +1 -1
  388. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/QueryHandler.js +79 -29
  389. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/QueryHandler.js.map +1 -1
  390. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/SecurityDetails.d.ts +1 -6
  391. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/SecurityDetails.d.ts.map +1 -1
  392. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/SecurityDetails.js +31 -12
  393. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/SecurityDetails.js.map +1 -1
  394. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Target.d.ts +6 -9
  395. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Target.d.ts.map +1 -1
  396. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Target.js +80 -40
  397. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Target.js.map +1 -1
  398. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/TaskQueue.d.ts +4 -1
  399. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/TaskQueue.d.ts.map +1 -1
  400. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/TaskQueue.js +24 -3
  401. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/TaskQueue.js.map +1 -1
  402. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/TimeoutSettings.d.ts +1 -2
  403. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/TimeoutSettings.d.ts.map +1 -1
  404. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/TimeoutSettings.js +28 -10
  405. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/TimeoutSettings.js.map +1 -1
  406. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Tracing.d.ts +4 -5
  407. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Tracing.d.ts.map +1 -1
  408. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Tracing.js +50 -23
  409. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Tracing.js.map +1 -1
  410. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/USKeyboardLayout.d.ts +1 -1
  411. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/USKeyboardLayout.d.ts.map +1 -1
  412. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/USKeyboardLayout.js +1 -1
  413. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/USKeyboardLayout.js.map +1 -1
  414. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/WebWorker.d.ts +9 -11
  415. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/WebWorker.d.ts.map +1 -1
  416. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/WebWorker.js +41 -31
  417. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/WebWorker.js.map +1 -1
  418. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/assert.d.ts +4 -3
  419. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/assert.d.ts.map +1 -1
  420. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/assert.js +5 -6
  421. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/assert.js.map +1 -1
  422. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/fetch.d.ts +5 -0
  423. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/fetch.d.ts.map +1 -1
  424. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/fetch.js +6 -3
  425. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/fetch.js.map +1 -1
  426. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/types.d.ts +48 -0
  427. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/types.d.ts.map +1 -0
  428. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/{EvalTypes.js → types.js} +1 -1
  429. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/types.js.map +1 -0
  430. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/util.d.ts +129 -0
  431. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/util.d.ts.map +1 -0
  432. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/{helper.js → util.js} +161 -100
  433. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/util.js.map +1 -0
  434. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/compat.d.ts +3 -0
  435. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/compat.d.ts.map +1 -1
  436. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/compat.js +3 -0
  437. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/compat.js.map +1 -1
  438. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/constants.d.ts +3 -0
  439. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/constants.d.ts.map +1 -1
  440. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/constants.js +3 -0
  441. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/constants.js.map +1 -1
  442. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/environment.d.ts +3 -0
  443. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/environment.d.ts.map +1 -1
  444. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/environment.js +3 -0
  445. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/environment.js.map +1 -1
  446. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/generated/version.d.ts +4 -1
  447. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/generated/version.d.ts.map +1 -1
  448. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/generated/version.js +4 -1
  449. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/generated/version.js.map +1 -1
  450. package/front_end/third_party/puppeteer/package/lib/{cjs/puppeteer/initialize-node.d.ts → esm/puppeteer/initializePuppeteer.d.ts} +5 -2
  451. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/initializePuppeteer.d.ts.map +1 -0
  452. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/{initialize-node.js → initializePuppeteer.js} +16 -12
  453. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/initializePuppeteer.js.map +1 -0
  454. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/BrowserFetcher.d.ts +4 -11
  455. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/BrowserFetcher.d.ts.map +1 -1
  456. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/BrowserFetcher.js +226 -158
  457. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/BrowserFetcher.js.map +1 -1
  458. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/BrowserRunner.d.ts +9 -11
  459. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/BrowserRunner.d.ts.map +1 -1
  460. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/BrowserRunner.js +113 -69
  461. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/BrowserRunner.js.map +1 -1
  462. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/ChromeLauncher.d.ts +27 -0
  463. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/ChromeLauncher.d.ts.map +1 -0
  464. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/ChromeLauncher.js +169 -0
  465. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/ChromeLauncher.js.map +1 -0
  466. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/FirefoxLauncher.d.ts +49 -0
  467. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/FirefoxLauncher.d.ts.map +1 -0
  468. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/{Launcher.js → FirefoxLauncher.js} +51 -345
  469. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/FirefoxLauncher.js.map +1 -0
  470. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/LaunchOptions.d.ts.map +1 -1
  471. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/NodeWebSocketTransport.d.ts +6 -3
  472. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/NodeWebSocketTransport.d.ts.map +1 -1
  473. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/NodeWebSocketTransport.js +44 -12
  474. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/NodeWebSocketTransport.js.map +1 -1
  475. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/PipeTransport.d.ts +4 -20
  476. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/PipeTransport.d.ts.map +1 -1
  477. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/PipeTransport.js +60 -35
  478. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/PipeTransport.js.map +1 -1
  479. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/ProductLauncher.d.ts +31 -0
  480. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/ProductLauncher.d.ts.map +1 -0
  481. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/ProductLauncher.js +157 -0
  482. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/ProductLauncher.js.map +1 -0
  483. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/Puppeteer.d.ts +42 -41
  484. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/Puppeteer.d.ts.map +1 -1
  485. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/Puppeteer.js +70 -45
  486. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/Puppeteer.js.map +1 -1
  487. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/install.d.ts +6 -0
  488. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/install.d.ts.map +1 -1
  489. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/install.js +53 -30
  490. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/install.js.map +1 -1
  491. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/util.d.ts +10 -0
  492. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/util.d.ts.map +1 -0
  493. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/util.js +13 -0
  494. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/util.js.map +1 -0
  495. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/puppeteer-core.d.ts +23 -0
  496. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/puppeteer-core.d.ts.map +1 -0
  497. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/{node-puppeteer-core.d.ts → puppeteer-core.js} +8 -2
  498. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/puppeteer-core.js.map +1 -0
  499. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/puppeteer.d.ts +26 -0
  500. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/puppeteer.d.ts.map +1 -0
  501. package/front_end/third_party/puppeteer/package/lib/{cjs/puppeteer/node-puppeteer-core.d.ts → esm/puppeteer/puppeteer.js} +11 -2
  502. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/puppeteer.js.map +1 -0
  503. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/revisions.d.ts +6 -5
  504. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/revisions.d.ts.map +1 -1
  505. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/revisions.js +6 -3
  506. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/revisions.js.map +1 -1
  507. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/tsconfig.esm.tsbuildinfo +1 -0
  508. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/tsconfig.tsbuildinfo +1 -0
  509. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/types.d.ts +64 -0
  510. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/types.d.ts.map +1 -0
  511. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/types.js +68 -0
  512. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/types.js.map +1 -0
  513. package/front_end/third_party/puppeteer/package/lib/esm/vendor/mitt/src/index.d.ts +0 -1
  514. package/front_end/third_party/puppeteer/package/lib/esm/vendor/mitt/src/index.js +9 -10
  515. package/front_end/third_party/puppeteer/package/lib/esm/vendor/tsconfig.esm.tsbuildinfo +1 -0
  516. package/front_end/third_party/puppeteer/package/lib/types.d.ts +846 -1670
  517. package/front_end/third_party/puppeteer/package/package.json +65 -68
  518. package/front_end/third_party/puppeteer/package/typescript-if-required.js +17 -8
  519. package/front_end/third_party/puppeteer/puppeteer.ts +7 -14
  520. package/front_end/ui/components/linear_memory_inspector/LinearMemoryInspector.ts +2 -5
  521. package/front_end/ui/components/linear_memory_inspector/LinearMemoryInspectorController.ts +22 -2
  522. package/front_end/ui/components/linear_memory_inspector/LinearMemoryInspectorPane.ts +40 -12
  523. package/front_end/ui/components/linear_memory_inspector/LinearMemoryViewer.ts +5 -5
  524. package/front_end/ui/legacy/components/utils/Linkifier.ts +3 -1
  525. package/package.json +1 -1
  526. package/scripts/eslint_rules/lib/inject_checkbox_styles.js +4 -2
  527. package/scripts/eslint_rules/tests/inject_checkbox_styles_test.js +45 -5
  528. package/front_end/third_party/puppeteer/package/cjs-entry-core.js +0 -29
  529. package/front_end/third_party/puppeteer/package/cjs-entry.js +0 -29
  530. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/api-docs-entry.d.ts +0 -111
  531. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/api-docs-entry.d.ts.map +0 -1
  532. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/api-docs-entry.js.map +0 -1
  533. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/EvalTypes.d.ts +0 -61
  534. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/EvalTypes.d.ts.map +0 -1
  535. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/EvalTypes.js.map +0 -1
  536. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Events.d.ts +0 -82
  537. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Events.d.ts.map +0 -1
  538. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Events.js +0 -87
  539. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Events.js.map +0 -1
  540. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/helper.d.ts +0 -85
  541. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/helper.d.ts.map +0 -1
  542. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/helper.js.map +0 -1
  543. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/initialize-node.d.ts.map +0 -1
  544. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/initialize-node.js.map +0 -1
  545. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/initialize-web.d.ts +0 -18
  546. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/initialize-web.d.ts.map +0 -1
  547. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/initialize-web.js +0 -27
  548. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/initialize-web.js.map +0 -1
  549. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/Launcher.d.ts +0 -18
  550. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/Launcher.d.ts.map +0 -1
  551. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/Launcher.js +0 -674
  552. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/Launcher.js.map +0 -1
  553. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node-puppeteer-core.d.ts.map +0 -1
  554. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node-puppeteer-core.js +0 -25
  555. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node-puppeteer-core.js.map +0 -1
  556. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node.d.ts +0 -18
  557. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node.d.ts.map +0 -1
  558. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node.js +0 -24
  559. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node.js.map +0 -1
  560. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/web.d.ts +0 -18
  561. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/web.d.ts.map +0 -1
  562. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/web.js +0 -24
  563. package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/web.js.map +0 -1
  564. package/front_end/third_party/puppeteer/package/lib/cjs/vendor/mitt/src/index.d.ts.map +0 -1
  565. package/front_end/third_party/puppeteer/package/lib/cjs/vendor/mitt/src/index.js.map +0 -1
  566. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/api-docs-entry.d.ts +0 -111
  567. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/api-docs-entry.d.ts.map +0 -1
  568. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/api-docs-entry.js.map +0 -1
  569. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EvalTypes.d.ts +0 -61
  570. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EvalTypes.d.ts.map +0 -1
  571. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EvalTypes.js.map +0 -1
  572. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Events.d.ts +0 -82
  573. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Events.d.ts.map +0 -1
  574. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Events.js +0 -84
  575. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Events.js.map +0 -1
  576. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/helper.d.ts +0 -85
  577. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/helper.d.ts.map +0 -1
  578. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/helper.js.map +0 -1
  579. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/initialize-node.d.ts.map +0 -1
  580. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/initialize-node.js.map +0 -1
  581. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/initialize-web.d.ts +0 -18
  582. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/initialize-web.d.ts.map +0 -1
  583. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/initialize-web.js +0 -23
  584. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/initialize-web.js.map +0 -1
  585. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/Launcher.d.ts +0 -18
  586. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/Launcher.d.ts.map +0 -1
  587. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/Launcher.js.map +0 -1
  588. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node-puppeteer-core.d.ts.map +0 -1
  589. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node-puppeteer-core.js +0 -23
  590. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node-puppeteer-core.js.map +0 -1
  591. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node.d.ts +0 -18
  592. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node.d.ts.map +0 -1
  593. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node.js +0 -22
  594. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node.js.map +0 -1
  595. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/web.d.ts +0 -18
  596. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/web.d.ts.map +0 -1
  597. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/web.js +0 -22
  598. package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/web.js.map +0 -1
  599. package/front_end/third_party/puppeteer/package/lib/esm/vendor/mitt/src/index.d.ts.map +0 -1
  600. package/front_end/third_party/puppeteer/package/lib/esm/vendor/mitt/src/index.js.map +0 -1
@@ -5,6 +5,8 @@ import { Protocol } from 'devtools-protocol';
5
5
  import { ProtocolMapping } from 'devtools-protocol/types/protocol-mapping.js';
6
6
  import type { Readable } from 'stream';
7
7
 
8
+ declare const __JSHandleSymbol: unique symbol;
9
+
8
10
  /**
9
11
  * The Accessibility class provides methods for inspecting Chromium's
10
12
  * accessibility tree. The accessibility tree is used by assistive technology
@@ -28,11 +30,8 @@ import type { Readable } from 'stream';
28
30
  * @public
29
31
  */
30
32
  export declare class Accessibility {
31
- private _client;
32
- /**
33
- * @internal
34
- */
35
- constructor(client: CDPSession);
33
+ #private;
34
+ /* Excluded from this release type: __constructor */
36
35
  /**
37
36
  * Captures the current state of the accessibility tree.
38
37
  * The returned object represents the root accessible node of the page.
@@ -46,14 +45,14 @@ export declare class Accessibility {
46
45
  *
47
46
  * @example
48
47
  * An example of dumping the entire accessibility tree:
49
- * ```js
48
+ * ```ts
50
49
  * const snapshot = await page.accessibility.snapshot();
51
50
  * console.log(snapshot);
52
51
  * ```
53
52
  *
54
53
  * @example
55
54
  * An example of logging the focused node's name:
56
- * ```js
55
+ * ```ts
57
56
  * const snapshot = await page.accessibility.snapshot();
58
57
  * const node = findFocusedNode(snapshot);
59
58
  * console.log(node && node.name);
@@ -72,7 +71,7 @@ export declare class Accessibility {
72
71
  * @returns An AXNode object representing the snapshot.
73
72
  *
74
73
  */
75
- snapshot(options?: SnapshotOptions): Promise<SerializedAXNode>;
74
+ snapshot(options?: SnapshotOptions): Promise<SerializedAXNode | null>;
76
75
  private serializeTree;
77
76
  private collectInterestingNodes;
78
77
  }
@@ -82,18 +81,21 @@ export declare class Accessibility {
82
81
  */
83
82
  export declare type ActionResult = 'continue' | 'abort' | 'respond';
84
83
 
84
+ /* Excluded from this release type: addEventListener_2 */
85
+
86
+ /* Excluded from this release type: ariaHandler */
87
+
88
+ /* Excluded from this release type: assert */
89
+
85
90
  /**
86
91
  * @public
87
92
  */
88
- export declare interface BoundingBox {
89
- /**
90
- * the x coordinate of the element in pixels.
91
- */
92
- x: number;
93
- /**
94
- * the y coordinate of the element in pixels.
95
- */
96
- y: number;
93
+ export declare type Awaitable<T> = T | PromiseLike<T>;
94
+
95
+ /**
96
+ * @public
97
+ */
98
+ export declare interface BoundingBox extends Point {
97
99
  /**
98
100
  * the width of the element in pixels.
99
101
  */
@@ -108,22 +110,10 @@ export declare interface BoundingBox {
108
110
  * @public
109
111
  */
110
112
  export declare interface BoxModel {
111
- content: Array<{
112
- x: number;
113
- y: number;
114
- }>;
115
- padding: Array<{
116
- x: number;
117
- y: number;
118
- }>;
119
- border: Array<{
120
- x: number;
121
- y: number;
122
- }>;
123
- margin: Array<{
124
- x: number;
125
- y: number;
126
- }>;
113
+ content: Point[];
114
+ padding: Point[];
115
+ border: Point[];
116
+ margin: Point[];
127
117
  width: number;
128
118
  height: number;
129
119
  }
@@ -140,7 +130,7 @@ export declare interface BoxModel {
140
130
  * @example
141
131
  *
142
132
  * An example of using a {@link Browser} to create a {@link Page}:
143
- * ```js
133
+ * ```ts
144
134
  * const puppeteer = require('puppeteer');
145
135
  *
146
136
  * (async () => {
@@ -154,7 +144,7 @@ export declare interface BoxModel {
154
144
  * @example
155
145
  *
156
146
  * An example of disconnecting from and reconnecting to a {@link Browser}:
157
- * ```js
147
+ * ```ts
158
148
  * const puppeteer = require('puppeteer');
159
149
  *
160
150
  * (async () => {
@@ -174,45 +164,22 @@ export declare interface BoxModel {
174
164
  * @public
175
165
  */
176
166
  export declare class Browser extends EventEmitter {
177
- /**
178
- * @internal
179
- */
180
- static create(connection: Connection, contextIds: string[], ignoreHTTPSErrors: boolean, defaultViewport?: Viewport | null, process?: ChildProcess, closeCallback?: BrowserCloseCallback, targetFilterCallback?: TargetFilterCallback, isPageTargetCallback?: IsPageTargetCallback): Promise<Browser>;
181
- private _ignoreHTTPSErrors;
182
- private _defaultViewport?;
183
- private _process?;
184
- private _connection;
185
- private _closeCallback;
186
- private _targetFilterCallback;
187
- private _isPageTargetCallback;
188
- private _defaultContext;
189
- private _contexts;
190
- private _screenshotTaskQueue;
191
- private _ignoredTargets;
192
- /**
193
- * @internal
194
- * Used in Target.ts directly so cannot be marked private.
195
- */
196
- _targets: Map<string, Target>;
197
- /**
198
- * @internal
199
- */
200
- constructor(connection: Connection, contextIds: string[], ignoreHTTPSErrors: boolean, defaultViewport?: Viewport | null, process?: ChildProcess, closeCallback?: BrowserCloseCallback, targetFilterCallback?: TargetFilterCallback, isPageTargetCallback?: IsPageTargetCallback);
167
+ #private;
168
+ /* Excluded from this release type: _create */
169
+ /* Excluded from this release type: _targets */
170
+ /* Excluded from this release type: __constructor */
201
171
  /**
202
172
  * The spawned browser process. Returns `null` if the browser instance was created with
203
173
  * {@link Puppeteer.connect}.
204
174
  */
205
175
  process(): ChildProcess | null;
206
- /**
207
- * @internal
208
- */
209
- _setIsPageTargetCallback(isPageTargetCallback?: IsPageTargetCallback): void;
176
+ /* Excluded from this release type: _getIsPageTargetCallback */
210
177
  /**
211
178
  * Creates a new incognito browser context. This won't share cookies/cache with other
212
179
  * browser contexts.
213
180
  *
214
181
  * @example
215
- * ```js
182
+ * ```ts
216
183
  * (async () => {
217
184
  * const browser = await puppeteer.launch();
218
185
  * // Create a new incognito browser context.
@@ -234,14 +201,7 @@ export declare class Browser extends EventEmitter {
234
201
  * Returns the default browser context. The default browser context cannot be closed.
235
202
  */
236
203
  defaultBrowserContext(): BrowserContext;
237
- /**
238
- * @internal
239
- * Used by BrowserContext directly so cannot be marked private.
240
- */
241
- _disposeContext(contextId?: string): Promise<void>;
242
- private _targetCreated;
243
- private _targetDestroyed;
244
- private _targetInfoChanged;
204
+ /* Excluded from this release type: _disposeContext */
245
205
  /**
246
206
  * The browser websocket endpoint which can be used as an argument to
247
207
  * {@link Puppeteer.connect}.
@@ -265,11 +225,7 @@ export declare class Browser extends EventEmitter {
265
225
  * a default browser context.
266
226
  */
267
227
  newPage(): Promise<Page>;
268
- /**
269
- * @internal
270
- * Used by BrowserContext directly so cannot be marked private.
271
- */
272
- _createPageInContext(contextId?: string): Promise<Page>;
228
+ /* Excluded from this release type: _createPageInContext */
273
229
  /**
274
230
  * All active targets inside the Browser. In case of multiple browser contexts, returns
275
231
  * an array with all the targets in all browser contexts.
@@ -288,7 +244,7 @@ export declare class Browser extends EventEmitter {
288
244
  * @example
289
245
  *
290
246
  * An example of finding a target for a page opened via `window.open`:
291
- * ```js
247
+ * ```ts
292
248
  * await page.evaluate(() => window.open('https://www.example.com/'));
293
249
  * const newWindowTarget = await browser.waitForTarget(target => target.url() === 'https://www.example.com/');
294
250
  * ```
@@ -335,13 +291,9 @@ export declare class Browser extends EventEmitter {
335
291
  * Indicates that the browser is connected.
336
292
  */
337
293
  isConnected(): boolean;
338
- private _getVersion;
339
294
  }
340
295
 
341
- /**
342
- * @internal
343
- */
344
- export declare type BrowserCloseCallback = () => Promise<void> | void;
296
+ /* Excluded from this release type: BrowserCloseCallback */
345
297
 
346
298
  /**
347
299
  * Generic browser options that can be passed when launching any browser or when
@@ -367,10 +319,7 @@ export declare interface BrowserConnectOptions {
367
319
  * Callback to decide if Puppeteer should connect to a given target or not.
368
320
  */
369
321
  targetFilter?: TargetFilterCallback;
370
- /**
371
- * @internal
372
- */
373
- isPageTarget?: IsPageTargetCallback;
322
+ /* Excluded from this release type: _isPageTarget */
374
323
  }
375
324
 
376
325
  /**
@@ -393,7 +342,7 @@ export declare interface BrowserConnectOptions {
393
342
  * method. "Incognito" browser contexts don't write any browsing data to disk.
394
343
  *
395
344
  * @example
396
- * ```js
345
+ * ```ts
397
346
  * // Create a new incognito browser context
398
347
  * const context = await browser.createIncognitoBrowserContext();
399
348
  * // Create a new page inside context.
@@ -406,13 +355,8 @@ export declare interface BrowserConnectOptions {
406
355
  * @public
407
356
  */
408
357
  export declare class BrowserContext extends EventEmitter {
409
- private _connection;
410
- private _browser;
411
- private _id?;
412
- /**
413
- * @internal
414
- */
415
- constructor(connection: Connection, browser: Browser, contextId?: string);
358
+ #private;
359
+ /* Excluded from this release type: __constructor */
416
360
  /**
417
361
  * An array of all active targets inside the browser context.
418
362
  */
@@ -422,7 +366,7 @@ export declare class BrowserContext extends EventEmitter {
422
366
  *
423
367
  * @example
424
368
  * An example of finding a target for a page opened via `window.open`:
425
- * ```js
369
+ * ```ts
426
370
  * await page.evaluate(() => window.open('https://www.example.com/'));
427
371
  * const newWindowTarget = await browserContext.waitForTarget(target => target.url() === 'https://www.example.com/');
428
372
  * ```
@@ -455,7 +399,7 @@ export declare class BrowserContext extends EventEmitter {
455
399
  isIncognito(): boolean;
456
400
  /**
457
401
  * @example
458
- * ```js
402
+ * ```ts
459
403
  * const context = browser.defaultBrowserContext();
460
404
  * await context.overridePermissions('https://html5demos.com', ['geolocation']);
461
405
  * ```
@@ -469,7 +413,7 @@ export declare class BrowserContext extends EventEmitter {
469
413
  * Clears all permission overrides for the browser context.
470
414
  *
471
415
  * @example
472
- * ```js
416
+ * ```ts
473
417
  * const context = browser.defaultBrowserContext();
474
418
  * context.overridePermissions('https://example.com', ['clipboard-read']);
475
419
  * // do stuff ..
@@ -595,7 +539,7 @@ export declare const enum BrowserEmittedEvents {
595
539
  * An example of using BrowserFetcher to download a specific version of Chromium
596
540
  * and running Puppeteer against it:
597
541
  *
598
- * ```js
542
+ * ```ts
599
543
  * const browserFetcher = puppeteer.createBrowserFetcher();
600
544
  * const revisionInfo = await browserFetcher.download('533271');
601
545
  * const browser = await puppeteer.launch({executablePath: revisionInfo.executablePath})
@@ -607,15 +551,8 @@ export declare const enum BrowserEmittedEvents {
607
551
  * @public
608
552
  */
609
553
  export declare class BrowserFetcher {
610
- private _product;
611
- private _downloadsFolder;
612
- private _downloadHost;
613
- private _platform;
614
- /**
615
- * @internal
616
- */
617
- constructor(projectRoot: string, options?: BrowserFetcherOptions);
618
- private setPlatform;
554
+ #private;
555
+ /* Excluded from this release type: __constructor */
619
556
  /**
620
557
  * @returns Returns the current `Platform`, which is one of `mac`, `linux`,
621
558
  * `win32` or `win64`.
@@ -649,7 +586,7 @@ export declare class BrowserFetcher {
649
586
  * @returns A promise with revision information when the revision is downloaded
650
587
  * and extracted.
651
588
  */
652
- download(revision: string, progressCallback?: (x: number, y: number) => void): Promise<BrowserFetcherRevisionInfo>;
589
+ download(revision: string, progressCallback?: (x: number, y: number) => void): Promise<BrowserFetcherRevisionInfo | undefined>;
653
590
  /**
654
591
  * @remarks
655
592
  * This method is affected by the current `product`.
@@ -670,10 +607,6 @@ export declare class BrowserFetcher {
670
607
  * @returns The revision info for the given revision.
671
608
  */
672
609
  revisionInfo(revision: string): BrowserFetcherRevisionInfo;
673
- /**
674
- * @internal
675
- */
676
- _getFolderPath(revision: string): string;
677
610
  }
678
611
 
679
612
  /**
@@ -731,6 +664,10 @@ export declare interface BrowserLaunchArgumentOptions {
731
664
  args?: string[];
732
665
  }
733
666
 
667
+ /* Excluded from this release type: BrowserRunner */
668
+
669
+ /* Excluded from this release type: BrowserWebSocketTransport */
670
+
734
671
  /**
735
672
  * The `CDPSession` instances are used to talk raw Chrome Devtools Protocol.
736
673
  *
@@ -743,7 +680,7 @@ export declare interface BrowserLaunchArgumentOptions {
743
680
  * and {@link https://github.com/aslushnikov/getting-started-with-cdp/blob/HEAD/README.md | Getting Started with DevTools Protocol}.
744
681
  *
745
682
  * @example
746
- * ```js
683
+ * ```ts
747
684
  * const client = await page.target().createCDPSession();
748
685
  * await client.send('Animation.enable');
749
686
  * client.on('Animation.animationCreated', () => console.log('Animation created!'));
@@ -757,34 +694,19 @@ export declare interface BrowserLaunchArgumentOptions {
757
694
  * @public
758
695
  */
759
696
  export declare class CDPSession extends EventEmitter {
760
- /**
761
- * @internal
762
- */
763
- _connection?: Connection;
764
- private _sessionId;
765
- private _targetType;
766
- private _callbacks;
767
- /**
768
- * @internal
769
- */
770
- constructor(connection: Connection, targetType: string, sessionId: string);
697
+ #private;
698
+ /* Excluded from this release type: __constructor */
771
699
  connection(): Connection | undefined;
772
700
  send<T extends keyof ProtocolMapping.Commands>(method: T, ...paramArgs: ProtocolMapping.Commands[T]['paramsType']): Promise<ProtocolMapping.Commands[T]['returnType']>;
773
- /**
774
- * @internal
775
- */
776
- _onMessage(object: CDPSessionOnMessageObject): void;
701
+ /* Excluded from this release type: _onMessage */
777
702
  /**
778
703
  * Detaches the cdpSession from the target. Once detached, the cdpSession object
779
704
  * won't emit any events and can't be used to send messages.
780
705
  */
781
706
  detach(): Promise<void>;
707
+ /* Excluded from this release type: _onClosed */
782
708
  /**
783
- * @internal
784
- */
785
- _onClosed(): void;
786
- /**
787
- * @internal
709
+ * Returns the session's id.
788
710
  */
789
711
  id(): string;
790
712
  }
@@ -801,14 +723,7 @@ declare interface CDPSession_4 extends EventEmitter {
801
723
  send<T extends keyof ProtocolMapping.Commands>(method: T, ...paramArgs: ProtocolMapping.Commands[T]['paramsType']): Promise<ProtocolMapping.Commands[T]['returnType']>;
802
724
  }
803
725
 
804
- /**
805
- * Internal events that the CDPSession class emits.
806
- *
807
- * @internal
808
- */
809
- export declare const CDPSessionEmittedEvents: {
810
- readonly Disconnected: symbol;
811
- };
726
+ /* Excluded from this release type: CDPSessionEmittedEvents */
812
727
 
813
728
  /**
814
729
  * @public
@@ -825,14 +740,17 @@ export declare interface CDPSessionOnMessageObject {
825
740
  result?: any;
826
741
  }
827
742
 
743
+ /* Excluded from this release type: ChromeLauncher */
744
+
828
745
  /**
829
746
  * @public
830
747
  */
831
748
  export declare type ChromeReleaseChannel = 'chrome' | 'chrome-beta' | 'chrome-canary' | 'chrome-dev';
832
749
 
833
750
  /**
751
+ * Clears all registered handlers.
752
+ *
834
753
  * @public
835
- * {@inheritDoc Puppeteer.clearCustomQueryHandlers}
836
754
  */
837
755
  export declare function clearCustomQueryHandlers(): void;
838
756
 
@@ -874,33 +792,19 @@ export declare interface CommonEventEmitter {
874
792
  removeAllListeners(event?: EventType): CommonEventEmitter;
875
793
  }
876
794
 
877
- /**
878
- * Settings that are common to the Puppeteer class, regardless of environment.
879
- * @internal
880
- */
881
- export declare interface CommonPuppeteerSettings {
882
- isPuppeteerCore: boolean;
883
- }
795
+ /* Excluded from this release type: CommonPuppeteerSettings */
884
796
 
885
- /**
886
- * @public
887
- * {@inheritDoc PuppeteerNode.connect}
888
- */
889
- export declare function connect(options: ConnectOptions): Promise<Browser>;
797
+ export declare const connect: (options: ConnectOptions) => Promise<Browser>;
890
798
 
891
799
  /**
892
800
  * @public
893
801
  */
894
802
  export declare class Connection extends EventEmitter {
895
- _url: string;
896
- _transport: ConnectionTransport;
897
- _delay: number;
898
- _lastId: number;
899
- _sessions: Map<string, CDPSession>;
900
- _closed: boolean;
901
- _callbacks: Map<number, ConnectionCallback>;
803
+ #private;
902
804
  constructor(url: string, transport: ConnectionTransport, delay?: number);
903
805
  static fromSession(session: CDPSession): Connection | undefined;
806
+ /* Excluded from this release type: _closed */
807
+ /* Excluded from this release type: _sessions */
904
808
  /**
905
809
  * @param sessionId - The session id
906
810
  * @returns The current CDP session if it exists
@@ -908,9 +812,8 @@ export declare class Connection extends EventEmitter {
908
812
  session(sessionId: string): CDPSession | null;
909
813
  url(): string;
910
814
  send<T extends keyof ProtocolMapping.Commands>(method: T, ...paramArgs: ProtocolMapping.Commands[T]['paramsType']): Promise<ProtocolMapping.Commands[T]['returnType']>;
911
- _rawSend(message: Record<string, unknown>): number;
912
- _onMessage(message: string): Promise<void>;
913
- _onClose(): void;
815
+ /* Excluded from this release type: _rawSend */
816
+ /* Excluded from this release type: onMessage */
914
817
  dispose(): void;
915
818
  /**
916
819
  * @param targetInfo - The target info
@@ -923,20 +826,13 @@ export declare class Connection extends EventEmitter {
923
826
  * @public
924
827
  */
925
828
  export declare interface ConnectionCallback {
926
- resolve: Function;
927
- reject: Function;
829
+ resolve(args: unknown): void;
830
+ reject(args: unknown): void;
928
831
  error: ProtocolError;
929
832
  method: string;
930
833
  }
931
834
 
932
- /**
933
- * Internal events that the Connection class emits.
934
- *
935
- * @internal
936
- */
937
- export declare const ConnectionEmittedEvents: {
938
- readonly Disconnected: symbol;
939
- };
835
+ /* Excluded from this release type: ConnectionEmittedEvents */
940
836
 
941
837
  /**
942
838
  * Copyright 2020 Google Inc. All rights reserved.
@@ -973,31 +869,16 @@ export declare interface ConnectOptions extends BrowserConnectOptions {
973
869
  product?: Product;
974
870
  }
975
871
 
976
- /**
977
- * Users should never call this directly; it's called when calling
978
- * `puppeteer.connect`.
979
- * @internal
980
- */
981
- export declare const connectToBrowser: (options: BrowserConnectOptions & {
982
- browserWSEndpoint?: string;
983
- browserURL?: string;
984
- transport?: ConnectionTransport;
985
- }) => Promise<Browser>;
872
+ /* Excluded from this release type: _connectToBrowser */
986
873
 
987
- /**
988
- * @internal
989
- */
990
- export declare type ConsoleAPICalledCallback = (eventType: string, handles: JSHandle[], trace: Protocol.Runtime.StackTrace) => void;
874
+ /* Excluded from this release type: ConsoleAPICalledCallback */
991
875
 
992
876
  /**
993
877
  * ConsoleMessage objects are dispatched by page via the 'console' event.
994
878
  * @public
995
879
  */
996
880
  export declare class ConsoleMessage {
997
- private _type;
998
- private _text;
999
- private _args;
1000
- private _stackTraceLocations;
881
+ #private;
1001
882
  /**
1002
883
  * @public
1003
884
  */
@@ -1072,7 +953,7 @@ export declare interface ContinueRequestOverrides {
1072
953
  * @example
1073
954
  * An example of using JavaScript and CSS coverage to get percentage of initially
1074
955
  * executed code:
1075
- * ```js
956
+ * ```ts
1076
957
  * // Enable both JavaScript and CSS coverage
1077
958
  * await Promise.all([
1078
959
  * page.coverage.startJSCoverage(),
@@ -1098,14 +979,7 @@ export declare interface ContinueRequestOverrides {
1098
979
  * @public
1099
980
  */
1100
981
  export declare class Coverage {
1101
- /**
1102
- * @internal
1103
- */
1104
- _jsCoverage: JSCoverage;
1105
- /**
1106
- * @internal
1107
- */
1108
- _cssCoverage: CSSCoverage;
982
+ #private;
1109
983
  constructor(client: CDPSession);
1110
984
  /**
1111
985
  * @param options - Set of configurable options for coverage defaults to
@@ -1116,7 +990,7 @@ export declare class Coverage {
1116
990
  * Anonymous scripts are ones that don't have an associated url. These are
1117
991
  * scripts that are dynamically created on the page using `eval` or
1118
992
  * `new Function`. If `reportAnonymousScripts` is set to `true`, anonymous
1119
- * scripts will have `__puppeteer_evaluation_script__` as their URL.
993
+ * scripts will have `pptr://__puppeteer_evaluation_script__` as their URL.
1120
994
  */
1121
995
  startJSCoverage(options?: JSCoverageOptions): Promise<void>;
1122
996
  /**
@@ -1166,10 +1040,11 @@ export declare interface CoverageEntry {
1166
1040
  }>;
1167
1041
  }
1168
1042
 
1169
- /**
1170
- * @internal
1171
- */
1172
- export declare function createJSHandle(context: ExecutionContext, remoteObject: Protocol.Runtime.RemoteObject): JSHandle;
1043
+ export declare const createBrowserFetcher: (options: BrowserFetcherOptions) => BrowserFetcher;
1044
+
1045
+ /* Excluded from this release type: createJSHandle */
1046
+
1047
+ /* Excluded from this release type: createLauncher */
1173
1048
 
1174
1049
  /**
1175
1050
  * @public
@@ -1183,19 +1058,11 @@ export declare interface Credentials {
1183
1058
  * @public
1184
1059
  */
1185
1060
  export declare class CSSCoverage {
1186
- _client: CDPSession;
1187
- _enabled: boolean;
1188
- _stylesheetURLs: Map<string, string>;
1189
- _stylesheetSources: Map<string, string>;
1190
- _eventListeners: PuppeteerEventListener[];
1191
- _resetOnNavigation: boolean;
1192
- _reportAnonymousScripts: boolean;
1061
+ #private;
1193
1062
  constructor(client: CDPSession);
1194
1063
  start(options?: {
1195
1064
  resetOnNavigation?: boolean;
1196
1065
  }): Promise<void>;
1197
- _onExecutionContextsCleared(): void;
1198
- _onStyleSheet(event: Protocol.CSS.StyleSheetAddedEvent): Promise<void>;
1199
1066
  stop(): Promise<CoverageEntry[]>;
1200
1067
  }
1201
1068
 
@@ -1234,7 +1101,7 @@ export declare class CustomError extends Error {
1234
1101
 
1235
1102
  /**
1236
1103
  * Contains two functions `queryOne` and `queryAll` that can
1237
- * be {@link Puppeteer.registerCustomQueryHandler | registered}
1104
+ * be {@link registerCustomQueryHandler | registered}
1238
1105
  * as alternative querying strategies. The functions `queryOne` and `queryAll`
1239
1106
  * are executed in the page context. `queryOne` should take an `Element` and a
1240
1107
  * selector string as argument and return a single `Element` or `null` if no
@@ -1244,16 +1111,21 @@ export declare class CustomError extends Error {
1244
1111
  * @public
1245
1112
  */
1246
1113
  export declare interface CustomQueryHandler {
1247
- queryOne?: (element: Element | Document, selector: string) => Element | null;
1248
- queryAll?: (element: Element | Document, selector: string) => Element[] | NodeListOf<Element>;
1114
+ queryOne?: (element: Node, selector: string) => Node | null;
1115
+ queryAll?: (element: Node, selector: string) => Node[];
1249
1116
  }
1250
1117
 
1251
1118
  /**
1119
+ * @returns a list with the names of all registered custom query handlers.
1120
+ *
1252
1121
  * @public
1253
- * {@inheritDoc Puppeteer.customQueryHandlerNames}
1254
1122
  */
1255
1123
  export declare function customQueryHandlerNames(): string[];
1256
1124
 
1125
+ /* Excluded from this release type: debug_2 */
1126
+
1127
+ /* Excluded from this release type: debugError */
1128
+
1257
1129
  /**
1258
1130
  * The default cooperative request interception resolution priority
1259
1131
  *
@@ -1261,6 +1133,8 @@ export declare function customQueryHandlerNames(): string[];
1261
1133
  */
1262
1134
  export declare const DEFAULT_INTERCEPT_RESOLUTION_PRIORITY = 0;
1263
1135
 
1136
+ export declare const defaultArgs: (options?: BrowserLaunchArgumentOptions) => string[];
1137
+
1264
1138
  /**
1265
1139
  * Copyright 2017 Google Inc. All rights reserved.
1266
1140
  *
@@ -1293,10 +1167,27 @@ export declare interface Device {
1293
1167
  }
1294
1168
 
1295
1169
  /**
1170
+ * A list of devices to be used with `page.emulate(options)`. Actual list of devices can be found in {@link https://github.com/puppeteer/puppeteer/blob/main/src/common/DeviceDescriptors.ts | src/common/DeviceDescriptors.ts}.
1171
+ *
1172
+ * @example
1173
+ *
1174
+ * ```ts
1175
+ * const puppeteer = require('puppeteer');
1176
+ * const iPhone = puppeteer.devices['iPhone 6'];
1177
+ *
1178
+ * (async () => {
1179
+ * const browser = await puppeteer.launch();
1180
+ * const page = await browser.newPage();
1181
+ * await page.emulate(iPhone);
1182
+ * await page.goto('https://www.google.com');
1183
+ * // other actions...
1184
+ * await browser.close();
1185
+ * })();
1186
+ * ```
1187
+ *
1296
1188
  * @public
1297
- * {@inheritDoc Puppeteer.devices}
1298
1189
  */
1299
- export declare let devices: DevicesMap;
1190
+ export declare const devices: DevicesMap;
1300
1191
 
1301
1192
  /**
1302
1193
  * @public
@@ -1305,18 +1196,13 @@ export declare type DevicesMap = {
1305
1196
  [name: string]: Device;
1306
1197
  };
1307
1198
 
1308
- /**
1309
- * @internal
1310
- */
1311
- export declare const devicesMap: DevicesMap;
1312
-
1313
1199
  /**
1314
1200
  * Dialog instances are dispatched by the {@link Page} via the `dialog` event.
1315
1201
  *
1316
1202
  * @remarks
1317
1203
  *
1318
1204
  * @example
1319
- * ```js
1205
+ * ```ts
1320
1206
  * const puppeteer = require('puppeteer');
1321
1207
  *
1322
1208
  * (async () => {
@@ -1333,15 +1219,8 @@ export declare const devicesMap: DevicesMap;
1333
1219
  * @public
1334
1220
  */
1335
1221
  export declare class Dialog {
1336
- private _client;
1337
- private _type;
1338
- private _message;
1339
- private _defaultValue;
1340
- private _handled;
1341
- /**
1342
- * @internal
1343
- */
1344
- constructor(client: CDPSession, type: Protocol.Page.DialogType, message: string, defaultValue?: string);
1222
+ #private;
1223
+ /* Excluded from this release type: __constructor */
1345
1224
  /**
1346
1225
  * @returns The type of the dialog.
1347
1226
  */
@@ -1368,118 +1247,17 @@ export declare class Dialog {
1368
1247
  dismiss(): Promise<void>;
1369
1248
  }
1370
1249
 
1371
- /**
1372
- * @internal
1373
- */
1374
- export declare class DOMWorld {
1375
- private _frameManager;
1376
- private _client;
1377
- private _frame;
1378
- private _timeoutSettings;
1379
- private _documentPromise?;
1380
- private _contextPromise?;
1381
- private _contextResolveCallback?;
1382
- private _detached;
1383
- /**
1384
- * @internal
1385
- */
1386
- _waitTasks: Set<WaitTask>;
1387
- /**
1388
- * @internal
1389
- * Contains mapping from functions that should be bound to Puppeteer functions.
1390
- */
1391
- _boundFunctions: Map<string, Function>;
1392
- private _ctxBindings;
1393
- private static bindingIdentifier;
1394
- constructor(client: CDPSession, frameManager: FrameManager, frame: Frame, timeoutSettings: TimeoutSettings);
1395
- frame(): Frame;
1396
- _setContext(context?: ExecutionContext): Promise<void>;
1397
- _hasContext(): boolean;
1398
- _detach(): void;
1399
- executionContext(): Promise<ExecutionContext>;
1400
- evaluateHandle<HandlerType extends JSHandle = JSHandle>(pageFunction: EvaluateHandleFn, ...args: SerializableOrJSHandle[]): Promise<HandlerType>;
1401
- evaluate<T extends EvaluateFn>(pageFunction: T, ...args: SerializableOrJSHandle[]): Promise<UnwrapPromiseLike<EvaluateFnReturnType<T>>>;
1402
- $<T extends Element = Element>(selector: string): Promise<ElementHandle<T> | null>;
1403
- _document(): Promise<ElementHandle>;
1404
- $x(expression: string): Promise<ElementHandle[]>;
1405
- $eval<ReturnType>(selector: string, pageFunction: (element: Element, ...args: unknown[]) => ReturnType | Promise<ReturnType>, ...args: SerializableOrJSHandle[]): Promise<WrapElementHandle<ReturnType>>;
1406
- $$eval<ReturnType>(selector: string, pageFunction: (elements: Element[], ...args: unknown[]) => ReturnType | Promise<ReturnType>, ...args: SerializableOrJSHandle[]): Promise<WrapElementHandle<ReturnType>>;
1407
- $$<T extends Element = Element>(selector: string): Promise<Array<ElementHandle<T>>>;
1408
- content(): Promise<string>;
1409
- setContent(html: string, options?: {
1410
- timeout?: number;
1411
- waitUntil?: PuppeteerLifeCycleEvent | PuppeteerLifeCycleEvent[];
1412
- }): Promise<void>;
1413
- /**
1414
- * Adds a script tag into the current context.
1415
- *
1416
- * @remarks
1417
- *
1418
- * You can pass a URL, filepath or string of contents. Note that when running Puppeteer
1419
- * in a browser environment you cannot pass a filepath and should use either
1420
- * `url` or `content`.
1421
- */
1422
- addScriptTag(options: {
1423
- url?: string;
1424
- path?: string;
1425
- content?: string;
1426
- id?: string;
1427
- type?: string;
1428
- }): Promise<ElementHandle>;
1429
- /**
1430
- * Adds a style tag into the current context.
1431
- *
1432
- * @remarks
1433
- *
1434
- * You can pass a URL, filepath or string of contents. Note that when running Puppeteer
1435
- * in a browser environment you cannot pass a filepath and should use either
1436
- * `url` or `content`.
1437
- *
1438
- */
1439
- addStyleTag(options: {
1440
- url?: string;
1441
- path?: string;
1442
- content?: string;
1443
- }): Promise<ElementHandle>;
1444
- click(selector: string, options: {
1445
- delay?: number;
1446
- button?: MouseButton;
1447
- clickCount?: number;
1448
- }): Promise<void>;
1449
- focus(selector: string): Promise<void>;
1450
- hover(selector: string): Promise<void>;
1451
- select(selector: string, ...values: string[]): Promise<string[]>;
1452
- tap(selector: string): Promise<void>;
1453
- type(selector: string, text: string, options?: {
1454
- delay: number;
1455
- }): Promise<void>;
1456
- waitForSelector(selector: string, options: WaitForSelectorOptions): Promise<ElementHandle | null>;
1457
- private _settingUpBinding;
1458
- /**
1459
- * @internal
1460
- */
1461
- addBindingToContext(context: ExecutionContext, name: string): Promise<void>;
1462
- private _onBindingCalled;
1463
- /**
1464
- * @internal
1465
- */
1466
- waitForSelectorInPage(queryOne: Function, selector: string, options: WaitForSelectorOptions, binding?: PageBinding): Promise<ElementHandle | null>;
1467
- waitForXPath(xpath: string, options: WaitForSelectorOptions): Promise<ElementHandle | null>;
1468
- waitForFunction(pageFunction: Function | string, options?: {
1469
- polling?: string | number;
1470
- timeout?: number;
1471
- }, ...args: SerializableOrJSHandle[]): Promise<JSHandle>;
1472
- title(): Promise<string>;
1473
- }
1250
+ /* Excluded from this release type: DOMWorld */
1251
+
1252
+ /* Excluded from this release type: downloadBrowser */
1474
1253
 
1475
1254
  /**
1476
1255
  * ElementHandle represents an in-page DOM element.
1477
1256
  *
1478
1257
  * @remarks
1479
- *
1480
1258
  * ElementHandles can be created with the {@link Page.$} method.
1481
1259
  *
1482
- * ```js
1260
+ * ```ts
1483
1261
  * const puppeteer = require('puppeteer');
1484
1262
  *
1485
1263
  * (async () => {
@@ -1506,14 +1284,9 @@ export declare class DOMWorld {
1506
1284
  *
1507
1285
  * @public
1508
1286
  */
1509
- export declare class ElementHandle<ElementType extends Element = Element> extends JSHandle<ElementType> {
1510
- private _frame;
1511
- private _page;
1512
- private _frameManager;
1513
- /**
1514
- * @internal
1515
- */
1516
- constructor(context: ExecutionContext, client: CDPSession, remoteObject: Protocol.Runtime.RemoteObject, frame: Frame, page: Page, frameManager: FrameManager);
1287
+ export declare class ElementHandle<ElementType extends Node = Element> extends JSHandle<ElementType> {
1288
+ #private;
1289
+ /* Excluded from this release type: __constructor */
1517
1290
  /**
1518
1291
  * Wait for the `selector` to appear within the element. If at the moment of calling the
1519
1292
  * method the `selector` already exists, the method will return immediately. If
@@ -1544,11 +1317,7 @@ export declare class ElementHandle<ElementType extends Element = Element> extend
1544
1317
  * (30 seconds). Pass `0` to disable timeout. The default value can be changed
1545
1318
  * by using the {@link Page.setDefaultTimeout} method.
1546
1319
  */
1547
- waitForSelector(selector: string, options?: {
1548
- visible?: boolean;
1549
- hidden?: boolean;
1550
- timeout?: number;
1551
- }): Promise<ElementHandle | null>;
1320
+ waitForSelector<Selector extends string>(selector: Selector, options?: Exclude<WaitForSelectorOptions, 'root'>): Promise<ElementHandle<NodeFor<Selector>> | null>;
1552
1321
  /**
1553
1322
  * Wait for the `xpath` within the element. If at the moment of calling the
1554
1323
  * method the `xpath` already exists, the method will return immediately. If
@@ -1558,7 +1327,7 @@ export declare class ElementHandle<ElementType extends Element = Element> extend
1558
1327
  * If `xpath` starts with `//` instead of `.//`, the dot will be appended automatically.
1559
1328
  *
1560
1329
  * This method works across navigation
1561
- * ```js
1330
+ * ```ts
1562
1331
  * const puppeteer = require('puppeteer');
1563
1332
  * (async () => {
1564
1333
  * const browser = await puppeteer.launch();
@@ -1603,54 +1372,49 @@ export declare class ElementHandle<ElementType extends Element = Element> extend
1603
1372
  visible?: boolean;
1604
1373
  hidden?: boolean;
1605
1374
  timeout?: number;
1606
- }): Promise<ElementHandle | null>;
1375
+ }): Promise<ElementHandle<Node> | null>;
1607
1376
  asElement(): ElementHandle<ElementType> | null;
1608
1377
  /**
1609
1378
  * Resolves to the content frame for element handles referencing
1610
1379
  * iframe nodes, or null otherwise
1611
1380
  */
1612
1381
  contentFrame(): Promise<Frame | null>;
1613
- private _scrollIntoViewIfNeeded;
1614
- private _getOOPIFOffsets;
1615
1382
  /**
1616
1383
  * Returns the middle point within an element unless a specific offset is provided.
1617
1384
  */
1618
1385
  clickablePoint(offset?: Offset): Promise<Point>;
1619
- private _getBoxModel;
1620
- private _fromProtocolQuad;
1621
- private _intersectQuadWithViewport;
1622
1386
  /**
1623
1387
  * This method scrolls element into view if needed, and then
1624
1388
  * uses {@link Page.mouse} to hover over the center of the element.
1625
1389
  * If the element is detached from DOM, the method throws an error.
1626
1390
  */
1627
- hover(): Promise<void>;
1391
+ hover(this: ElementHandle<Element>): Promise<void>;
1628
1392
  /**
1629
1393
  * This method scrolls element into view if needed, and then
1630
1394
  * uses {@link Page.mouse} to click in the center of the element.
1631
1395
  * If the element is detached from DOM, the method throws an error.
1632
1396
  */
1633
- click(options?: ClickOptions): Promise<void>;
1397
+ click(this: ElementHandle<Element>, options?: ClickOptions): Promise<void>;
1634
1398
  /**
1635
1399
  * This method creates and captures a dragevent from the element.
1636
1400
  */
1637
- drag(target: Point): Promise<Protocol.Input.DragData>;
1401
+ drag(this: ElementHandle<Element>, target: Point): Promise<Protocol.Input.DragData>;
1638
1402
  /**
1639
1403
  * This method creates a `dragenter` event on the element.
1640
1404
  */
1641
- dragEnter(data?: Protocol.Input.DragData): Promise<void>;
1405
+ dragEnter(this: ElementHandle<Element>, data?: Protocol.Input.DragData): Promise<void>;
1642
1406
  /**
1643
1407
  * This method creates a `dragover` event on the element.
1644
1408
  */
1645
- dragOver(data?: Protocol.Input.DragData): Promise<void>;
1409
+ dragOver(this: ElementHandle<Element>, data?: Protocol.Input.DragData): Promise<void>;
1646
1410
  /**
1647
1411
  * This method triggers a drop on the element.
1648
1412
  */
1649
- drop(data?: Protocol.Input.DragData): Promise<void>;
1413
+ drop(this: ElementHandle<Element>, data?: Protocol.Input.DragData): Promise<void>;
1650
1414
  /**
1651
1415
  * This method triggers a dragenter, dragover, and drop on the element.
1652
1416
  */
1653
- dragAndDrop(target: ElementHandle, options?: {
1417
+ dragAndDrop(this: ElementHandle<Element>, target: ElementHandle<Node>, options?: {
1654
1418
  delay: number;
1655
1419
  }): Promise<void>;
1656
1420
  /**
@@ -1659,7 +1423,7 @@ export declare class ElementHandle<ElementType extends Element = Element> extend
1659
1423
  * throws an error.
1660
1424
  *
1661
1425
  * @example
1662
- * ```js
1426
+ * ```ts
1663
1427
  * handle.select('blue'); // single selection
1664
1428
  * handle.select('red', 'green', 'blue'); // multiple selections
1665
1429
  * ```
@@ -1671,17 +1435,20 @@ export declare class ElementHandle<ElementType extends Element = Element> extend
1671
1435
  /**
1672
1436
  * This method expects `elementHandle` to point to an
1673
1437
  * {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input | input element}.
1438
+ *
1674
1439
  * @param filePaths - Sets the value of the file input to these paths.
1675
- * If some of the `filePaths` are relative paths, then they are resolved
1676
- * relative to the {@link https://nodejs.org/api/process.html#process_process_cwd | current working directory}
1440
+ * If a path is relative, then it is resolved against the
1441
+ * {@link https://nodejs.org/api/process.html#process_process_cwd | current working directory}.
1442
+ * Note for locals script connecting to remote chrome environments,
1443
+ * paths must be absolute.
1677
1444
  */
1678
- uploadFile(...filePaths: string[]): Promise<void>;
1445
+ uploadFile(this: ElementHandle<HTMLInputElement>, ...filePaths: string[]): Promise<void>;
1679
1446
  /**
1680
1447
  * This method scrolls element into view if needed, and then uses
1681
1448
  * {@link Touchscreen.tap} to tap in the center of the element.
1682
1449
  * If the element is detached from DOM, the method throws an error.
1683
1450
  */
1684
- tap(): Promise<void>;
1451
+ tap(this: ElementHandle<Element>): Promise<void>;
1685
1452
  /**
1686
1453
  * Calls {@link https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus | focus} on the element.
1687
1454
  */
@@ -1694,7 +1461,7 @@ export declare class ElementHandle<ElementType extends Element = Element> extend
1694
1461
  * use {@link ElementHandle.press}.
1695
1462
  *
1696
1463
  * @example
1697
- * ```js
1464
+ * ```ts
1698
1465
  * await elementHandle.type('Hello'); // Types instantly
1699
1466
  * await elementHandle.type('World', {delay: 100}); // Types slower, like a user
1700
1467
  * ```
@@ -1702,7 +1469,7 @@ export declare class ElementHandle<ElementType extends Element = Element> extend
1702
1469
  * @example
1703
1470
  * An example of typing into a text field and then submitting the form:
1704
1471
  *
1705
- * ```js
1472
+ * ```ts
1706
1473
  * const elementHandle = await page.$('input');
1707
1474
  * await elementHandle.type('some text');
1708
1475
  * await elementHandle.press('Enter');
@@ -1745,17 +1512,27 @@ export declare class ElementHandle<ElementType extends Element = Element> extend
1745
1512
  * {@link Page.screenshot} to take a screenshot of the element.
1746
1513
  * If the element is detached from DOM, the method throws an error.
1747
1514
  */
1748
- screenshot(options?: ScreenshotOptions): Promise<string | Buffer>;
1515
+ screenshot(this: ElementHandle<Element>, options?: ScreenshotOptions): Promise<string | Buffer>;
1749
1516
  /**
1750
- * Runs `element.querySelector` within the page. If no element matches the selector,
1751
- * the return value resolves to `null`.
1517
+ * Runs `element.querySelector` within the page.
1518
+ *
1519
+ * @param selector - The selector to query with.
1520
+ * @returns `null` if no element matches the selector.
1521
+ * @throws `Error` if the selector has no associated query handler.
1752
1522
  */
1753
- $<T extends Element = Element>(selector: string): Promise<ElementHandle<T> | null>;
1523
+ $<Selector extends string>(selector: Selector): Promise<ElementHandle<NodeFor<Selector>> | null>;
1754
1524
  /**
1755
1525
  * Runs `element.querySelectorAll` within the page. If no elements match the selector,
1756
1526
  * the return value resolves to `[]`.
1757
1527
  */
1758
- $$<T extends Element = Element>(selector: string): Promise<Array<ElementHandle<T>>>;
1528
+ /**
1529
+ * Runs `element.querySelectorAll` within the page.
1530
+ *
1531
+ * @param selector - The selector to query with.
1532
+ * @returns `[]` if no element matches the selector.
1533
+ * @throws `Error` if the selector has no associated query handler.
1534
+ */
1535
+ $$<Selector extends string>(selector: Selector): Promise<Array<ElementHandle<NodeFor<Selector>>>>;
1759
1536
  /**
1760
1537
  * This method runs `document.querySelector` within the element and passes it as
1761
1538
  * the first argument to `pageFunction`. If there's no element matching `selector`,
@@ -1765,13 +1542,16 @@ export declare class ElementHandle<ElementType extends Element = Element> extend
1765
1542
  * to resolve and return its value.
1766
1543
  *
1767
1544
  * @example
1768
- * ```js
1545
+ * ```ts
1769
1546
  * const tweetHandle = await page.$('.tweet');
1770
1547
  * expect(await tweetHandle.$eval('.like', node => node.innerText)).toBe('100');
1771
1548
  * expect(await tweetHandle.$eval('.retweets', node => node.innerText)).toBe('10');
1772
1549
  * ```
1773
1550
  */
1774
- $eval<ReturnType>(selector: string, pageFunction: (element: Element, ...args: unknown[]) => ReturnType | Promise<ReturnType>, ...args: SerializableOrJSHandle[]): Promise<WrapElementHandle<ReturnType>>;
1551
+ $eval<Selector extends string, Params extends unknown[], Func extends EvaluateFunc<[
1552
+ ElementHandle<NodeFor<Selector>>,
1553
+ ...Params
1554
+ ]> = EvaluateFunc<[ElementHandle<NodeFor<Selector>>, ...Params]>>(selector: Selector, pageFunction: Func | string, ...args: Params): Promise<Awaited<ReturnType<Func>>>;
1775
1555
  /**
1776
1556
  * This method runs `document.querySelectorAll` within the element and passes it as
1777
1557
  * the first argument to `pageFunction`. If there's no element matching `selector`,
@@ -1789,56 +1569,74 @@ export declare class ElementHandle<ElementType extends Element = Element> extend
1789
1569
  * ```
1790
1570
  *
1791
1571
  * @example
1792
- * ```js
1572
+ * ```ts
1793
1573
  * const feedHandle = await page.$('.feed');
1794
1574
  * expect(await feedHandle.$$eval('.tweet', nodes => nodes.map(n => n.innerText)))
1795
1575
  * .toEqual(['Hello!', 'Hi!']);
1796
1576
  * ```
1797
1577
  */
1798
- $$eval<ReturnType>(selector: string, pageFunction: (elements: Element[], ...args: unknown[]) => ReturnType | Promise<ReturnType>, ...args: SerializableOrJSHandle[]): Promise<WrapElementHandle<ReturnType>>;
1578
+ $$eval<Selector extends string, Params extends unknown[], Func extends EvaluateFunc<[
1579
+ Array<NodeFor<Selector>>,
1580
+ ...Params
1581
+ ]> = EvaluateFunc<[Array<NodeFor<Selector>>, ...Params]>>(selector: Selector, pageFunction: Func | string, ...args: Params): Promise<Awaited<ReturnType<Func>>>;
1799
1582
  /**
1800
1583
  * The method evaluates the XPath expression relative to the elementHandle.
1801
1584
  * If there are no such elements, the method will resolve to an empty array.
1802
1585
  * @param expression - Expression to {@link https://developer.mozilla.org/en-US/docs/Web/API/Document/evaluate | evaluate}
1803
1586
  */
1804
- $x(expression: string): Promise<ElementHandle[]>;
1587
+ $x(expression: string): Promise<Array<ElementHandle<Node>>>;
1805
1588
  /**
1806
1589
  * Resolves to true if the element is visible in the current viewport.
1807
1590
  */
1808
- isIntersectingViewport(options?: {
1591
+ isIntersectingViewport(this: ElementHandle<Element>, options?: {
1809
1592
  threshold?: number;
1810
1593
  }): Promise<boolean>;
1811
1594
  }
1812
1595
 
1596
+ /* Excluded from this release type: EmulationManager */
1597
+
1813
1598
  /**
1814
1599
  * @public
1815
1600
  */
1816
1601
  export declare type ErrorCode = 'aborted' | 'accessdenied' | 'addressunreachable' | 'blockedbyclient' | 'blockedbyresponse' | 'connectionaborted' | 'connectionclosed' | 'connectionfailed' | 'connectionrefused' | 'connectionreset' | 'internetdisconnected' | 'namenotresolved' | 'timedout' | 'failed';
1817
1602
 
1818
- /**
1819
- * @public
1820
- */
1821
- export declare let errors: PuppeteerErrors;
1603
+ /* Excluded from this release type: ErrorLike */
1822
1604
 
1823
1605
  /**
1606
+ * Puppeteer methods might throw errors if they are unable to fulfill a request.
1607
+ * For example, `page.waitForSelector(selector[, options])` might fail if the
1608
+ * selector doesn't match any nodes during the given timeframe.
1609
+ *
1610
+ * For certain types of errors Puppeteer uses specific error classes. These
1611
+ * classes are available via `puppeteer.errors`.
1612
+ *
1613
+ * @example
1614
+ * An example of handling a timeout error:
1615
+ * ```ts
1616
+ * try {
1617
+ * await page.waitForSelector('.foo');
1618
+ * } catch (e) {
1619
+ * if (e instanceof puppeteer.errors.TimeoutError) {
1620
+ * // Do something if this is a timeout.
1621
+ * }
1622
+ * }
1623
+ * ```
1624
+ *
1824
1625
  * @public
1825
1626
  */
1826
- export declare type EvaluateFn<T = any> = string | ((arg1: T, ...args: any[]) => any);
1627
+ export declare const errors: PuppeteerErrors;
1827
1628
 
1828
1629
  /**
1829
1630
  * @public
1830
1631
  */
1831
- export declare type EvaluateFnReturnType<T extends EvaluateFn> = T extends (...args: any[]) => infer R ? R : any;
1632
+ export declare type EvaluateFunc<T extends unknown[]> = (...params: InnerParams<T>) => Awaitable<unknown>;
1832
1633
 
1833
1634
  /**
1834
1635
  * @public
1835
1636
  */
1836
- export declare type EvaluateHandleFn = string | ((...args: any[]) => any);
1637
+ export declare const EVALUATION_SCRIPT_URL = "pptr://__puppeteer_evaluation_script__";
1837
1638
 
1838
- /**
1839
- * @public
1840
- */
1841
- export declare const EVALUATION_SCRIPT_URL = "__puppeteer_evaluation_script__";
1639
+ /* Excluded from this release type: evaluationString */
1842
1640
 
1843
1641
  /**
1844
1642
  * The EventEmitter class that many Puppeteer classes extend.
@@ -1855,10 +1653,7 @@ export declare const EVALUATION_SCRIPT_URL = "__puppeteer_evaluation_script__";
1855
1653
  export declare class EventEmitter implements CommonEventEmitter {
1856
1654
  private emitter;
1857
1655
  private eventsMap;
1858
- /**
1859
- * @internal
1860
- */
1861
- constructor();
1656
+ /* Excluded from this release type: __constructor */
1862
1657
  /**
1863
1658
  * Bind an event listener to fire when an event occurs.
1864
1659
  * @param event - the event type you'd like to listen to. Can be a string or symbol.
@@ -1920,10 +1715,11 @@ export declare class EventEmitter implements CommonEventEmitter {
1920
1715
  */
1921
1716
  export declare type EventType = string | symbol;
1922
1717
 
1923
- /**
1924
- * @internal
1925
- */
1926
- export declare type ExceptionThrownCallback = (details: Protocol.Runtime.ExceptionDetails) => void;
1718
+ /* Excluded from this release type: ExceptionThrownCallback */
1719
+
1720
+ export declare const executablePath: (channel?: string | undefined) => string;
1721
+
1722
+ /* Excluded from this release type: executablePathForChannel */
1927
1723
 
1928
1724
  /**
1929
1725
  * This class represents a context for JavaScript execution. A [Page] might have
@@ -1943,26 +1739,12 @@ export declare type ExceptionThrownCallback = (details: Protocol.Runtime.Excepti
1943
1739
  * @public
1944
1740
  */
1945
1741
  export declare class ExecutionContext {
1946
- /**
1947
- * @internal
1948
- */
1949
- _client: CDPSession;
1950
- /**
1951
- * @internal
1952
- */
1953
- _world: DOMWorld;
1954
- /**
1955
- * @internal
1956
- */
1957
- _contextId: number;
1958
- /**
1959
- * @internal
1960
- */
1961
- _contextName: string;
1962
- /**
1963
- * @internal
1964
- */
1965
- constructor(client: CDPSession, contextPayload: Protocol.Runtime.ExecutionContextDescription, world: DOMWorld);
1742
+ #private;
1743
+ /* Excluded from this release type: _client */
1744
+ /* Excluded from this release type: _world */
1745
+ /* Excluded from this release type: _contextId */
1746
+ /* Excluded from this release type: _contextName */
1747
+ /* Excluded from this release type: __constructor */
1966
1748
  /**
1967
1749
  * @remarks
1968
1750
  *
@@ -1985,7 +1767,7 @@ export declare class ExecutionContext {
1985
1767
  *
1986
1768
  *
1987
1769
  * @example
1988
- * ```js
1770
+ * ```ts
1989
1771
  * const executionContext = await page.mainFrame().executionContext();
1990
1772
  * const result = await executionContext.evaluate(() => Promise.resolve(8 * 7))* ;
1991
1773
  * console.log(result); // prints "56"
@@ -1994,14 +1776,14 @@ export declare class ExecutionContext {
1994
1776
  * @example
1995
1777
  * A string can also be passed in instead of a function.
1996
1778
  *
1997
- * ```js
1779
+ * ```ts
1998
1780
  * console.log(await executionContext.evaluate('1 + 2')); // prints "3"
1999
1781
  * ```
2000
1782
  *
2001
1783
  * @example
2002
1784
  * {@link JSHandle} instances can be passed as arguments to the
2003
1785
  * `executionContext.* evaluate`:
2004
- * ```js
1786
+ * ```ts
2005
1787
  * const oneHandle = await executionContext.evaluateHandle(() => 1);
2006
1788
  * const twoHandle = await executionContext.evaluateHandle(() => 2);
2007
1789
  * const result = await executionContext.evaluate(
@@ -2016,7 +1798,7 @@ export declare class ExecutionContext {
2016
1798
  *
2017
1799
  * @returns A promise that resolves to the return value of the given function.
2018
1800
  */
2019
- evaluate<ReturnType>(pageFunction: Function | string, ...args: unknown[]): Promise<ReturnType>;
1801
+ evaluate<Params extends unknown[], Func extends EvaluateFunc<Params> = EvaluateFunc<Params>>(pageFunction: Func | string, ...args: Params): Promise<Awaited<ReturnType<Func>>>;
2020
1802
  /**
2021
1803
  * @remarks
2022
1804
  * The only difference between `executionContext.evaluate` and
@@ -2027,7 +1809,7 @@ export declare class ExecutionContext {
2027
1809
  * promise to resolve and return its value.
2028
1810
  *
2029
1811
  * @example
2030
- * ```js
1812
+ * ```ts
2031
1813
  * const context = await page.mainFrame().executionContext();
2032
1814
  * const aHandle = await context.evaluateHandle(() => Promise.resolve(self));
2033
1815
  * aHandle; // Handle for the global object.
@@ -2036,7 +1818,7 @@ export declare class ExecutionContext {
2036
1818
  * @example
2037
1819
  * A string can also be passed in instead of a function.
2038
1820
  *
2039
- * ```js
1821
+ * ```ts
2040
1822
  * // Handle for the '3' * object.
2041
1823
  * const aHandle = await context.evaluateHandle('1 + 2');
2042
1824
  * ```
@@ -2045,7 +1827,7 @@ export declare class ExecutionContext {
2045
1827
  * JSHandle instances can be passed as arguments
2046
1828
  * to the `executionContext.* evaluateHandle`:
2047
1829
  *
2048
- * ```js
1830
+ * ```ts
2049
1831
  * const aHandle = await context.evaluateHandle(() => document.body);
2050
1832
  * const resultHandle = await context.evaluateHandle(body => body.innerHTML, * aHandle);
2051
1833
  * console.log(await resultHandle.jsonValue()); // prints body's innerHTML
@@ -2059,14 +1841,13 @@ export declare class ExecutionContext {
2059
1841
  * @returns A promise that resolves to the return value of the given function
2060
1842
  * as an in-page object (a {@link JSHandle}).
2061
1843
  */
2062
- evaluateHandle<HandleType extends JSHandle | ElementHandle = JSHandle>(pageFunction: EvaluateHandleFn, ...args: SerializableOrJSHandle[]): Promise<HandleType>;
2063
- private _evaluateInternal;
1844
+ evaluateHandle<Params extends unknown[], Func extends EvaluateFunc<Params> = EvaluateFunc<Params>>(pageFunction: Func | string, ...args: Params): Promise<HandleFor<Awaited<ReturnType<Func>>>>;
2064
1845
  /**
2065
1846
  * This method iterates the JavaScript heap and finds all the objects with the
2066
1847
  * given prototype.
2067
1848
  * @remarks
2068
1849
  * @example
2069
- * ```js
1850
+ * ```ts
2070
1851
  * // Create a Map object
2071
1852
  * await page.evaluate(() => window.map = new Map());
2072
1853
  * // Get a handle to the Map object prototype
@@ -2083,18 +1864,12 @@ export declare class ExecutionContext {
2083
1864
  *
2084
1865
  * @returns A handle to an array of objects with the given prototype.
2085
1866
  */
2086
- queryObjects(prototypeHandle: JSHandle): Promise<JSHandle>;
2087
- /**
2088
- * @internal
2089
- */
2090
- _adoptBackendNodeId(backendNodeId: Protocol.DOM.BackendNodeId): Promise<ElementHandle>;
2091
- /**
2092
- * @internal
2093
- */
2094
- _adoptElementHandle(elementHandle: ElementHandle): Promise<ElementHandle>;
1867
+ queryObjects<Prototype>(prototypeHandle: JSHandle<Prototype>): Promise<HandleFor<Prototype[]>>;
1868
+ /* Excluded from this release type: _adoptBackendNodeId */
1869
+ /* Excluded from this release type: _adoptElementHandle */
2095
1870
  }
2096
1871
 
2097
- declare type FetchRequestId = string;
1872
+ /* Excluded from this release type: FetchRequestId */
2098
1873
 
2099
1874
  /**
2100
1875
  * File choosers let you react to the page requesting for a file.
@@ -2102,7 +1877,7 @@ declare type FetchRequestId = string;
2102
1877
  * `FileChooser` objects are returned via the `page.waitForFileChooser` method.
2103
1878
  * @example
2104
1879
  * An example of using `FileChooser`:
2105
- * ```js
1880
+ * ```ts
2106
1881
  * const [fileChooser] = await Promise.all([
2107
1882
  * page.waitForFileChooser(),
2108
1883
  * page.click('#upload-file-button'), // some button that triggers file selection
@@ -2115,13 +1890,8 @@ declare type FetchRequestId = string;
2115
1890
  * @public
2116
1891
  */
2117
1892
  export declare class FileChooser {
2118
- private _element;
2119
- private _multiple;
2120
- private _handled;
2121
- /**
2122
- * @internal
2123
- */
2124
- constructor(element: ElementHandle, event: Protocol.Page.FileChooserOpenedEvent);
1893
+ #private;
1894
+ /* Excluded from this release type: __constructor */
2125
1895
  /**
2126
1896
  * Whether file chooser allow for {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#attr-multiple | multiple} file selection.
2127
1897
  */
@@ -2138,6 +1908,13 @@ export declare class FileChooser {
2138
1908
  cancel(): void;
2139
1909
  }
2140
1910
 
1911
+ /* Excluded from this release type: FirefoxLauncher */
1912
+
1913
+ /**
1914
+ * @public
1915
+ */
1916
+ export declare type FlattenHandle<T> = T extends HandleOr<infer U> ? U : never;
1917
+
2141
1918
  /**
2142
1919
  * At every point of time, page exposes its current frame tree via the
2143
1920
  * {@link Page.mainFrame | page.mainFrame} and
@@ -2157,7 +1934,7 @@ export declare class FileChooser {
2157
1934
  * @Example
2158
1935
  * An example of dumping frame tree:
2159
1936
  *
2160
- * ```js
1937
+ * ```ts
2161
1938
  * const puppeteer = require('puppeteer');
2162
1939
  *
2163
1940
  * (async () => {
@@ -2179,7 +1956,7 @@ export declare class FileChooser {
2179
1956
  * @Example
2180
1957
  * An example of getting text from an iframe element:
2181
1958
  *
2182
- * ```js
1959
+ * ```ts
2183
1960
  * const frame = page.frames().find(frame => frame.name() === 'myframe');
2184
1961
  * const text = await frame.$eval('.selector', element => element.textContent);
2185
1962
  * console.log(text);
@@ -2188,57 +1965,18 @@ export declare class FileChooser {
2188
1965
  * @public
2189
1966
  */
2190
1967
  export declare class Frame {
2191
- /**
2192
- * @internal
2193
- */
2194
- _frameManager: FrameManager;
2195
- private _parentFrame?;
2196
- /**
2197
- * @internal
2198
- */
2199
- _id: string;
2200
- private _url;
2201
- private _detached;
2202
- /**
2203
- * @internal
2204
- */
2205
- _loaderId: string;
2206
- /**
2207
- * @internal
2208
- */
2209
- _name?: string;
2210
- /**
2211
- * @internal
2212
- */
2213
- _hasStartedLoading: boolean;
2214
- /**
2215
- * @internal
2216
- */
2217
- _lifecycleEvents: Set<string>;
2218
- /**
2219
- * @internal
2220
- */
2221
- _mainWorld: DOMWorld;
2222
- /**
2223
- * @internal
2224
- */
2225
- _secondaryWorld: DOMWorld;
2226
- /**
2227
- * @internal
2228
- */
2229
- _childFrames: Set<Frame>;
2230
- /**
2231
- * @internal
2232
- */
2233
- _client: CDPSession;
2234
- /**
2235
- * @internal
2236
- */
2237
- constructor(frameManager: FrameManager, parentFrame: Frame | null, frameId: string, client: CDPSession);
2238
- /**
2239
- * @internal
2240
- */
2241
- _updateClient(client: CDPSession): void;
1968
+ #private;
1969
+ /* Excluded from this release type: _frameManager */
1970
+ /* Excluded from this release type: _id */
1971
+ /* Excluded from this release type: _loaderId */
1972
+ /* Excluded from this release type: _name */
1973
+ /* Excluded from this release type: _hasStartedLoading */
1974
+ /* Excluded from this release type: _lifecycleEvents */
1975
+ /* Excluded from this release type: _mainWorld */
1976
+ /* Excluded from this release type: _secondaryWorld */
1977
+ /* Excluded from this release type: _childFrames */
1978
+ /* Excluded from this release type: __constructor */
1979
+ /* Excluded from this release type: _updateClient */
2242
1980
  /**
2243
1981
  * @remarks
2244
1982
  *
@@ -2295,7 +2033,7 @@ export declare class Frame {
2295
2033
  * you run code which will indirectly cause the frame to navigate. Consider
2296
2034
  * this example:
2297
2035
  *
2298
- * ```js
2036
+ * ```ts
2299
2037
  * const [response] = await Promise.all([
2300
2038
  * // The navigation promise resolves after navigation has finished
2301
2039
  * frame.waitForNavigation(),
@@ -2313,10 +2051,7 @@ export declare class Frame {
2313
2051
  timeout?: number;
2314
2052
  waitUntil?: PuppeteerLifeCycleEvent | PuppeteerLifeCycleEvent[];
2315
2053
  }): Promise<HTTPResponse | null>;
2316
- /**
2317
- * @internal
2318
- */
2319
- client(): CDPSession;
2054
+ /* Excluded from this release type: _client */
2320
2055
  /**
2321
2056
  * @returns a promise that resolves to the frame's default execution context.
2322
2057
  */
@@ -2334,7 +2069,7 @@ export declare class Frame {
2334
2069
  * @param pageFunction - a function that is run within the frame
2335
2070
  * @param args - arguments to be passed to the pageFunction
2336
2071
  */
2337
- evaluateHandle<HandlerType extends JSHandle = JSHandle>(pageFunction: EvaluateHandleFn, ...args: SerializableOrJSHandle[]): Promise<HandlerType>;
2072
+ evaluateHandle<Params extends unknown[], Func extends EvaluateFunc<Params> = EvaluateFunc<Params>>(pageFunction: Func | string, ...args: Params): Promise<HandleFor<Awaited<ReturnType<Func>>>>;
2338
2073
  /**
2339
2074
  * @remarks
2340
2075
  *
@@ -2344,7 +2079,7 @@ export declare class Frame {
2344
2079
  * @param pageFunction - a function that is run within the frame
2345
2080
  * @param args - arguments to be passed to the pageFunction
2346
2081
  */
2347
- evaluate<T extends EvaluateFn>(pageFunction: T, ...args: SerializableOrJSHandle[]): Promise<UnwrapPromiseLike<EvaluateFnReturnType<T>>>;
2082
+ evaluate<Params extends unknown[], Func extends EvaluateFunc<Params> = EvaluateFunc<Params>>(pageFunction: Func | string, ...args: Params): Promise<Awaited<ReturnType<Func>>>;
2348
2083
  /**
2349
2084
  * This method queries the frame for the given selector.
2350
2085
  *
@@ -2352,13 +2087,20 @@ export declare class Frame {
2352
2087
  * @returns A promise which resolves to an `ElementHandle` pointing at the
2353
2088
  * element, or `null` if it was not found.
2354
2089
  */
2355
- $<T extends Element = Element>(selector: string): Promise<ElementHandle<T> | null>;
2090
+ $<Selector extends string>(selector: Selector): Promise<ElementHandle<NodeFor<Selector>> | null>;
2091
+ /**
2092
+ * This runs `document.querySelectorAll` in the frame and returns the result.
2093
+ *
2094
+ * @param selector - a selector to search for
2095
+ * @returns An array of element handles pointing to the found frame elements.
2096
+ */
2097
+ $$<Selector extends string>(selector: Selector): Promise<Array<ElementHandle<NodeFor<Selector>>>>;
2356
2098
  /**
2357
2099
  * This method evaluates the given XPath expression and returns the results.
2358
2100
  *
2359
2101
  * @param expression - the XPath expression to evaluate.
2360
2102
  */
2361
- $x(expression: string): Promise<ElementHandle[]>;
2103
+ $x(expression: string): Promise<Array<ElementHandle<Node>>>;
2362
2104
  /**
2363
2105
  * @remarks
2364
2106
  *
@@ -2370,7 +2112,7 @@ export declare class Frame {
2370
2112
  *
2371
2113
  * @example
2372
2114
  *
2373
- * ```js
2115
+ * ```ts
2374
2116
  * const searchValue = await frame.$eval('#search', el => el.value);
2375
2117
  * ```
2376
2118
  *
@@ -2378,7 +2120,10 @@ export declare class Frame {
2378
2120
  * @param pageFunction - the function to be evaluated in the frame's context
2379
2121
  * @param args - additional arguments to pass to `pageFunction`
2380
2122
  */
2381
- $eval<ReturnType>(selector: string, pageFunction: (element: Element, ...args: unknown[]) => ReturnType | Promise<ReturnType>, ...args: SerializableOrJSHandle[]): Promise<WrapElementHandle<ReturnType>>;
2123
+ $eval<Selector extends string, Params extends unknown[], Func extends EvaluateFunc<[
2124
+ ElementHandle<NodeFor<Selector>>,
2125
+ ...Params
2126
+ ]> = EvaluateFunc<[ElementHandle<NodeFor<Selector>>, ...Params]>>(selector: Selector, pageFunction: Func | string, ...args: Params): Promise<Awaited<ReturnType<Func>>>;
2382
2127
  /**
2383
2128
  * @remarks
2384
2129
  *
@@ -2390,7 +2135,7 @@ export declare class Frame {
2390
2135
  *
2391
2136
  * @example
2392
2137
  *
2393
- * ```js
2138
+ * ```ts
2394
2139
  * const divsCounts = await frame.$$eval('div', divs => divs.length);
2395
2140
  * ```
2396
2141
  *
@@ -2398,14 +2143,10 @@ export declare class Frame {
2398
2143
  * @param pageFunction - the function to be evaluated in the frame's context
2399
2144
  * @param args - additional arguments to pass to `pageFunction`
2400
2145
  */
2401
- $$eval<ReturnType>(selector: string, pageFunction: (elements: Element[], ...args: unknown[]) => ReturnType | Promise<ReturnType>, ...args: SerializableOrJSHandle[]): Promise<WrapElementHandle<ReturnType>>;
2402
- /**
2403
- * This runs `document.querySelectorAll` in the frame and returns the result.
2404
- *
2405
- * @param selector - a selector to search for
2406
- * @returns An array of element handles pointing to the found frame elements.
2407
- */
2408
- $$<T extends Element = Element>(selector: string): Promise<Array<ElementHandle<T>>>;
2146
+ $$eval<Selector extends string, Params extends unknown[], Func extends EvaluateFunc<[
2147
+ Array<NodeFor<Selector>>,
2148
+ ...Params
2149
+ ]> = EvaluateFunc<[Array<NodeFor<Selector>>, ...Params]>>(selector: Selector, pageFunction: Func | string, ...args: Params): Promise<Awaited<ReturnType<Func>>>;
2409
2150
  /**
2410
2151
  * @returns the full HTML contents of the frame, including the doctype.
2411
2152
  */
@@ -2457,7 +2198,7 @@ export declare class Frame {
2457
2198
  * `onload` event fires or when the script content was injected into the
2458
2199
  * frame.
2459
2200
  */
2460
- addScriptTag(options: FrameAddScriptTagOptions): Promise<ElementHandle>;
2201
+ addScriptTag(options: FrameAddScriptTagOptions): Promise<ElementHandle<HTMLScriptElement>>;
2461
2202
  /**
2462
2203
  * Adds a `<link rel="stylesheet">` tag into the page with the desired url or
2463
2204
  * a `<style type="text/css">` tag with the content.
@@ -2468,7 +2209,7 @@ export declare class Frame {
2468
2209
  * `onload` event fires or when the CSS content was injected into the
2469
2210
  * frame.
2470
2211
  */
2471
- addStyleTag(options: FrameAddStyleTagOptions): Promise<ElementHandle>;
2212
+ addStyleTag(options: FrameAddStyleTagOptions): Promise<ElementHandle<Node>>;
2472
2213
  /**
2473
2214
  *
2474
2215
  * This method clicks the first element found that matches `selector`.
@@ -2530,7 +2271,7 @@ export declare class Frame {
2530
2271
  * method throws an error.
2531
2272
  *
2532
2273
  * @example
2533
- * ```js
2274
+ * ```ts
2534
2275
  * frame.select('select#colors', 'blue'); // single selection
2535
2276
  * frame.select('select#colors', 'red', 'green', 'blue'); // multiple selections
2536
2277
  * ```
@@ -2564,7 +2305,7 @@ export declare class Frame {
2564
2305
  * {@link Keyboard.press}.
2565
2306
  *
2566
2307
  * @example
2567
- * ```js
2308
+ * ```ts
2568
2309
  * await frame.type('#mytextarea', 'Hello'); // Types instantly
2569
2310
  * await frame.type('#mytextarea', 'World', {delay: 100}); // Types slower, like a user
2570
2311
  * ```
@@ -2580,32 +2321,6 @@ export declare class Frame {
2580
2321
  type(selector: string, text: string, options?: {
2581
2322
  delay: number;
2582
2323
  }): Promise<void>;
2583
- /**
2584
- * @remarks
2585
- *
2586
- * This method behaves differently depending on the first parameter. If it's a
2587
- * `string`, it will be treated as a `selector` or `xpath` (if the string
2588
- * starts with `//`). This method then is a shortcut for
2589
- * {@link Frame.waitForSelector} or {@link Frame.waitForXPath}.
2590
- *
2591
- * If the first argument is a function this method is a shortcut for
2592
- * {@link Frame.waitForFunction}.
2593
- *
2594
- * If the first argument is a `number`, it's treated as a timeout in
2595
- * milliseconds and the method returns a promise which resolves after the
2596
- * timeout.
2597
- *
2598
- * @param selectorOrFunctionOrTimeout - a selector, predicate or timeout to
2599
- * wait for.
2600
- * @param options - optional waiting parameters.
2601
- * @param args - arguments to pass to `pageFunction`.
2602
- *
2603
- * @deprecated Don't use this method directly. Instead use the more explicit
2604
- * methods available: {@link Frame.waitForSelector},
2605
- * {@link Frame.waitForXPath}, {@link Frame.waitForFunction} or
2606
- * {@link Frame.waitForTimeout}.
2607
- */
2608
- waitFor(selectorOrFunctionOrTimeout: string | number | Function, options?: Record<string, unknown>, ...args: SerializableOrJSHandle[]): Promise<JSHandle | null>;
2609
2324
  /**
2610
2325
  * Causes your script to wait for the given number of milliseconds.
2611
2326
  *
@@ -2637,7 +2352,7 @@ export declare class Frame {
2637
2352
  * This method works across navigations.
2638
2353
  *
2639
2354
  * @example
2640
- * ```js
2355
+ * ```ts
2641
2356
  * const puppeteer = require('puppeteer');
2642
2357
  *
2643
2358
  * (async () => {
@@ -2660,7 +2375,7 @@ export declare class Frame {
2660
2375
  * @returns a promise which resolves when an element matching the selector
2661
2376
  * string is added to the DOM.
2662
2377
  */
2663
- waitForSelector(selector: string, options?: WaitForSelectorOptions): Promise<ElementHandle | null>;
2378
+ waitForSelector<Selector extends string>(selector: Selector, options?: WaitForSelectorOptions): Promise<ElementHandle<NodeFor<Selector>> | null>;
2664
2379
  /**
2665
2380
  * @remarks
2666
2381
  * Wait for the `xpath` to appear in page. If at the moment of calling the
@@ -2676,14 +2391,14 @@ export declare class Frame {
2676
2391
  * @param options - options to configure the visiblity of the element and how
2677
2392
  * long to wait before timing out.
2678
2393
  */
2679
- waitForXPath(xpath: string, options?: WaitForSelectorOptions): Promise<ElementHandle | null>;
2394
+ waitForXPath(xpath: string, options?: WaitForSelectorOptions): Promise<ElementHandle<Node> | null>;
2680
2395
  /**
2681
2396
  * @remarks
2682
2397
  *
2683
2398
  * @example
2684
2399
  *
2685
2400
  * The `waitForFunction` can be used to observe viewport size change:
2686
- * ```js
2401
+ * ```ts
2687
2402
  * const puppeteer = require('puppeteer');
2688
2403
  *
2689
2404
  * (async () => {
@@ -2698,7 +2413,7 @@ export declare class Frame {
2698
2413
  *
2699
2414
  * To pass arguments from Node.js to the predicate of `page.waitForFunction` function:
2700
2415
  *
2701
- * ```js
2416
+ * ```ts
2702
2417
  * const selector = '.foo';
2703
2418
  * await frame.waitForFunction(
2704
2419
  * selector => !!document.querySelector(selector),
@@ -2712,43 +2427,25 @@ export declare class Frame {
2712
2427
  * @param args - arguments to pass to the `pageFunction`.
2713
2428
  * @returns the promise which resolve when the `pageFunction` returns a truthy value.
2714
2429
  */
2715
- waitForFunction(pageFunction: Function | string, options?: FrameWaitForFunctionOptions, ...args: SerializableOrJSHandle[]): Promise<JSHandle>;
2430
+ waitForFunction<Params extends unknown[], Func extends EvaluateFunc<Params> = EvaluateFunc<Params>>(pageFunction: Func | string, options?: FrameWaitForFunctionOptions, ...args: Params): Promise<HandleFor<Awaited<ReturnType<Func>>>>;
2716
2431
  /**
2717
2432
  * @returns the frame's title.
2718
2433
  */
2719
2434
  title(): Promise<string>;
2435
+ /* Excluded from this release type: _navigated */
2436
+ /* Excluded from this release type: _navigatedWithinDocument */
2437
+ /* Excluded from this release type: _onLifecycleEvent */
2438
+ /* Excluded from this release type: _onLoadingStopped */
2439
+ /* Excluded from this release type: _onLoadingStarted */
2440
+ /* Excluded from this release type: _detach */
2441
+ }
2442
+
2443
+ /**
2444
+ * @public
2445
+ */
2446
+ export declare interface FrameAddScriptTagOptions {
2720
2447
  /**
2721
- * @internal
2722
- */
2723
- _navigated(framePayload: Protocol.Page.Frame): void;
2724
- /**
2725
- * @internal
2726
- */
2727
- _navigatedWithinDocument(url: string): void;
2728
- /**
2729
- * @internal
2730
- */
2731
- _onLifecycleEvent(loaderId: string, name: string): void;
2732
- /**
2733
- * @internal
2734
- */
2735
- _onLoadingStopped(): void;
2736
- /**
2737
- * @internal
2738
- */
2739
- _onLoadingStarted(): void;
2740
- /**
2741
- * @internal
2742
- */
2743
- _detach(): void;
2744
- }
2745
-
2746
- /**
2747
- * @public
2748
- */
2749
- export declare interface FrameAddScriptTagOptions {
2750
- /**
2751
- * the URL of the script to be added.
2448
+ * the URL of the script to be added.
2752
2449
  */
2753
2450
  url?: string;
2754
2451
  /**
@@ -2789,73 +2486,13 @@ export declare interface FrameAddStyleTagOptions {
2789
2486
  content?: string;
2790
2487
  }
2791
2488
 
2792
- /**
2793
- * @internal
2794
- */
2795
- export declare class FrameManager extends EventEmitter {
2796
- _client: CDPSession;
2797
- private _page;
2798
- private _networkManager;
2799
- _timeoutSettings: TimeoutSettings;
2800
- private _frames;
2801
- private _contextIdToContext;
2802
- private _isolatedWorlds;
2803
- private _mainFrame;
2804
- constructor(client: CDPSession, page: Page, ignoreHTTPSErrors: boolean, timeoutSettings: TimeoutSettings);
2805
- private setupEventListeners;
2806
- initialize(client?: CDPSession): Promise<void>;
2807
- networkManager(): NetworkManager;
2808
- navigateFrame(frame: Frame, url: string, options?: {
2809
- referer?: string;
2810
- timeout?: number;
2811
- waitUntil?: PuppeteerLifeCycleEvent | PuppeteerLifeCycleEvent[];
2812
- }): Promise<HTTPResponse | null>;
2813
- waitForFrameNavigation(frame: Frame, options?: {
2814
- timeout?: number;
2815
- waitUntil?: PuppeteerLifeCycleEvent | PuppeteerLifeCycleEvent[];
2816
- }): Promise<HTTPResponse | null>;
2817
- private _onAttachedToTarget;
2818
- private _onDetachedFromTarget;
2819
- _onLifecycleEvent(event: Protocol.Page.LifecycleEventEvent): void;
2820
- _onFrameStartedLoading(frameId: string): void;
2821
- _onFrameStoppedLoading(frameId: string): void;
2822
- _handleFrameTree(session: CDPSession, frameTree: Protocol.Page.FrameTree): void;
2823
- page(): Page;
2824
- mainFrame(): Frame;
2825
- frames(): Frame[];
2826
- frame(frameId: string): Frame | null;
2827
- _onFrameAttached(session: CDPSession, frameId: string, parentFrameId?: string): void;
2828
- _onFrameNavigated(framePayload: Protocol.Page.Frame): void;
2829
- _ensureIsolatedWorld(session: CDPSession, name: string): Promise<void>;
2830
- _onFrameNavigatedWithinDocument(frameId: string, url: string): void;
2831
- _onFrameDetached(frameId: string, reason: Protocol.Page.FrameDetachedEventReason): void;
2832
- _onExecutionContextCreated(contextPayload: Protocol.Runtime.ExecutionContextDescription, session: CDPSession): void;
2833
- private _onExecutionContextDestroyed;
2834
- private _onExecutionContextsCleared;
2835
- executionContextById(contextId: number, session?: CDPSession): ExecutionContext;
2836
- private _removeFramesRecursively;
2837
- }
2489
+ /* Excluded from this release type: FrameManager */
2838
2490
 
2839
2491
  declare interface FrameManager_2 {
2840
2492
  frame(frameId: string): Frame | null;
2841
2493
  }
2842
2494
 
2843
- /**
2844
- * We use symbols to prevent external parties listening to these events.
2845
- * They are internal to Puppeteer.
2846
- *
2847
- * @internal
2848
- */
2849
- export declare const FrameManagerEmittedEvents: {
2850
- FrameAttached: symbol;
2851
- FrameNavigated: symbol;
2852
- FrameDetached: symbol;
2853
- FrameSwapped: symbol;
2854
- LifecycleEvent: symbol;
2855
- FrameNavigatedWithinDocument: symbol;
2856
- ExecutionContextCreated: symbol;
2857
- ExecutionContextDestroyed: symbol;
2858
- };
2495
+ /* Excluded from this release type: FrameManagerEmittedEvents */
2859
2496
 
2860
2497
  /**
2861
2498
  * @public
@@ -2900,13 +2537,25 @@ export declare interface GeolocationOptions {
2900
2537
  accuracy?: number;
2901
2538
  }
2902
2539
 
2540
+ /* Excluded from this release type: getExceptionMessage */
2541
+
2542
+ /* Excluded from this release type: getFetch */
2543
+
2544
+ /* Excluded from this release type: getQueryHandlerAndSelector */
2545
+
2546
+ /* Excluded from this release type: getReadableAsBuffer */
2547
+
2548
+ /* Excluded from this release type: getReadableFromProtocolStream */
2549
+
2903
2550
  /**
2904
- * @internal
2551
+ * @public
2905
2552
  */
2906
- export declare function getQueryHandlerAndSelector(selector: string): {
2907
- updatedSelector: string;
2908
- queryHandler: InternalQueryHandler;
2909
- };
2553
+ export declare type HandleFor<T> = T extends Node ? ElementHandle<T> : JSHandle<T>;
2554
+
2555
+ /**
2556
+ * @public
2557
+ */
2558
+ export declare type HandleOr<T> = HandleFor<T> | JSHandle<T> | T;
2910
2559
 
2911
2560
  /**
2912
2561
  * @public
@@ -2946,50 +2595,20 @@ export declare type Handler<T = any> = (event?: T) => void;
2946
2595
  * @public
2947
2596
  */
2948
2597
  export declare class HTTPRequest {
2598
+ #private;
2599
+ /* Excluded from this release type: _requestId */
2600
+ /* Excluded from this release type: _interceptionId */
2601
+ /* Excluded from this release type: _failureText */
2602
+ /* Excluded from this release type: _response */
2603
+ /* Excluded from this release type: _fromMemoryCache */
2604
+ /* Excluded from this release type: _redirectChain */
2949
2605
  /**
2950
- * @internal
2951
- */
2952
- _requestId: string;
2953
- /**
2954
- * @internal
2955
- */
2956
- _interceptionId: string;
2957
- /**
2958
- * @internal
2959
- */
2960
- _failureText: any;
2961
- /**
2962
- * @internal
2963
- */
2964
- _response: HTTPResponse | null;
2965
- /**
2966
- * @internal
2967
- */
2968
- _fromMemoryCache: boolean;
2969
- /**
2970
- * @internal
2971
- */
2972
- _redirectChain: HTTPRequest[];
2973
- private _client;
2974
- private _isNavigationRequest;
2975
- private _allowInterception;
2976
- private _interceptionHandled;
2977
- private _url;
2978
- private _resourceType;
2979
- private _method;
2980
- private _postData?;
2981
- private _headers;
2982
- private _frame;
2983
- private _continueRequestOverrides;
2984
- private _responseForRequest;
2985
- private _abortErrorReason;
2986
- private _interceptResolutionState;
2987
- private _interceptHandlers;
2988
- private _initiator;
2989
- /**
2990
- * @internal
2606
+ * Warning! Using this client can break Puppeteer. Use with caution.
2607
+ *
2608
+ * @experimental
2991
2609
  */
2992
- constructor(client: CDPSession_4, frame: Frame, interceptionId: string, allowInterception: boolean, event: Protocol.Network.RequestWillBeSentEvent, redirectChain: HTTPRequest[]);
2610
+ get client(): CDPSession_4;
2611
+ /* Excluded from this release type: __constructor */
2993
2612
  /**
2994
2613
  * @returns the URL of the request
2995
2614
  */
@@ -3083,7 +2702,7 @@ export declare class HTTPRequest {
3083
2702
  * For example, if the website `http://example.com` has a single redirect to
3084
2703
  * `https://example.com`, then the chain will contain one request:
3085
2704
  *
3086
- * ```js
2705
+ * ```ts
3087
2706
  * const response = await page.goto('http://example.com');
3088
2707
  * const chain = response.request().redirectChain();
3089
2708
  * console.log(chain.length); // 1
@@ -3092,7 +2711,7 @@ export declare class HTTPRequest {
3092
2711
  *
3093
2712
  * If the website `https://google.com` has no redirects, then the chain will be empty:
3094
2713
  *
3095
- * ```js
2714
+ * ```ts
3096
2715
  * const response = await page.goto('https://google.com');
3097
2716
  * const chain = response.request().redirectChain();
3098
2717
  * console.log(chain.length); // 0
@@ -3111,7 +2730,7 @@ export declare class HTTPRequest {
3111
2730
  *
3112
2731
  * Example of logging all failed requests:
3113
2732
  *
3114
- * ```js
2733
+ * ```ts
3115
2734
  * page.on('requestfailed', request => {
3116
2735
  * console.log(request.url() + ' ' + request.failure().errorText);
3117
2736
  * });
@@ -3136,7 +2755,7 @@ export declare class HTTPRequest {
3136
2755
  * Exception is immediately thrown if the request interception is not enabled.
3137
2756
  *
3138
2757
  * @example
3139
- * ```js
2758
+ * ```ts
3140
2759
  * await page.setRequestInterception(true);
3141
2760
  * page.on('request', request => {
3142
2761
  * // Override headers
@@ -3154,7 +2773,6 @@ export declare class HTTPRequest {
3154
2773
  * immediately.
3155
2774
  */
3156
2775
  continue(overrides?: ContinueRequestOverrides, priority?: number): Promise<void>;
3157
- private _continue;
3158
2776
  /**
3159
2777
  * Fulfills a request with the given response.
3160
2778
  *
@@ -3167,7 +2785,7 @@ export declare class HTTPRequest {
3167
2785
  *
3168
2786
  * @example
3169
2787
  * An example of fulfilling all requests with 404 responses:
3170
- * ```js
2788
+ * ```ts
3171
2789
  * await page.setRequestInterception(true);
3172
2790
  * page.on('request', request => {
3173
2791
  * request.respond({
@@ -3187,7 +2805,6 @@ export declare class HTTPRequest {
3187
2805
  * immediately.
3188
2806
  */
3189
2807
  respond(response: Partial<ResponseForRequest>, priority?: number): Promise<void>;
3190
- private _respond;
3191
2808
  /**
3192
2809
  * Aborts a request.
3193
2810
  *
@@ -3202,7 +2819,6 @@ export declare class HTTPRequest {
3202
2819
  * immediately.
3203
2820
  */
3204
2821
  abort(errorCode?: ErrorCode, priority?: number): Promise<void>;
3205
- private _abort;
3206
2822
  }
3207
2823
 
3208
2824
  /**
@@ -3212,32 +2828,9 @@ export declare class HTTPRequest {
3212
2828
  * @public
3213
2829
  */
3214
2830
  export declare class HTTPResponse {
3215
- private _client;
3216
- private _request;
3217
- private _contentPromise;
3218
- private _bodyLoadedPromise;
3219
- private _bodyLoadedPromiseFulfill;
3220
- private _remoteAddress;
3221
- private _status;
3222
- private _statusText;
3223
- private _url;
3224
- private _fromDiskCache;
3225
- private _fromServiceWorker;
3226
- private _headers;
3227
- private _securityDetails;
3228
- private _timing;
3229
- /**
3230
- * @internal
3231
- */
3232
- constructor(client: CDPSession_3, request: HTTPRequest, responsePayload: Protocol.Network.Response, extraInfo: Protocol.Network.ResponseReceivedExtraInfoEvent | null);
3233
- /**
3234
- * @internal
3235
- */
3236
- _parseStatusTextFromExtrInfo(extraInfo: Protocol.Network.ResponseReceivedExtraInfoEvent | null): string | undefined;
3237
- /**
3238
- * @internal
3239
- */
3240
- _resolveBody(err: Error | null): void;
2831
+ #private;
2832
+ /* Excluded from this release type: __constructor */
2833
+ /* Excluded from this release type: _resolveBody */
3241
2834
  /**
3242
2835
  * @returns The IP address and port number used to connect to the remote
3243
2836
  * server.
@@ -3312,6 +2905,15 @@ export declare class HTTPResponse {
3312
2905
  frame(): Frame | null;
3313
2906
  }
3314
2907
 
2908
+ /* Excluded from this release type: initializePuppeteer */
2909
+
2910
+ /**
2911
+ * @public
2912
+ */
2913
+ export declare type InnerParams<T extends unknown[]> = {
2914
+ [K in keyof T]: FlattenHandle<T[K]>;
2915
+ };
2916
+
3315
2917
  /**
3316
2918
  * @public
3317
2919
  */
@@ -3346,41 +2948,31 @@ export declare class HTTPResponse {
3346
2948
  offline: boolean;
3347
2949
  }
3348
2950
 
3349
- /**
3350
- * @internal
3351
- */
3352
- export declare interface InternalQueryHandler {
3353
- queryOne?: (element: ElementHandle, selector: string) => Promise<ElementHandle | null>;
3354
- waitFor?: (domWorld: DOMWorld, selector: string, options: WaitForSelectorOptions) => Promise<ElementHandle | null>;
3355
- queryAll?: (element: ElementHandle, selector: string) => Promise<ElementHandle[]>;
3356
- queryAllArray?: (element: ElementHandle, selector: string) => Promise<JSHandle>;
3357
- }
2951
+ /* Excluded from this release type: InternalQueryHandler */
3358
2952
 
3359
- /**
3360
- * @internal
3361
- */
3362
- export declare type IsPageTargetCallback = (target: Protocol.Target.TargetInfo) => boolean;
2953
+ /* Excluded from this release type: isErrnoException */
2954
+
2955
+ /* Excluded from this release type: isErrorLike */
2956
+
2957
+ /* Excluded from this release type: isNode */
2958
+
2959
+ /* Excluded from this release type: isNumber */
2960
+
2961
+ /* Excluded from this release type: IsPageTargetCallback */
2962
+
2963
+ /* Excluded from this release type: isString */
3363
2964
 
3364
2965
  /**
3365
2966
  * @public
3366
2967
  */
3367
2968
  export declare class JSCoverage {
3368
- _client: CDPSession;
3369
- _enabled: boolean;
3370
- _scriptURLs: Map<string, string>;
3371
- _scriptSources: Map<string, string>;
3372
- _eventListeners: PuppeteerEventListener[];
3373
- _resetOnNavigation: boolean;
3374
- _reportAnonymousScripts: boolean;
3375
- _includeRawScriptCoverage: boolean;
2969
+ #private;
3376
2970
  constructor(client: CDPSession);
3377
2971
  start(options?: {
3378
2972
  resetOnNavigation?: boolean;
3379
2973
  reportAnonymousScripts?: boolean;
3380
2974
  includeRawScriptCoverage?: boolean;
3381
2975
  }): Promise<void>;
3382
- _onExecutionContextsCleared(): void;
3383
- _onScriptParsed(event: Protocol.Debugger.ScriptParsedEvent): Promise<void>;
3384
2976
  stop(): Promise<JSCoverageEntry[]>;
3385
2977
  }
3386
2978
 
@@ -3419,7 +3011,7 @@ export declare class HTTPResponse {
3419
3011
  * {@link Page.evaluateHandle | page.evaluateHandle} method.
3420
3012
  *
3421
3013
  * @example
3422
- * ```js
3014
+ * ```ts
3423
3015
  * const windowHandle = await page.evaluateHandle(() => window);
3424
3016
  * ```
3425
3017
  *
@@ -3432,67 +3024,65 @@ export declare class HTTPResponse {
3432
3024
  *
3433
3025
  * @public
3434
3026
  */
3435
- export declare class JSHandle<HandleObjectType = unknown> {
3436
- /**
3437
- * @internal
3438
- */
3439
- _context: ExecutionContext;
3027
+ export declare class JSHandle<T = unknown> {
3028
+ #private;
3440
3029
  /**
3441
- * @internal
3030
+ * Used for nominally typing {@link JSHandle}.
3442
3031
  */
3443
- _client: CDPSession;
3444
- /**
3445
- * @internal
3446
- */
3447
- _remoteObject: Protocol.Runtime.RemoteObject;
3448
- /**
3449
- * @internal
3450
- */
3451
- _disposed: boolean;
3452
- /**
3453
- * @internal
3454
- */
3455
- constructor(context: ExecutionContext, client: CDPSession, remoteObject: Protocol.Runtime.RemoteObject);
3032
+ [__JSHandleSymbol]?: T;
3033
+ /* Excluded from this release type: _client */
3034
+ /* Excluded from this release type: _disposed */
3035
+ /* Excluded from this release type: _remoteObject */
3036
+ /* Excluded from this release type: _context */
3037
+ /* Excluded from this release type: __constructor */
3456
3038
  /** Returns the execution context the handle belongs to.
3457
3039
  */
3458
3040
  executionContext(): ExecutionContext;
3459
3041
  /**
3460
- * This method passes this handle as the first argument to `pageFunction`.
3461
- * If `pageFunction` returns a Promise, then `handle.evaluate` would wait
3462
- * for the promise to resolve and return its value.
3042
+ * This method passes this handle as the first argument to `pageFunction`. If
3043
+ * `pageFunction` returns a Promise, then `handle.evaluate` would wait for the
3044
+ * promise to resolve and return its value.
3463
3045
  *
3464
3046
  * @example
3465
- * ```js
3047
+ * ```ts
3466
3048
  * const tweetHandle = await page.$('.tweet .retweets');
3467
3049
  * expect(await tweetHandle.evaluate(node => node.innerText)).toBe('10');
3468
3050
  * ```
3469
3051
  */
3470
- evaluate<T extends EvaluateFn<HandleObjectType>>(pageFunction: T | string, ...args: SerializableOrJSHandle[]): Promise<UnwrapPromiseLike<EvaluateFnReturnType<T>>>;
3052
+ evaluate<Params extends unknown[], Func extends EvaluateFunc<[this, ...Params]> = EvaluateFunc<[
3053
+ this,
3054
+ ...Params
3055
+ ]>>(pageFunction: Func | string, ...args: Params): Promise<Awaited<ReturnType<Func>>>;
3471
3056
  /**
3472
3057
  * This method passes this handle as the first argument to `pageFunction`.
3473
3058
  *
3474
3059
  * @remarks
3475
3060
  *
3476
3061
  * The only difference between `jsHandle.evaluate` and
3477
- * `jsHandle.evaluateHandle` is that `jsHandle.evaluateHandle`
3478
- * returns an in-page object (JSHandle).
3062
+ * `jsHandle.evaluateHandle` is that `jsHandle.evaluateHandle` returns an
3063
+ * in-page object (JSHandle).
3479
3064
  *
3480
- * If the function passed to `jsHandle.evaluateHandle` returns a Promise,
3481
- * then `evaluateHandle.evaluateHandle` waits for the promise to resolve and
3065
+ * If the function passed to `jsHandle.evaluateHandle` returns a Promise, then
3066
+ * `evaluateHandle.evaluateHandle` waits for the promise to resolve and
3482
3067
  * returns its value.
3483
3068
  *
3484
3069
  * See {@link Page.evaluateHandle} for more details.
3485
3070
  */
3486
- evaluateHandle<HandleType extends JSHandle = JSHandle>(pageFunction: EvaluateHandleFn, ...args: SerializableOrJSHandle[]): Promise<HandleType>;
3487
- /** Fetches a single property from the referenced object.
3071
+ evaluateHandle<Params extends unknown[], Func extends EvaluateFunc<[this, ...Params]> = EvaluateFunc<[
3072
+ this,
3073
+ ...Params
3074
+ ]>>(pageFunction: Func | string, ...args: Params): Promise<HandleFor<Awaited<ReturnType<Func>>>>;
3075
+ /**
3076
+ * Fetches a single property from the referenced object.
3488
3077
  */
3489
- getProperty(propertyName: string): Promise<JSHandle>;
3078
+ getProperty<K extends keyof T>(propertyName: HandleOr<K>): Promise<HandleFor<T[K]>>;
3079
+ getProperty(propertyName: string): Promise<JSHandle<unknown>>;
3490
3080
  /**
3491
- * The method returns a map with property names as keys and JSHandle
3492
- * instances for the property values.
3081
+ * The method returns a map with property names as keys and JSHandle instances
3082
+ * for the property values.
3493
3083
  *
3494
3084
  * @example
3495
- * ```js
3085
+ * ```ts
3496
3086
  * const listHandle = await page.evaluateHandle(() => document.body.children);
3497
3087
  * const properties = await listHandle.getProperties();
3498
3088
  * const children = [];
@@ -3519,7 +3109,7 @@ export declare class HTTPResponse {
3519
3109
  * @returns Either `null` or the object handle itself, if the object
3520
3110
  * handle is an instance of {@link ElementHandle}.
3521
3111
  */
3522
- asElement(): ElementHandle | null;
3112
+ asElement(): ElementHandle<Node> | null;
3523
3113
  /**
3524
3114
  * Stops referencing the element handle, and resolves when the object handle is
3525
3115
  * successfully disposed of.
@@ -3533,18 +3123,6 @@ export declare class HTTPResponse {
3533
3123
  toString(): string;
3534
3124
  }
3535
3125
 
3536
- /**
3537
- * @public
3538
- */
3539
- export declare type JSONArray = readonly Serializable[];
3540
-
3541
- /**
3542
- * @public
3543
- */
3544
- export declare interface JSONObject {
3545
- [key: string]: Serializable;
3546
- }
3547
-
3548
3126
  /**
3549
3127
  * Keyboard provides an api for managing a virtual keyboard.
3550
3128
  * The high level api is {@link Keyboard."type"},
@@ -3561,7 +3139,7 @@ export declare class HTTPResponse {
3561
3139
  *
3562
3140
  * @example
3563
3141
  * An example of holding down `Shift` in order to select and delete some text:
3564
- * ```js
3142
+ * ```ts
3565
3143
  * await page.keyboard.type('Hello World!');
3566
3144
  * await page.keyboard.press('ArrowLeft');
3567
3145
  *
@@ -3576,7 +3154,7 @@ export declare class HTTPResponse {
3576
3154
  *
3577
3155
  * @example
3578
3156
  * An example of pressing `A`
3579
- * ```js
3157
+ * ```ts
3580
3158
  * await page.keyboard.down('Shift');
3581
3159
  * await page.keyboard.press('KeyA');
3582
3160
  * await page.keyboard.up('Shift');
@@ -3585,12 +3163,9 @@ export declare class HTTPResponse {
3585
3163
  * @public
3586
3164
  */
3587
3165
  export declare class Keyboard {
3588
- private _client;
3589
- /** @internal */
3590
- _modifiers: number;
3591
- private _pressedKeys;
3592
- /** @internal */
3593
- constructor(client: CDPSession);
3166
+ #private;
3167
+ /* Excluded from this release type: _modifiers */
3168
+ /* Excluded from this release type: __constructor */
3594
3169
  /**
3595
3170
  * Dispatches a `keydown` event.
3596
3171
  *
@@ -3619,8 +3194,6 @@ export declare class HTTPResponse {
3619
3194
  down(key: KeyInput, options?: {
3620
3195
  text?: string;
3621
3196
  }): Promise<void>;
3622
- private _modifierBit;
3623
- private _keyDescriptionForString;
3624
3197
  /**
3625
3198
  * Dispatches a `keyup` event.
3626
3199
  *
@@ -3638,7 +3211,7 @@ export declare class HTTPResponse {
3638
3211
  * Holding down `Shift` will not type the text in upper case.
3639
3212
  *
3640
3213
  * @example
3641
- * ```js
3214
+ * ```ts
3642
3215
  * page.keyboard.sendCharacter('嗨');
3643
3216
  * ```
3644
3217
  *
@@ -3658,7 +3231,7 @@ export declare class HTTPResponse {
3658
3231
  * Holding down `Shift` will not type the text in upper case.
3659
3232
  *
3660
3233
  * @example
3661
- * ```js
3234
+ * ```ts
3662
3235
  * await page.keyboard.type('Hello'); // Types instantly
3663
3236
  * await page.keyboard.type('World', {delay: 100}); // Types slower, like a user
3664
3237
  * ```
@@ -3697,39 +3270,9 @@ export declare class HTTPResponse {
3697
3270
  }): Promise<void>;
3698
3271
  }
3699
3272
 
3700
- /**
3701
- * Copyright 2017 Google Inc. All rights reserved.
3702
- *
3703
- * Licensed under the Apache License, Version 2.0 (the 'License');
3704
- * you may not use this file except in compliance with the License.
3705
- * You may obtain a copy of the License at
3706
- *
3707
- * http://www.apache.org/licenses/LICENSE-2.0
3708
- *
3709
- * Unless required by applicable law or agreed to in writing, software
3710
- * distributed under the License is distributed on an 'AS IS' BASIS,
3711
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
3712
- * See the License for the specific language governing permissions and
3713
- * limitations under the License.
3714
- */
3715
- /**
3716
- * @internal
3717
- */
3718
- export declare interface KeyDefinition {
3719
- keyCode?: number;
3720
- shiftKeyCode?: number;
3721
- key?: string;
3722
- shiftKey?: string;
3723
- code?: string;
3724
- text?: string;
3725
- shiftText?: string;
3726
- location?: number;
3727
- }
3273
+ /* Excluded from this release type: KeyDefinition */
3728
3274
 
3729
- /**
3730
- * @internal
3731
- */
3732
- export declare const keyDefinitions: Readonly<Record<KeyInput, KeyDefinition>>;
3275
+ /* Excluded from this release type: _keyDefinitions */
3733
3276
 
3734
3277
  /**
3735
3278
  * All the valid keys that can be passed to functions that take user input, such
@@ -3739,14 +3282,7 @@ export declare class HTTPResponse {
3739
3282
  */
3740
3283
  export declare type KeyInput = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | 'Power' | 'Eject' | 'Abort' | 'Help' | 'Backspace' | 'Tab' | 'Numpad5' | 'NumpadEnter' | 'Enter' | '\r' | '\n' | 'ShiftLeft' | 'ShiftRight' | 'ControlLeft' | 'ControlRight' | 'AltLeft' | 'AltRight' | 'Pause' | 'CapsLock' | 'Escape' | 'Convert' | 'NonConvert' | 'Space' | 'Numpad9' | 'PageUp' | 'Numpad3' | 'PageDown' | 'End' | 'Numpad1' | 'Home' | 'Numpad7' | 'ArrowLeft' | 'Numpad4' | 'Numpad8' | 'ArrowUp' | 'ArrowRight' | 'Numpad6' | 'Numpad2' | 'ArrowDown' | 'Select' | 'Open' | 'PrintScreen' | 'Insert' | 'Numpad0' | 'Delete' | 'NumpadDecimal' | 'Digit0' | 'Digit1' | 'Digit2' | 'Digit3' | 'Digit4' | 'Digit5' | 'Digit6' | 'Digit7' | 'Digit8' | 'Digit9' | 'KeyA' | 'KeyB' | 'KeyC' | 'KeyD' | 'KeyE' | 'KeyF' | 'KeyG' | 'KeyH' | 'KeyI' | 'KeyJ' | 'KeyK' | 'KeyL' | 'KeyM' | 'KeyN' | 'KeyO' | 'KeyP' | 'KeyQ' | 'KeyR' | 'KeyS' | 'KeyT' | 'KeyU' | 'KeyV' | 'KeyW' | 'KeyX' | 'KeyY' | 'KeyZ' | 'MetaLeft' | 'MetaRight' | 'ContextMenu' | 'NumpadMultiply' | 'NumpadAdd' | 'NumpadSubtract' | 'NumpadDivide' | 'F1' | 'F2' | 'F3' | 'F4' | 'F5' | 'F6' | 'F7' | 'F8' | 'F9' | 'F10' | 'F11' | 'F12' | 'F13' | 'F14' | 'F15' | 'F16' | 'F17' | 'F18' | 'F19' | 'F20' | 'F21' | 'F22' | 'F23' | 'F24' | 'NumLock' | 'ScrollLock' | 'AudioVolumeMute' | 'AudioVolumeDown' | 'AudioVolumeUp' | 'MediaTrackNext' | 'MediaTrackPrevious' | 'MediaStop' | 'MediaPlayPause' | 'Semicolon' | 'Equal' | 'NumpadEqual' | 'Comma' | 'Minus' | 'Period' | 'Slash' | 'Backquote' | 'BracketLeft' | 'Backslash' | 'BracketRight' | 'Quote' | 'AltGraph' | 'Props' | 'Cancel' | 'Clear' | 'Shift' | 'Control' | 'Alt' | 'Accept' | 'ModeChange' | ' ' | 'Print' | 'Execute' | '\u0000' | 'a' | 'b' | 'c' | 'd' | 'e' | 'f' | 'g' | 'h' | 'i' | 'j' | 'k' | 'l' | 'm' | 'n' | 'o' | 'p' | 'q' | 'r' | 's' | 't' | 'u' | 'v' | 'w' | 'x' | 'y' | 'z' | 'Meta' | '*' | '+' | '-' | '/' | ';' | '=' | ',' | '.' | '`' | '[' | '\\' | ']' | "'" | 'Attn' | 'CrSel' | 'ExSel' | 'EraseEof' | 'Play' | 'ZoomOut' | ')' | '!' | '@' | '#' | '$' | '%' | '^' | '&' | '(' | 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M' | 'N' | 'O' | 'P' | 'Q' | 'R' | 'S' | 'T' | 'U' | 'V' | 'W' | 'X' | 'Y' | 'Z' | ':' | '<' | '_' | '>' | '?' | '~' | '{' | '|' | '}' | '"' | 'SoftLeft' | 'SoftRight' | 'Camera' | 'Call' | 'EndCall' | 'VolumeDown' | 'VolumeUp';
3741
3284
 
3742
- /**
3743
- * @public
3744
- * {@inheritDoc PuppeteerNode.launch}
3745
- */
3746
- export declare function launch(options?: LaunchOptions & BrowserLaunchArgumentOptions & BrowserConnectOptions & {
3747
- product?: Product;
3748
- extraPrefsFirefox?: Record<string, unknown>;
3749
- }): Promise<Browser>;
3285
+ export declare const launch: (options?: PuppeteerLaunchOptions) => Promise<Browser>;
3750
3286
 
3751
3287
  /**
3752
3288
  * Generic launch options that can be passed when launching any browser.
@@ -3824,46 +3360,16 @@ export declare class HTTPResponse {
3824
3360
  waitForInitialPage?: boolean;
3825
3361
  }
3826
3362
 
3363
+ /* Excluded from this release type: LifecycleWatcher */
3364
+
3365
+ /* Excluded from this release type: logPolitely */
3366
+
3827
3367
  /**
3828
- * @internal
3829
- */
3830
- export declare class LifecycleWatcher {
3831
- _expectedLifecycle: ProtocolLifeCycleEvent[];
3832
- _frameManager: FrameManager;
3833
- _frame: Frame;
3834
- _timeout: number;
3835
- _navigationRequest?: HTTPRequest;
3836
- _eventListeners: PuppeteerEventListener[];
3837
- _initialLoaderId: string;
3838
- _sameDocumentNavigationPromise: Promise<Error | null>;
3839
- _sameDocumentNavigationCompleteCallback: (x?: Error) => void;
3840
- _lifecyclePromise: Promise<void>;
3841
- _lifecycleCallback: () => void;
3842
- _newDocumentNavigationPromise: Promise<Error | null>;
3843
- _newDocumentNavigationCompleteCallback: (x?: Error) => void;
3844
- _terminationPromise: Promise<Error | null>;
3845
- _terminationCallback: (x?: Error) => void;
3846
- _timeoutPromise: Promise<TimeoutError | null>;
3847
- _maximumTimer?: NodeJS.Timeout;
3848
- _hasSameDocumentNavigation?: boolean;
3849
- _swapped?: boolean;
3850
- constructor(frameManager: FrameManager, frame: Frame, waitUntil: PuppeteerLifeCycleEvent | PuppeteerLifeCycleEvent[], timeout: number);
3851
- _onRequest(request: HTTPRequest): void;
3852
- _onFrameDetached(frame: Frame): void;
3853
- navigationResponse(): Promise<HTTPResponse | null>;
3854
- _terminate(error: Error): void;
3855
- sameDocumentNavigationPromise(): Promise<Error | null>;
3856
- newDocumentNavigationPromise(): Promise<Error | null>;
3857
- lifecyclePromise(): Promise<void>;
3858
- timeoutOrTerminationPromise(): Promise<Error | TimeoutError | null>;
3859
- _createTimeoutPromise(): Promise<TimeoutError | null>;
3860
- _navigatedWithinDocument(frame: Frame): void;
3861
- _frameSwapped(frame: Frame): void;
3862
- _checkLifecycleComplete(): void;
3863
- dispose(): void;
3864
- }
3368
+ * @public
3369
+ */
3370
+ export declare type LowerCasePaperFormat = 'letter' | 'legal' | 'tabloid' | 'ledger' | 'a0' | 'a1' | 'a2' | 'a3' | 'a4' | 'a5' | 'a6';
3865
3371
 
3866
- declare type LowerCasePaperFormat = 'letter' | 'legal' | 'tabloid' | 'ledger' | 'a0' | 'a1' | 'a2' | 'a3' | 'a4' | 'a5' | 'a6';
3372
+ /* Excluded from this release type: makePredicateString */
3867
3373
 
3868
3374
  /**
3869
3375
  * @public
@@ -3899,7 +3405,7 @@ export declare class HTTPResponse {
3899
3405
  * Every `page` object has its own Mouse, accessible with [`page.mouse`](#pagemouse).
3900
3406
  *
3901
3407
  * @example
3902
- * ```js
3408
+ * ```ts
3903
3409
  * // Using ‘page.mouse’ to trace a 100x100 square.
3904
3410
  * await page.mouse.move(0, 0);
3905
3411
  * await page.mouse.down();
@@ -3919,7 +3425,7 @@ export declare class HTTPResponse {
3919
3425
  *
3920
3426
  * @example
3921
3427
  * For example, if you want to select all content between nodes:
3922
- * ```js
3428
+ * ```ts
3923
3429
  * await page.evaluate((from, to) => {
3924
3430
  * const selection = from.getRootNode().getSelection();
3925
3431
  * const range = document.createRange();
@@ -3930,7 +3436,7 @@ export declare class HTTPResponse {
3930
3436
  * }, fromJSHandle, toJSHandle);
3931
3437
  * ```
3932
3438
  * If you then would want to copy-paste your selection, you can use the clipboard api:
3933
- * ```js
3439
+ * ```ts
3934
3440
  * // The clipboard api does not allow you to copy, unless the tab is focused.
3935
3441
  * await page.bringToFront();
3936
3442
  * await page.evaluate(() => {
@@ -3942,7 +3448,7 @@ export declare class HTTPResponse {
3942
3448
  * ```
3943
3449
  * **Note**: If you want access to the clipboard API,
3944
3450
  * you have to give it permission to do so:
3945
- * ```js
3451
+ * ```ts
3946
3452
  * await browser.defaultBrowserContext().overridePermissions(
3947
3453
  * '<your origin>', ['clipboard-read', 'clipboard-write']
3948
3454
  * );
@@ -3950,15 +3456,8 @@ export declare class HTTPResponse {
3950
3456
  * @public
3951
3457
  */
3952
3458
  export declare class Mouse {
3953
- private _client;
3954
- private _keyboard;
3955
- private _x;
3956
- private _y;
3957
- private _button;
3958
- /**
3959
- * @internal
3960
- */
3961
- constructor(client: CDPSession, keyboard: Keyboard);
3459
+ #private;
3460
+ /* Excluded from this release type: __constructor */
3962
3461
  /**
3963
3462
  * Dispatches a `mousemove` event.
3964
3463
  * @param x - Horizontal position of the mouse.
@@ -3994,7 +3493,7 @@ export declare class HTTPResponse {
3994
3493
  *
3995
3494
  * @example
3996
3495
  * An example of zooming into an element:
3997
- * ```js
3496
+ * ```ts
3998
3497
  * await page.goto('https://mdn.mozillademos.org/en-US/docs/Web/API/Element/wheel_event$samples/Scaling_an_element_via_the_wheel?revision=1587366');
3999
3498
  *
4000
3499
  * const elem = await page.$('div');
@@ -4076,113 +3575,48 @@ export declare class HTTPResponse {
4076
3575
  }
4077
3576
 
4078
3577
  /**
3578
+ * A list of network conditions to be used with
3579
+ * `page.emulateNetworkConditions(networkConditions)`. Actual list of predefined
3580
+ * conditions can be found in
3581
+ * {@link https://github.com/puppeteer/puppeteer/blob/main/src/common/NetworkConditions.ts | src/common/NetworkConditions.ts}.
3582
+ *
3583
+ * @example
3584
+ *
3585
+ * ```ts
3586
+ * const puppeteer = require('puppeteer');
3587
+ * const slow3G = puppeteer.networkConditions['Slow 3G'];
3588
+ *
3589
+ * (async () => {
3590
+ * const browser = await puppeteer.launch();
3591
+ * const page = await browser.newPage();
3592
+ * await page.emulateNetworkConditions(slow3G);
3593
+ * await page.goto('https://www.google.com');
3594
+ * // other actions...
3595
+ * await browser.close();
3596
+ * })();
3597
+ * ```
3598
+ *
4079
3599
  * @public
4080
3600
  */
4081
- export declare let networkConditions: PredefinedNetworkConditions;
4082
-
4083
- /**
4084
- * @internal
4085
- *
4086
- * Helper class to track network events by request ID
4087
- */
4088
- declare class NetworkEventManager {
4089
- private _requestWillBeSentMap;
4090
- private _requestPausedMap;
4091
- private _httpRequestsMap;
4092
- private _responseReceivedExtraInfoMap;
4093
- private _queuedRedirectInfoMap;
4094
- private _queuedEventGroupMap;
4095
- forget(networkRequestId: NetworkRequestId): void;
4096
- responseExtraInfo(networkRequestId: NetworkRequestId): Protocol.Network.ResponseReceivedExtraInfoEvent[];
4097
- private queuedRedirectInfo;
4098
- queueRedirectInfo(fetchRequestId: FetchRequestId, redirectInfo: RedirectInfo): void;
4099
- takeQueuedRedirectInfo(fetchRequestId: FetchRequestId): RedirectInfo | undefined;
4100
- numRequestsInProgress(): number;
4101
- storeRequestWillBeSent(networkRequestId: NetworkRequestId, event: Protocol.Network.RequestWillBeSentEvent): void;
4102
- getRequestWillBeSent(networkRequestId: NetworkRequestId): Protocol.Network.RequestWillBeSentEvent | undefined;
4103
- forgetRequestWillBeSent(networkRequestId: NetworkRequestId): void;
4104
- getRequestPaused(networkRequestId: NetworkRequestId): Protocol.Fetch.RequestPausedEvent | undefined;
4105
- forgetRequestPaused(networkRequestId: NetworkRequestId): void;
4106
- storeRequestPaused(networkRequestId: NetworkRequestId, event: Protocol.Fetch.RequestPausedEvent): void;
4107
- getRequest(networkRequestId: NetworkRequestId): HTTPRequest | undefined;
4108
- storeRequest(networkRequestId: NetworkRequestId, request: HTTPRequest): void;
4109
- forgetRequest(networkRequestId: NetworkRequestId): void;
4110
- getQueuedEventGroup(networkRequestId: NetworkRequestId): QueuedEventGroup | undefined;
4111
- queueEventGroup(networkRequestId: NetworkRequestId, event: QueuedEventGroup): void;
4112
- forgetQueuedEventGroup(networkRequestId: NetworkRequestId): void;
4113
- }
3601
+ export declare const networkConditions: Readonly<{
3602
+ 'Slow 3G': NetworkConditions;
3603
+ 'Fast 3G': NetworkConditions;
3604
+ }>;
4114
3605
 
4115
- /**
4116
- * @internal
4117
- */
4118
- export declare class NetworkManager extends EventEmitter {
4119
- _client: CDPSession_2;
4120
- _ignoreHTTPSErrors: boolean;
4121
- _frameManager: FrameManager_2;
4122
- _networkEventManager: NetworkEventManager;
4123
- _extraHTTPHeaders: Record<string, string>;
4124
- _credentials?: Credentials;
4125
- _attemptedAuthentications: Set<string>;
4126
- _userRequestInterceptionEnabled: boolean;
4127
- _protocolRequestInterceptionEnabled: boolean;
4128
- _userCacheDisabled: boolean;
4129
- _emulatedNetworkConditions: InternalNetworkConditions;
4130
- constructor(client: CDPSession_2, ignoreHTTPSErrors: boolean, frameManager: FrameManager_2);
4131
- initialize(): Promise<void>;
4132
- authenticate(credentials?: Credentials): Promise<void>;
4133
- setExtraHTTPHeaders(extraHTTPHeaders: Record<string, string>): Promise<void>;
4134
- extraHTTPHeaders(): Record<string, string>;
4135
- numRequestsInProgress(): number;
4136
- setOfflineMode(value: boolean): Promise<void>;
4137
- emulateNetworkConditions(networkConditions: NetworkConditions | null): Promise<void>;
4138
- _updateNetworkConditions(): Promise<void>;
4139
- setUserAgent(userAgent: string, userAgentMetadata?: Protocol.Emulation.UserAgentMetadata): Promise<void>;
4140
- setCacheEnabled(enabled: boolean): Promise<void>;
4141
- setRequestInterception(value: boolean): Promise<void>;
4142
- _updateProtocolRequestInterception(): Promise<void>;
4143
- _cacheDisabled(): boolean;
4144
- _updateProtocolCacheDisabled(): Promise<void>;
4145
- _onRequestWillBeSent(event: Protocol.Network.RequestWillBeSentEvent): void;
4146
- _onAuthRequired(event: Protocol.Fetch.AuthRequiredEvent): void;
4147
- /**
4148
- * CDP may send a Fetch.requestPaused without or before a
4149
- * Network.requestWillBeSent
4150
- *
4151
- * CDP may send multiple Fetch.requestPaused
4152
- * for the same Network.requestWillBeSent.
4153
- *
4154
- *
4155
- */
4156
- _onRequestPaused(event: Protocol.Fetch.RequestPausedEvent): void;
4157
- _patchRequestEventHeaders(requestWillBeSentEvent: Protocol.Network.RequestWillBeSentEvent, requestPausedEvent: Protocol.Fetch.RequestPausedEvent): void;
4158
- _onRequest(event: Protocol.Network.RequestWillBeSentEvent, fetchRequestId?: FetchRequestId): void;
4159
- _onRequestServedFromCache(event: Protocol.Network.RequestServedFromCacheEvent): void;
4160
- _handleRequestRedirect(request: HTTPRequest, responsePayload: Protocol.Network.Response, extraInfo: Protocol.Network.ResponseReceivedExtraInfoEvent): void;
4161
- _emitResponseEvent(responseReceived: Protocol.Network.ResponseReceivedEvent, extraInfo: Protocol.Network.ResponseReceivedExtraInfoEvent | null): void;
4162
- _onResponseReceived(event: Protocol.Network.ResponseReceivedEvent): void;
4163
- _onResponseReceivedExtraInfo(event: Protocol.Network.ResponseReceivedExtraInfoEvent): void;
4164
- _forgetRequest(request: HTTPRequest, events: boolean): void;
4165
- _onLoadingFinished(event: Protocol.Network.LoadingFinishedEvent): void;
4166
- _emitLoadingFinished(event: Protocol.Network.LoadingFinishedEvent): void;
4167
- _onLoadingFailed(event: Protocol.Network.LoadingFailedEvent): void;
4168
- _emitLoadingFailed(event: Protocol.Network.LoadingFailedEvent): void;
4169
- }
3606
+ /* Excluded from this release type: NetworkEventManager */
3607
+
3608
+ /* Excluded from this release type: NetworkManager */
3609
+
3610
+ /* Excluded from this release type: NetworkManagerEmittedEvents */
3611
+
3612
+ /* Excluded from this release type: NetworkRequestId */
4170
3613
 
4171
3614
  /**
4172
- * We use symbols to prevent any external parties listening to these events.
4173
- * They are internal to Puppeteer.
4174
- *
4175
- * @internal
3615
+ * @public
4176
3616
  */
4177
- export declare const NetworkManagerEmittedEvents: {
4178
- readonly Request: symbol;
4179
- readonly RequestServedFromCache: symbol;
4180
- readonly Response: symbol;
4181
- readonly RequestFailed: symbol;
4182
- readonly RequestFinished: symbol;
4183
- };
3617
+ export declare type NodeFor<Selector extends string> = Selector extends keyof HTMLElementTagNameMap ? HTMLElementTagNameMap[Selector] : Selector extends keyof SVGElementTagNameMap ? SVGElementTagNameMap[Selector] : Element;
4184
3618
 
4185
- declare type NetworkRequestId = string;
3619
+ /* Excluded from this release type: NodeWebSocketTransport */
4186
3620
 
4187
3621
  /**
4188
3622
  * @public
@@ -4198,17 +3632,22 @@ export declare class HTTPResponse {
4198
3632
  y: number;
4199
3633
  }
4200
3634
 
3635
+ /* Excluded from this release type: packageVersion */
3636
+
4201
3637
  /**
4202
3638
  * Page provides methods to interact with a single tab or
4203
- * {@link https://developer.chrome.com/extensions/background_pages | extension background page} in Chromium.
3639
+ * {@link https://developer.chrome.com/extensions/background_pages | extension background page}
3640
+ * in Chromium.
4204
3641
  *
4205
- * @remarks
3642
+ * :::note
4206
3643
  *
4207
3644
  * One Browser instance might have multiple Page instances.
4208
3645
  *
3646
+ * :::
3647
+ *
4209
3648
  * @example
4210
- * This example creates a page, navigates it to a URL, and then * saves a screenshot:
4211
- * ```js
3649
+ * This example creates a page, navigates it to a URL, and then saves a screenshot:
3650
+ * ```ts
4212
3651
  * const puppeteer = require('puppeteer');
4213
3652
  *
4214
3653
  * (async () => {
@@ -4225,13 +3664,13 @@ export declare class HTTPResponse {
4225
3664
  *
4226
3665
  * @example
4227
3666
  * This example logs a message for a single page `load` event:
4228
- * ```js
3667
+ * ```ts
4229
3668
  * page.once('load', () => console.log('Page loaded!'));
4230
3669
  * ```
4231
3670
  *
4232
- * To unsubscribe from events use the `off` method:
3671
+ * To unsubscribe from events use the {@link Page.off} method:
4233
3672
  *
4234
- * ```js
3673
+ * ```ts
4235
3674
  * function logRequest(interceptedRequest) {
4236
3675
  * console.log('A request was made:', interceptedRequest.url());
4237
3676
  * }
@@ -4239,40 +3678,13 @@ export declare class HTTPResponse {
4239
3678
  * // Sometime later...
4240
3679
  * page.off('request', logRequest);
4241
3680
  * ```
3681
+ *
4242
3682
  * @public
4243
3683
  */
4244
3684
  export declare class Page extends EventEmitter {
4245
- /**
4246
- * @internal
4247
- */
4248
- static create(client: CDPSession, target: Target, ignoreHTTPSErrors: boolean, defaultViewport: Viewport | null, screenshotTaskQueue: TaskQueue): Promise<Page>;
4249
- private _closed;
4250
- private _client;
4251
- private _target;
4252
- private _keyboard;
4253
- private _mouse;
4254
- private _timeoutSettings;
4255
- private _touchscreen;
4256
- private _accessibility;
4257
- private _frameManager;
4258
- private _emulationManager;
4259
- private _tracing;
4260
- private _pageBindings;
4261
- private _coverage;
4262
- private _javascriptEnabled;
4263
- private _viewport;
4264
- private _screenshotTaskQueue;
4265
- private _workers;
4266
- private _fileChooserInterceptors;
4267
- private _disconnectPromise?;
4268
- private _userDragInterceptionEnabled;
4269
- private _handlerMap;
4270
- /**
4271
- * @internal
4272
- */
4273
- constructor(client: CDPSession, target: Target, ignoreHTTPSErrors: boolean, screenshotTaskQueue: TaskQueue);
4274
- private _initialize;
4275
- private _onFileChooser;
3685
+ #private;
3686
+ /* Excluded from this release type: _create */
3687
+ /* Excluded from this release type: __constructor */
4276
3688
  /**
4277
3689
  * @returns `true` if drag events are being intercepted, `false` otherwise.
4278
3690
  */
@@ -4283,16 +3695,38 @@ export declare class HTTPResponse {
4283
3695
  isJavaScriptEnabled(): boolean;
4284
3696
  /**
4285
3697
  * Listen to page events.
3698
+ *
3699
+ * :::note
3700
+ *
3701
+ * This method exists to define event typings and handle proper wireup of
3702
+ * cooperative request interception. Actual event listening and dispatching is
3703
+ * delegated to {@link EventEmitter}.
3704
+ *
3705
+ * :::
4286
3706
  */
4287
3707
  on<K extends keyof PageEventObject>(eventName: K, handler: (event: PageEventObject[K]) => void): EventEmitter;
4288
3708
  once<K extends keyof PageEventObject>(eventName: K, handler: (event: PageEventObject[K]) => void): EventEmitter;
4289
3709
  off<K extends keyof PageEventObject>(eventName: K, handler: (event: PageEventObject[K]) => void): EventEmitter;
4290
3710
  /**
4291
3711
  * This method is typically coupled with an action that triggers file
4292
- * choosing. The following example clicks a button that issues a file chooser
3712
+ * choosing.
3713
+ *
3714
+ * :::caution
3715
+ *
3716
+ * This must be called before the file chooser is launched. It will not return
3717
+ * a currently active file chooser.
3718
+ *
3719
+ * :::
3720
+ *
3721
+ * @remarks
3722
+ * In non-headless Chromium, this method results in the native file picker
3723
+ * dialog `not showing up` for the user.
3724
+ *
3725
+ * @example
3726
+ * The following example clicks a button that issues a file chooser
4293
3727
  * and then responds with `/tmp/myfile.pdf` as if a user has selected this file.
4294
3728
  *
4295
- * ```js
3729
+ * ```ts
4296
3730
  * const [fileChooser] = await Promise.all([
4297
3731
  * page.waitForFileChooser(),
4298
3732
  * page.click('#upload-file-button'),
@@ -4300,14 +3734,6 @@ export declare class HTTPResponse {
4300
3734
  * ]);
4301
3735
  * await fileChooser.accept(['/tmp/myfile.pdf']);
4302
3736
  * ```
4303
- *
4304
- * NOTE: This must be called before the file chooser is launched. It will not
4305
- * return a currently active file chooser.
4306
- * @param options - Optional waiting parameters
4307
- * @returns Resolves after a page requests a file picker.
4308
- * @remarks
4309
- * NOTE: In non-headless Chromium, this method results in the native file picker
4310
- * dialog `not showing up` for the user.
4311
3737
  */
4312
3738
  waitForFileChooser(options?: WaitTimeoutOptions): Promise<FileChooser>;
4313
3739
  /**
@@ -4316,7 +3742,7 @@ export declare class HTTPResponse {
4316
3742
  * NOTE: Consider using {@link BrowserContext.overridePermissions} to grant
4317
3743
  * permissions for the page to read its geolocation.
4318
3744
  * @example
4319
- * ```js
3745
+ * ```ts
4320
3746
  * await page.setGeolocation({latitude: 59.95, longitude: 30.31667});
4321
3747
  * ```
4322
3748
  */
@@ -4325,11 +3751,7 @@ export declare class HTTPResponse {
4325
3751
  * @returns A target this page was created from.
4326
3752
  */
4327
3753
  target(): Target;
4328
- /**
4329
- * Get the CDP session client the page belongs to.
4330
- * @internal
4331
- */
4332
- client(): CDPSession;
3754
+ /* Excluded from this release type: _client */
4333
3755
  /**
4334
3756
  * Get the browser the page belongs to.
4335
3757
  */
@@ -4338,8 +3760,6 @@ export declare class HTTPResponse {
4338
3760
  * Get the browser context that the page belongs to.
4339
3761
  */
4340
3762
  browserContext(): BrowserContext;
4341
- private _onTargetCrashed;
4342
- private _onLogEntryAdded;
4343
3763
  /**
4344
3764
  * @returns The page's main frame.
4345
3765
  * @remarks
@@ -4377,7 +3797,7 @@ export declare class HTTPResponse {
4377
3797
  *
4378
3798
  * @example
4379
3799
  * An example of a naïve request interceptor that aborts all image requests:
4380
- * ```js
3800
+ * ```ts
4381
3801
  * const puppeteer = require('puppeteer');
4382
3802
  * (async () => {
4383
3803
  * const browser = await puppeteer.launch();
@@ -4417,7 +3837,7 @@ export declare class HTTPResponse {
4417
3837
  /**
4418
3838
  * @param networkConditions - Passing `null` disables network condition emulation.
4419
3839
  * @example
4420
- * ```js
3840
+ * ```ts
4421
3841
  * const puppeteer = require('puppeteer');
4422
3842
  * const slow3G = puppeteer.networkConditions['Slow 3G'];
4423
3843
  *
@@ -4462,14 +3882,19 @@ export declare class HTTPResponse {
4462
3882
  * Runs `document.querySelector` within the page. If no element matches the
4463
3883
  * selector, the return value resolves to `null`.
4464
3884
  *
4465
- * @remarks
4466
- * Shortcut for {@link Frame.$ | Page.mainFrame().$(selector) }.
4467
- *
4468
3885
  * @param selector - A `selector` to query page for
4469
3886
  * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors | selector}
4470
3887
  * to query page for.
4471
3888
  */
4472
- $<T extends Element = Element>(selector: string): Promise<ElementHandle<T> | null>;
3889
+ $<Selector extends string>(selector: Selector): Promise<ElementHandle<NodeFor<Selector>> | null>;
3890
+ /**
3891
+ * The method runs `document.querySelectorAll` within the page. If no elements
3892
+ * match the selector, the return value resolves to `[]`.
3893
+ * @remarks
3894
+ * Shortcut for {@link Frame.$$ | Page.mainFrame().$$(selector) }.
3895
+ * @param selector - A `selector` to query page for
3896
+ */
3897
+ $$<Selector extends string>(selector: Selector): Promise<Array<ElementHandle<NodeFor<Selector>>>>;
4473
3898
  /**
4474
3899
  * @remarks
4475
3900
  *
@@ -4484,13 +3909,13 @@ export declare class HTTPResponse {
4484
3909
  * recommended as they are easier to debug and use with TypeScript):
4485
3910
  *
4486
3911
  * @example
4487
- * ```
3912
+ * ```ts
4488
3913
  * const aHandle = await page.evaluateHandle('document')
4489
3914
  * ```
4490
3915
  *
4491
3916
  * @example
4492
3917
  * {@link JSHandle} instances can be passed as arguments to the `pageFunction`:
4493
- * ```
3918
+ * ```ts
4494
3919
  * const aHandle = await page.evaluateHandle(() => document.body);
4495
3920
  * const resultHandle = await page.evaluateHandle(body => body.innerHTML, aHandle);
4496
3921
  * console.log(await resultHandle.jsonValue());
@@ -4502,7 +3927,7 @@ export declare class HTTPResponse {
4502
3927
  * you instead get an {@link ElementHandle} back:
4503
3928
  *
4504
3929
  * @example
4505
- * ```
3930
+ * ```ts
4506
3931
  * const button = await page.evaluateHandle(() => document.querySelector('button'));
4507
3932
  * // can call `click` because `button` is an `ElementHandle`
4508
3933
  * await button.click();
@@ -4512,14 +3937,14 @@ export declare class HTTPResponse {
4512
3937
  * a `JSHandle`, but if you know it's going to return an
4513
3938
  * `ElementHandle`, pass it as the generic argument:
4514
3939
  *
4515
- * ```
3940
+ * ```ts
4516
3941
  * const button = await page.evaluateHandle<ElementHandle>(...);
4517
3942
  * ```
4518
3943
  *
4519
3944
  * @param pageFunction - a function that is run within the page
4520
3945
  * @param args - arguments to be passed to the pageFunction
4521
3946
  */
4522
- evaluateHandle<HandlerType extends JSHandle = JSHandle>(pageFunction: EvaluateHandleFn, ...args: SerializableOrJSHandle[]): Promise<HandlerType>;
3947
+ evaluateHandle<Params extends unknown[], Func extends EvaluateFunc<Params> = EvaluateFunc<Params>>(pageFunction: Func | string, ...args: Params): Promise<HandleFor<Awaited<ReturnType<Func>>>>;
4523
3948
  /**
4524
3949
  * This method iterates the JavaScript heap and finds all objects with the
4525
3950
  * given prototype.
@@ -4531,7 +3956,7 @@ export declare class HTTPResponse {
4531
3956
  *
4532
3957
  * @example
4533
3958
  *
4534
- * ```js
3959
+ * ```ts
4535
3960
  * // Create a Map object
4536
3961
  * await page.evaluate(() => window.map = new Map());
4537
3962
  * // Get a handle to the Map object prototype
@@ -4547,7 +3972,7 @@ export declare class HTTPResponse {
4547
3972
  * @returns Promise which resolves to a handle to an array of objects with
4548
3973
  * this prototype.
4549
3974
  */
4550
- queryObjects(prototypeHandle: JSHandle): Promise<JSHandle>;
3975
+ queryObjects<Prototype>(prototypeHandle: JSHandle<Prototype>): Promise<JSHandle<Prototype[]>>;
4551
3976
  /**
4552
3977
  * This method runs `document.querySelector` within the page and passes the
4553
3978
  * result as the first argument to the `pageFunction`.
@@ -4561,7 +3986,7 @@ export declare class HTTPResponse {
4561
3986
  *
4562
3987
  * @example
4563
3988
  *
4564
- * ```
3989
+ * ```ts
4565
3990
  * const searchValue = await page.$eval('#search', el => el.value);
4566
3991
  * const preloadHref = await page.$eval('link[rel=preload]', el => el.href);
4567
3992
  * const html = await page.$eval('.main-container', el => el.outerHTML);
@@ -4574,7 +3999,7 @@ export declare class HTTPResponse {
4574
3999
  *
4575
4000
  * @example
4576
4001
  *
4577
- * ```
4002
+ * ```ts
4578
4003
  * // if you don't provide HTMLInputElement here, TS will error
4579
4004
  * // as `value` is not on `Element`
4580
4005
  * const searchValue = await page.$eval('#search', (el: HTMLInputElement) => el.value);
@@ -4586,7 +4011,7 @@ export declare class HTTPResponse {
4586
4011
  *
4587
4012
  * @example
4588
4013
  *
4589
- * ```
4014
+ * ```ts
4590
4015
  * // The compiler can infer the return type in this case, but if it can't
4591
4016
  * // or if you want to be more explicit, provide it as the generic type.
4592
4017
  * const searchValue = await page.$eval<string>(
@@ -4606,7 +4031,10 @@ export declare class HTTPResponse {
4606
4031
  * is wrapped in an {@link ElementHandle}, else the raw value itself is
4607
4032
  * returned.
4608
4033
  */
4609
- $eval<ReturnType>(selector: string, pageFunction: (element: Element, ...args: unknown[]) => ReturnType | Promise<ReturnType>, ...args: SerializableOrJSHandle[]): Promise<WrapElementHandle<ReturnType>>;
4034
+ $eval<Selector extends string, Params extends unknown[], Func extends EvaluateFunc<[
4035
+ ElementHandle<NodeFor<Selector>>,
4036
+ ...Params
4037
+ ]> = EvaluateFunc<[ElementHandle<NodeFor<Selector>>, ...Params]>>(selector: Selector, pageFunction: Func | string, ...args: Params): Promise<Awaited<ReturnType<Func>>>;
4610
4038
  /**
4611
4039
  * This method runs `Array.from(document.querySelectorAll(selector))` within
4612
4040
  * the page and passes the result as the first argument to the `pageFunction`.
@@ -4618,7 +4046,7 @@ export declare class HTTPResponse {
4618
4046
  *
4619
4047
  * @example
4620
4048
  *
4621
- * ```
4049
+ * ```ts
4622
4050
  * // get the amount of divs on the page
4623
4051
  * const divCount = await page.$$eval('div', divs => divs.length);
4624
4052
  *
@@ -4635,7 +4063,7 @@ export declare class HTTPResponse {
4635
4063
  *
4636
4064
  * @example
4637
4065
  *
4638
- * ```
4066
+ * ```ts
4639
4067
  * // if you don't provide HTMLInputElement here, TS will error
4640
4068
  * // as `value` is not on `Element`
4641
4069
  * await page.$$eval('input', (elements: HTMLInputElement[]) => {
@@ -4649,7 +4077,7 @@ export declare class HTTPResponse {
4649
4077
  *
4650
4078
  * @example
4651
4079
  *
4652
- * ```
4080
+ * ```ts
4653
4081
  * // The compiler can infer the return type in this case, but if it can't
4654
4082
  * // or if you want to be more explicit, provide it as the generic type.
4655
4083
  * const allInputValues = await page.$$eval<string[]>(
@@ -4669,15 +4097,10 @@ export declare class HTTPResponse {
4669
4097
  * is wrapped in an {@link ElementHandle}, else the raw value itself is
4670
4098
  * returned.
4671
4099
  */
4672
- $$eval<ReturnType>(selector: string, pageFunction: (elements: Element[], ...args: unknown[]) => ReturnType | Promise<ReturnType>, ...args: SerializableOrJSHandle[]): Promise<WrapElementHandle<ReturnType>>;
4673
- /**
4674
- * The method runs `document.querySelectorAll` within the page. If no elements
4675
- * match the selector, the return value resolves to `[]`.
4676
- * @remarks
4677
- * Shortcut for {@link Frame.$$ | Page.mainFrame().$$(selector) }.
4678
- * @param selector - A `selector` to query page for
4679
- */
4680
- $$<T extends Element = Element>(selector: string): Promise<Array<ElementHandle<T>>>;
4100
+ $$eval<Selector extends string, Params extends unknown[], Func extends EvaluateFunc<[
4101
+ Array<NodeFor<Selector>>,
4102
+ ...Params
4103
+ ]> = EvaluateFunc<[Array<NodeFor<Selector>>, ...Params]>>(selector: Selector, pageFunction: Func | string, ...args: Params): Promise<Awaited<ReturnType<Func>>>;
4681
4104
  /**
4682
4105
  * The method evaluates the XPath expression relative to the page document as
4683
4106
  * its context node. If there are no such elements, the method resolves to an
@@ -4686,7 +4109,7 @@ export declare class HTTPResponse {
4686
4109
  * Shortcut for {@link Frame.$x | Page.mainFrame().$x(expression) }.
4687
4110
  * @param expression - Expression to evaluate
4688
4111
  */
4689
- $x(expression: string): Promise<ElementHandle[]>;
4112
+ $x(expression: string): Promise<Array<ElementHandle<Node>>>;
4690
4113
  /**
4691
4114
  * If no URLs are specified, this method returns cookies for the current page
4692
4115
  * URL. If URLs are specified, only cookies for those URLs are returned.
@@ -4695,7 +4118,7 @@ export declare class HTTPResponse {
4695
4118
  deleteCookie(...cookies: Protocol.Network.DeleteCookiesRequest[]): Promise<void>;
4696
4119
  /**
4697
4120
  * @example
4698
- * ```js
4121
+ * ```ts
4699
4122
  * await page.setCookie(cookieObject1, cookieObject2);
4700
4123
  * ```
4701
4124
  */
@@ -4713,7 +4136,7 @@ export declare class HTTPResponse {
4713
4136
  content?: string;
4714
4137
  type?: string;
4715
4138
  id?: string;
4716
- }): Promise<ElementHandle>;
4139
+ }): Promise<ElementHandle<HTMLScriptElement>>;
4717
4140
  /**
4718
4141
  * Adds a `<link rel="stylesheet">` tag into the page with the desired URL or a
4719
4142
  * `<style type="text/css">` tag with the content.
@@ -4724,7 +4147,7 @@ export declare class HTTPResponse {
4724
4147
  url?: string;
4725
4148
  path?: string;
4726
4149
  content?: string;
4727
- }): Promise<ElementHandle>;
4150
+ }): Promise<ElementHandle<Node>>;
4728
4151
  /**
4729
4152
  * The method adds a function called `name` on the page's `window` object. When
4730
4153
  * called, the function executes `puppeteerFunction` in node.js and returns a
@@ -4734,11 +4157,11 @@ export declare class HTTPResponse {
4734
4157
  *
4735
4158
  * NOTE: Functions installed via `page.exposeFunction` survive navigations.
4736
4159
  * @param name - Name of the function on the window object
4737
- * @param puppeteerFunction - Callback function which will be called in
4160
+ * @param pptrFunction - Callback function which will be called in
4738
4161
  * Puppeteer's context.
4739
4162
  * @example
4740
4163
  * An example of adding an `md5` function into the page:
4741
- * ```js
4164
+ * ```ts
4742
4165
  * const puppeteer = require('puppeteer');
4743
4166
  * const crypto = require('crypto');
4744
4167
  *
@@ -4759,7 +4182,7 @@ export declare class HTTPResponse {
4759
4182
  * })();
4760
4183
  * ```
4761
4184
  * An example of adding a `window.readfile` function into the page:
4762
- * ```js
4185
+ * ```ts
4763
4186
  * const puppeteer = require('puppeteer');
4764
4187
  * const fs = require('fs');
4765
4188
  *
@@ -4784,7 +4207,7 @@ export declare class HTTPResponse {
4784
4207
  * })();
4785
4208
  * ```
4786
4209
  */
4787
- exposeFunction(name: string, puppeteerFunction: Function | {
4210
+ exposeFunction(name: string, pptrFunction: Function | {
4788
4211
  default: Function;
4789
4212
  }): Promise<void>;
4790
4213
  /**
@@ -4845,21 +4268,6 @@ export declare class HTTPResponse {
4845
4268
  * in seconds since an arbitrary point in the past.
4846
4269
  */
4847
4270
  metrics(): Promise<Metrics>;
4848
- private _emitMetrics;
4849
- private _buildMetricsObject;
4850
- private _handleException;
4851
- private _onConsoleAPI;
4852
- private _onBindingCalled;
4853
- private _addConsoleMessage;
4854
- private _onDialog;
4855
- /**
4856
- * Resets default white background
4857
- */
4858
- private _resetDefaultBackgroundColor;
4859
- /**
4860
- * Hides default white background
4861
- */
4862
- private _setTransparentBackgroundColor;
4863
4271
  /**
4864
4272
  *
4865
4273
  * @returns
@@ -4876,23 +4284,21 @@ export declare class HTTPResponse {
4876
4284
  *
4877
4285
  * - `timeout` : Maximum time in milliseconds for resources to load, defaults
4878
4286
  * to 30 seconds, pass `0` to disable timeout. The default value can be
4879
- * changed by using the
4880
- * {@link Page.setDefaultNavigationTimeout |
4881
- * page.setDefaultNavigationTimeout(timeout)}
4882
- * or {@link Page.setDefaultTimeout | page.setDefaultTimeout(timeout)}
4883
- * methods.
4884
- *
4885
- * - `waitUntil`: When to consider setting markup succeeded, defaults to `load`.
4886
- * Given an array of event strings, setting content is considered to be
4887
- * successful after all events have been fired. Events can be either:<br/>
4888
- * - `load` : consider setting content to be finished when the `load` event is
4889
- * fired.<br/>
4287
+ * changed by using the {@link Page.setDefaultNavigationTimeout} or
4288
+ * {@link Page.setDefaultTimeout} methods.
4289
+ *
4290
+ * - `waitUntil`: When to consider setting markup succeeded, defaults to
4291
+ * `load`. Given an array of event strings, setting content is considered
4292
+ * to be successful after all events have been fired. Events can be
4293
+ * either:<br/>
4294
+ * - `load` : consider setting content to be finished when the `load` event
4295
+ * is fired.<br/>
4890
4296
  * - `domcontentloaded` : consider setting content to be finished when the
4891
- * `DOMContentLoaded` event is fired.<br/>
4892
- * - `networkidle0` : consider setting content to be finished when there are no
4893
- * more than 0 network connections for at least `500` ms.<br/>
4894
- * - `networkidle2` : consider setting content to be finished when there are no
4895
- * more than 2 network connections for at least `500` ms.
4297
+ * `DOMContentLoaded` event is fired.<br/>
4298
+ * - `networkidle0` : consider setting content to be finished when there are
4299
+ * no more than 0 network connections for at least `500` ms.<br/>
4300
+ * - `networkidle2` : consider setting content to be finished when there are
4301
+ * no more than 2 network connections for at least `500` ms.
4896
4302
  */
4897
4303
  setContent(html: string, options?: WaitForOptions): Promise<void>;
4898
4304
  /**
@@ -4907,15 +4313,12 @@ export declare class HTTPResponse {
4907
4313
  *
4908
4314
  * - `timeout` : Maximum navigation time in milliseconds, defaults to 30
4909
4315
  * seconds, pass 0 to disable timeout. The default value can be changed by
4910
- * using the
4911
- * {@link Page.setDefaultNavigationTimeout |
4912
- * page.setDefaultNavigationTimeout(timeout)}
4913
- * or {@link Page.setDefaultTimeout | page.setDefaultTimeout(timeout)}
4914
- * methods.
4316
+ * using the {@link Page.setDefaultNavigationTimeout} or
4317
+ * {@link Page.setDefaultTimeout} methods.
4915
4318
  *
4916
4319
  * - `waitUntil`:When to consider navigation succeeded, defaults to `load`.
4917
- * Given an array of event strings, navigation is considered to be successful
4918
- * after all events have been fired. Events can be either:<br/>
4320
+ * Given an array of event strings, navigation is considered to be
4321
+ * successful after all events have been fired. Events can be either:<br/>
4919
4322
  * - `load` : consider navigation to be finished when the load event is
4920
4323
  * fired.<br/>
4921
4324
  * - `domcontentloaded` : consider navigation to be finished when the
@@ -4946,14 +4349,14 @@ export declare class HTTPResponse {
4946
4349
  * to the same URL with a different hash, which would succeed and return null.
4947
4350
  *
4948
4351
  * NOTE: Headless mode doesn't support navigation to a PDF document. See the
4949
- * {@link https://bugs.chromium.org/p/chromium/issues/detail?id=761295
4950
- * | upstream issue}.
4352
+ * {@link https://bugs.chromium.org/p/chromium/issues/detail?id=761295 |
4353
+ * upstream issue}.
4951
4354
  *
4952
4355
  * Shortcut for {@link Frame.goto | page.mainFrame().goto(url, options)}.
4953
4356
  */
4954
4357
  goto(url: string, options?: WaitForOptions & {
4955
4358
  referer?: string;
4956
- }): Promise<HTTPResponse>;
4359
+ }): Promise<HTTPResponse | null>;
4957
4360
  /**
4958
4361
  * @param options - Navigation parameters which might have the following
4959
4362
  * properties:
@@ -4965,56 +4368,54 @@ export declare class HTTPResponse {
4965
4368
  *
4966
4369
  * - `timeout` : Maximum navigation time in milliseconds, defaults to 30
4967
4370
  * seconds, pass 0 to disable timeout. The default value can be changed by
4968
- * using the
4969
- * {@link Page.setDefaultNavigationTimeout |
4970
- * page.setDefaultNavigationTimeout(timeout)}
4971
- * or {@link Page.setDefaultTimeout | page.setDefaultTimeout(timeout)}
4972
- * methods.
4371
+ * using the {@link Page.setDefaultNavigationTimeout} or
4372
+ * {@link Page.setDefaultTimeout} methods.
4973
4373
  *
4974
4374
  * - `waitUntil`: When to consider navigation succeeded, defaults to `load`.
4975
4375
  * Given an array of event strings, navigation is considered to be
4976
4376
  * successful after all events have been fired. Events can be either:<br/>
4977
- * - `load` : consider navigation to be finished when the load event is fired.<br/>
4377
+ * - `load` : consider navigation to be finished when the load event is
4378
+ * fired.<br/>
4978
4379
  * - `domcontentloaded` : consider navigation to be finished when the
4979
- * DOMContentLoaded event is fired.<br/>
4380
+ * DOMContentLoaded event is fired.<br/>
4980
4381
  * - `networkidle0` : consider navigation to be finished when there are no
4981
- * more than 0 network connections for at least `500` ms.<br/>
4382
+ * more than 0 network connections for at least `500` ms.<br/>
4982
4383
  * - `networkidle2` : consider navigation to be finished when there are no
4983
- * more than 2 network connections for at least `500` ms.
4384
+ * more than 2 network connections for at least `500` ms.
4984
4385
  */
4985
4386
  reload(options?: WaitForOptions): Promise<HTTPResponse | null>;
4986
4387
  /**
4987
- * This resolves when the page navigates to a new URL or reloads. It is useful
4988
- * when you run code that will indirectly cause the page to navigate. Consider
4989
- * this example:
4990
- * ```js
4388
+ * Waits for the page to navigate to a new URL or to reload. It is useful when
4389
+ * you run code that will indirectly cause the page to navigate.
4390
+ *
4391
+ * @example
4392
+ * ```ts
4991
4393
  * const [response] = await Promise.all([
4992
4394
  * page.waitForNavigation(), // The promise resolves after navigation has finished
4993
4395
  * page.click('a.my-link'), // Clicking the link will indirectly cause a navigation
4994
4396
  * ]);
4995
4397
  * ```
4996
4398
  *
4997
- * @param options - Navigation parameters which might have the following properties:
4998
- * @returns Promise which resolves to the main resource response. In case of
4999
- * multiple redirects, the navigation will resolve with the response of the
5000
- * last redirect. In case of navigation to a different anchor or navigation
5001
- * due to History API usage, the navigation will resolve with `null`.
5002
4399
  * @remarks
5003
- * NOTE: Usage of the
4400
+ * Usage of the
5004
4401
  * {@link https://developer.mozilla.org/en-US/docs/Web/API/History_API | History API}
5005
4402
  * to change the URL is considered a navigation.
5006
4403
  *
5007
- * Shortcut for
5008
- * {@link Frame.waitForNavigation | page.mainFrame().waitForNavigation(options)}.
4404
+ * @param options - Navigation parameters which might have the following
4405
+ * properties:
4406
+ * @returns A `Promise` which resolves to the main resource response.
4407
+ * - In case of multiple redirects, the navigation will resolve with the
4408
+ * response of the last redirect.
4409
+ * - In case of navigation to a different anchor or navigation due to History
4410
+ * API usage, the navigation will resolve with `null`.
5009
4411
  */
5010
4412
  waitForNavigation(options?: WaitForOptions): Promise<HTTPResponse | null>;
5011
- private _sessionClosePromise;
5012
4413
  /**
5013
4414
  * @param urlOrPredicate - A URL or predicate to wait for
5014
4415
  * @param options - Optional waiting parameters
5015
4416
  * @returns Promise which resolves to the matched response
5016
4417
  * @example
5017
- * ```js
4418
+ * ```ts
5018
4419
  * const firstResponse = await page.waitForResponse(
5019
4420
  * 'https://example.com/resource'
5020
4421
  * );
@@ -5042,7 +4443,7 @@ export declare class HTTPResponse {
5042
4443
  * @param options - Optional waiting parameters
5043
4444
  * @returns Promise which resolves to the matched response.
5044
4445
  * @example
5045
- * ```js
4446
+ * ```ts
5046
4447
  * const firstResponse = await page.waitForResponse(
5047
4448
  * 'https://example.com/resource'
5048
4449
  * );
@@ -5078,7 +4479,7 @@ export declare class HTTPResponse {
5078
4479
  * @param options - Optional waiting parameters
5079
4480
  * @returns Promise which resolves to the matched frame.
5080
4481
  * @example
5081
- * ```js
4482
+ * ```ts
5082
4483
  * const frame = await page.waitForFrame(async (frame) => {
5083
4484
  * return frame.name() === 'Test';
5084
4485
  * });
@@ -5104,22 +4505,20 @@ export declare class HTTPResponse {
5104
4505
  *
5105
4506
  * - `timeout` : Maximum navigation time in milliseconds, defaults to 30
5106
4507
  * seconds, pass 0 to disable timeout. The default value can be changed by
5107
- * using the
5108
- * {@link Page.setDefaultNavigationTimeout
5109
- * | page.setDefaultNavigationTimeout(timeout)}
5110
- * or {@link Page.setDefaultTimeout | page.setDefaultTimeout(timeout)}
5111
- * methods.
4508
+ * using the {@link Page.setDefaultNavigationTimeout} or
4509
+ * {@link Page.setDefaultTimeout} methods.
5112
4510
  *
5113
4511
  * - `waitUntil` : When to consider navigation succeeded, defaults to `load`.
5114
4512
  * Given an array of event strings, navigation is considered to be
5115
4513
  * successful after all events have been fired. Events can be either:<br/>
5116
- * - `load` : consider navigation to be finished when the load event is fired.<br/>
4514
+ * - `load` : consider navigation to be finished when the load event is
4515
+ * fired.<br/>
5117
4516
  * - `domcontentloaded` : consider navigation to be finished when the
5118
- * DOMContentLoaded event is fired.<br/>
4517
+ * DOMContentLoaded event is fired.<br/>
5119
4518
  * - `networkidle0` : consider navigation to be finished when there are no
5120
- * more than 0 network connections for at least `500` ms.<br/>
4519
+ * more than 0 network connections for at least `500` ms.<br/>
5121
4520
  * - `networkidle2` : consider navigation to be finished when there are no
5122
- * more than 2 network connections for at least `500` ms.
4521
+ * more than 2 network connections for at least `500` ms.
5123
4522
  */
5124
4523
  goBack(options?: WaitForOptions): Promise<HTTPResponse | null>;
5125
4524
  /**
@@ -5133,38 +4532,38 @@ export declare class HTTPResponse {
5133
4532
  *
5134
4533
  * - `timeout` : Maximum navigation time in milliseconds, defaults to 30
5135
4534
  * seconds, pass 0 to disable timeout. The default value can be changed by
5136
- * using the
5137
- * {@link Page.setDefaultNavigationTimeout
5138
- * | page.setDefaultNavigationTimeout(timeout)}
5139
- * or {@link Page.setDefaultTimeout | page.setDefaultTimeout(timeout)}
5140
- * methods.
4535
+ * using the {@link Page.setDefaultNavigationTimeout} or
4536
+ * {@link Page.setDefaultTimeout} methods.
5141
4537
  *
5142
4538
  * - `waitUntil`: When to consider navigation succeeded, defaults to `load`.
5143
4539
  * Given an array of event strings, navigation is considered to be
5144
4540
  * successful after all events have been fired. Events can be either:<br/>
5145
- * - `load` : consider navigation to be finished when the load event is fired.<br/>
4541
+ * - `load` : consider navigation to be finished when the load event is
4542
+ * fired.<br/>
5146
4543
  * - `domcontentloaded` : consider navigation to be finished when the
5147
- * DOMContentLoaded event is fired.<br/>
4544
+ * DOMContentLoaded event is fired.<br/>
5148
4545
  * - `networkidle0` : consider navigation to be finished when there are no
5149
- * more than 0 network connections for at least `500` ms.<br/>
4546
+ * more than 0 network connections for at least `500` ms.<br/>
5150
4547
  * - `networkidle2` : consider navigation to be finished when there are no
5151
- * more than 2 network connections for at least `500` ms.
4548
+ * more than 2 network connections for at least `500` ms.
5152
4549
  */
5153
4550
  goForward(options?: WaitForOptions): Promise<HTTPResponse | null>;
5154
- private _go;
5155
4551
  /**
5156
4552
  * Brings page to front (activates tab).
5157
4553
  */
5158
4554
  bringToFront(): Promise<void>;
5159
4555
  /**
5160
- * Emulates given device metrics and user agent. This method is a shortcut for
5161
- * calling two methods: {@link Page.setUserAgent} and {@link Page.setViewport}
5162
- * To aid emulation, Puppeteer provides a list of device descriptors that can
5163
- * be obtained via the {@link Puppeteer.devices} `page.emulate` will resize
5164
- * the page. A lot of websites don't expect phones to change size, so you
5165
- * should emulate before navigating to the page.
4556
+ * Emulates given device metrics and user agent.
4557
+ *
4558
+ * @remarks
4559
+ * This method is a shortcut for calling two methods:
4560
+ * {@link Page.setUserAgent} and {@link Page.setViewport} To aid emulation,
4561
+ * Puppeteer provides a list of device descriptors that can be obtained via
4562
+ * {@link devices}. `page.emulate` will resize the page. A lot of websites
4563
+ * don't expect phones to change size, so you should emulate before navigating
4564
+ * to the page.
5166
4565
  * @example
5167
- * ```js
4566
+ * ```ts
5168
4567
  * const puppeteer = require('puppeteer');
5169
4568
  * const iPhone = puppeteer.devices['iPhone 6'];
5170
4569
  * (async () => {
@@ -5205,7 +4604,7 @@ export declare class HTTPResponse {
5205
4604
  * values are `screen`, `print` and `null`. Passing `null` disables CSS media
5206
4605
  * emulation.
5207
4606
  * @example
5208
- * ```
4607
+ * ```ts
5209
4608
  * await page.evaluate(() => matchMedia('screen').matches);
5210
4609
  * // → true
5211
4610
  * await page.evaluate(() => matchMedia('print').matches);
@@ -5235,7 +4634,7 @@ export declare class HTTPResponse {
5235
4634
  * objects, emulates CSS media features on the page. Each media feature object
5236
4635
  * must have the following properties:
5237
4636
  * @example
5238
- * ```js
4637
+ * ```ts
5239
4638
  * await page.emulateMediaFeatures([
5240
4639
  * { name: 'prefers-color-scheme', value: 'dark' },
5241
4640
  * ]);
@@ -5295,7 +4694,7 @@ export declare class HTTPResponse {
5295
4694
  * If no arguments set, clears idle state emulation.
5296
4695
  *
5297
4696
  * @example
5298
- * ```js
4697
+ * ```ts
5299
4698
  * // set idle emulation
5300
4699
  * await page.emulateIdleState({isUserActive: true, isScreenUnlocked: false});
5301
4700
  *
@@ -5316,7 +4715,7 @@ export declare class HTTPResponse {
5316
4715
  * Simulates the given vision deficiency on the page.
5317
4716
  *
5318
4717
  * @example
5319
- * ```js
4718
+ * ```ts
5320
4719
  * const puppeteer = require('puppeteer');
5321
4720
  *
5322
4721
  * (async () => {
@@ -5348,7 +4747,7 @@ export declare class HTTPResponse {
5348
4747
  * In the case of multiple pages in a single browser, each page can have its
5349
4748
  * own viewport size.
5350
4749
  * @example
5351
- * ```js
4750
+ * ```ts
5352
4751
  * const page = await browser.newPage();
5353
4752
  * await page.setViewport({
5354
4753
  * width: 640,
@@ -5410,7 +4809,7 @@ export declare class HTTPResponse {
5410
4809
  *
5411
4810
  * @example
5412
4811
  *
5413
- * ```js
4812
+ * ```ts
5414
4813
  * const result = await frame.evaluate(() => {
5415
4814
  * return Promise.resolve(8 * 7);
5416
4815
  * });
@@ -5421,15 +4820,15 @@ export declare class HTTPResponse {
5421
4820
  * recommended as they are easier to debug and use with TypeScript):
5422
4821
  *
5423
4822
  * @example
5424
- * ```
4823
+ * ```ts
5425
4824
  * const aHandle = await page.evaluate('1 + 2');
5426
4825
  * ```
5427
4826
  *
5428
4827
  * To get the best TypeScript experience, you should pass in as the
5429
4828
  * generic the type of `pageFunction`:
5430
4829
  *
5431
- * ```
5432
- * const aHandle = await page.evaluate<() => number>(() => 2);
4830
+ * ```ts
4831
+ * const aHandle = await page.evaluate(() => 2);
5433
4832
  * ```
5434
4833
  *
5435
4834
  * @example
@@ -5437,7 +4836,7 @@ export declare class HTTPResponse {
5437
4836
  * {@link ElementHandle} instances (including {@link JSHandle}s) can be passed
5438
4837
  * as arguments to the `pageFunction`:
5439
4838
  *
5440
- * ```
4839
+ * ```ts
5441
4840
  * const bodyHandle = await page.$('body');
5442
4841
  * const html = await page.evaluate(body => body.innerHTML, bodyHandle);
5443
4842
  * await bodyHandle.dispose();
@@ -5448,7 +4847,7 @@ export declare class HTTPResponse {
5448
4847
  *
5449
4848
  * @returns the return value of `pageFunction`.
5450
4849
  */
5451
- evaluate<T extends EvaluateFn>(pageFunction: T, ...args: SerializableOrJSHandle[]): Promise<UnwrapPromiseLike<EvaluateFnReturnType<T>>>;
4850
+ evaluate<Params extends unknown[], Func extends EvaluateFunc<Params> = EvaluateFunc<Params>>(pageFunction: Func | string, ...args: Params): Promise<Awaited<ReturnType<Func>>>;
5452
4851
  /**
5453
4852
  * Adds a function which would be invoked in one of the following scenarios:
5454
4853
  *
@@ -5464,7 +4863,7 @@ export declare class HTTPResponse {
5464
4863
  * @param args - Arguments to pass to `pageFunction`
5465
4864
  * @example
5466
4865
  * An example of overriding the navigator.languages property before the page loads:
5467
- * ```js
4866
+ * ```ts
5468
4867
  * // preload.js
5469
4868
  *
5470
4869
  * // overwrite the `languages` property to use a custom getter
@@ -5480,7 +4879,7 @@ export declare class HTTPResponse {
5480
4879
  * await page.evaluateOnNewDocument(preloadFile);
5481
4880
  * ```
5482
4881
  */
5483
- evaluateOnNewDocument(pageFunction: Function | string, ...args: unknown[]): Promise<void>;
4882
+ evaluateOnNewDocument<Params extends unknown[], Func extends (...args: Params) => unknown = (...args: Params) => unknown>(pageFunction: Func | string, ...args: Params): Promise<void>;
5484
4883
  /**
5485
4884
  * Toggles ignoring cache for each request based on the enabled state. By
5486
4885
  * default, caching is enabled.
@@ -5505,7 +4904,7 @@ export declare class HTTPResponse {
5505
4904
  * applicable to `png` images.
5506
4905
  *
5507
4906
  * - `fullPage` : When true, takes a screenshot of the full
5508
- * scrollable page. Defaults to `false`
4907
+ * scrollable page. Defaults to `false`.
5509
4908
  *
5510
4909
  * - `clip` : An object which specifies clipping region of the page.
5511
4910
  * Should have the following fields:<br/>
@@ -5515,11 +4914,21 @@ export declare class HTTPResponse {
5515
4914
  * - `height` : height of clipping area.
5516
4915
  *
5517
4916
  * - `omitBackground` : Hides default white background and allows
5518
- * capturing screenshots with transparency. Defaults to `false`
4917
+ * capturing screenshots with transparency. Defaults to `false`.
5519
4918
  *
5520
4919
  * - `encoding` : The encoding of the image, can be either base64 or
5521
4920
  * binary. Defaults to `binary`.
5522
4921
  *
4922
+ * - `captureBeyondViewport` : When true, captures screenshot
4923
+ * {@link https://chromedevtools.github.io/devtools-protocol/tot/Page/#method-captureScreenshot
4924
+ * | beyond the viewport}. When false, falls back to old behaviour,
4925
+ * and cuts the screenshot by the viewport size. Defaults to `true`.
4926
+ *
4927
+ * - `fromSurface` : When true, captures screenshot
4928
+ * {@link https://chromedevtools.github.io/devtools-protocol/tot/Page/#method-captureScreenshot
4929
+ * | from the surface rather than the view}. When false, works only in
4930
+ * headful mode and ignores page viewport (but not browser window's
4931
+ * bounds). Defaults to `true`.
5523
4932
  *
5524
4933
  * NOTE: Screenshots take at least 1/6 second on OS X. See
5525
4934
  * {@link https://crbug.com/741689} for discussion.
@@ -5527,7 +4936,6 @@ export declare class HTTPResponse {
5527
4936
  * the value of `encoding`) with captured screenshot.
5528
4937
  */
5529
4938
  screenshot(options?: ScreenshotOptions): Promise<Buffer | string>;
5530
- private _screenshotTask;
5531
4939
  /**
5532
4940
  * Generates a PDF of the page with the `print` CSS media type.
5533
4941
  * @remarks
@@ -5576,7 +4984,7 @@ export declare class HTTPResponse {
5576
4984
  * there's a separate `page.waitForNavigation()` promise to be resolved, you
5577
4985
  * may end up with a race condition that yields unexpected results. The
5578
4986
  * correct pattern for click and wait for navigation is the following:
5579
- * ```js
4987
+ * ```ts
5580
4988
  * const [response] = await Promise.all([
5581
4989
  * page.waitForNavigation(waitOptions),
5582
4990
  * page.click(selector, clickOptions),
@@ -5630,7 +5038,7 @@ export declare class HTTPResponse {
5630
5038
  * throws an error.
5631
5039
  *
5632
5040
  * @example
5633
- * ```js
5041
+ * ```ts
5634
5042
  * page.select('select#colors', 'blue'); // single selection
5635
5043
  * page.select('select#colors', 'red', 'green', 'blue'); // multiple selections
5636
5044
  * ```
@@ -5665,7 +5073,7 @@ export declare class HTTPResponse {
5665
5073
  *
5666
5074
  * To press a special key, like `Control` or `ArrowDown`, use {@link Keyboard.press}.
5667
5075
  * @example
5668
- * ```
5076
+ * ```ts
5669
5077
  * await page.type('#mytextarea', 'Hello');
5670
5078
  * // Types instantly
5671
5079
  * await page.type('#mytextarea', 'World', { delay: 100 });
@@ -5684,37 +5092,6 @@ export declare class HTTPResponse {
5684
5092
  type(selector: string, text: string, options?: {
5685
5093
  delay: number;
5686
5094
  }): Promise<void>;
5687
- /**
5688
- * @remarks
5689
- *
5690
- * This method behaves differently depending on the first parameter. If it's a
5691
- * `string`, it will be treated as a `selector` or `xpath` (if the string
5692
- * starts with `//`). This method then is a shortcut for
5693
- * {@link Page.waitForSelector} or {@link Page.waitForXPath}.
5694
- *
5695
- * If the first argument is a function this method is a shortcut for
5696
- * {@link Page.waitForFunction}.
5697
- *
5698
- * If the first argument is a `number`, it's treated as a timeout in
5699
- * milliseconds and the method returns a promise which resolves after the
5700
- * timeout.
5701
- *
5702
- * @param selectorOrFunctionOrTimeout - a selector, predicate or timeout to
5703
- * wait for.
5704
- * @param options - optional waiting parameters.
5705
- * @param args - arguments to pass to `pageFunction`.
5706
- *
5707
- * @deprecated Don't use this method directly. Instead use the more explicit
5708
- * methods available: {@link Page.waitForSelector},
5709
- * {@link Page.waitForXPath}, {@link Page.waitForFunction} or
5710
- * {@link Page.waitForTimeout}.
5711
- */
5712
- waitFor(selectorOrFunctionOrTimeout: string | number | Function, options?: {
5713
- visible?: boolean;
5714
- hidden?: boolean;
5715
- timeout?: number;
5716
- polling?: string | number;
5717
- }, ...args: SerializableOrJSHandle[]): Promise<JSHandle>;
5718
5095
  /**
5719
5096
  * Causes your script to wait for the given number of milliseconds.
5720
5097
  *
@@ -5728,7 +5105,7 @@ export declare class HTTPResponse {
5728
5105
  *
5729
5106
  * Wait for 1 second:
5730
5107
  *
5731
- * ```
5108
+ * ```ts
5732
5109
  * await page.waitForTimeout(1000);
5733
5110
  * ```
5734
5111
  *
@@ -5742,7 +5119,7 @@ export declare class HTTPResponse {
5742
5119
  * function will throw.
5743
5120
  *
5744
5121
  * This method works across navigations:
5745
- * ```js
5122
+ * ```ts
5746
5123
  * const puppeteer = require('puppeteer');
5747
5124
  * (async () => {
5748
5125
  * const browser = await puppeteer.launch();
@@ -5783,11 +5160,7 @@ export declare class HTTPResponse {
5783
5160
  * (30 seconds). Pass `0` to disable timeout. The default value can be changed
5784
5161
  * by using the {@link Page.setDefaultTimeout} method.
5785
5162
  */
5786
- waitForSelector(selector: string, options?: {
5787
- visible?: boolean;
5788
- hidden?: boolean;
5789
- timeout?: number;
5790
- }): Promise<ElementHandle | null>;
5163
+ waitForSelector<Selector extends string>(selector: Selector, options?: Exclude<WaitForSelectorOptions, 'root'>): Promise<ElementHandle<NodeFor<Selector>> | null>;
5791
5164
  /**
5792
5165
  * Wait for the `xpath` to appear in page. If at the moment of calling the
5793
5166
  * method the `xpath` already exists, the method will return immediately. If
@@ -5795,7 +5168,7 @@ export declare class HTTPResponse {
5795
5168
  * function will throw.
5796
5169
  *
5797
5170
  * This method works across navigation
5798
- * ```js
5171
+ * ```ts
5799
5172
  * const puppeteer = require('puppeteer');
5800
5173
  * (async () => {
5801
5174
  * const browser = await puppeteer.launch();
@@ -5840,11 +5213,14 @@ export declare class HTTPResponse {
5840
5213
  visible?: boolean;
5841
5214
  hidden?: boolean;
5842
5215
  timeout?: number;
5843
- }): Promise<ElementHandle | null>;
5216
+ }): Promise<ElementHandle<Node> | null>;
5844
5217
  /**
5845
- * The `waitForFunction` can be used to observe viewport size change:
5218
+ * Waits for a function to finish evaluating in the page's context.
5846
5219
  *
5847
- * ```
5220
+ * @example
5221
+ * The {@link Page.waitForFunction} can be used to observe viewport size change:
5222
+ *
5223
+ * ```ts
5848
5224
  * const puppeteer = require('puppeteer');
5849
5225
  * (async () => {
5850
5226
  * const browser = await puppeteer.launch();
@@ -5855,8 +5231,11 @@ export declare class HTTPResponse {
5855
5231
  * await browser.close();
5856
5232
  * })();
5857
5233
  * ```
5858
- * To pass arguments from node.js to the predicate of `page.waitForFunction` function:
5859
- * ```
5234
+ *
5235
+ * @example
5236
+ * To pass arguments from node.js to the predicate of
5237
+ * {@link Page.waitForFunction} function:
5238
+ * ```ts
5860
5239
  * const selector = '.foo';
5861
5240
  * await page.waitForFunction(
5862
5241
  * (selector) => !!document.querySelector(selector),
@@ -5864,8 +5243,10 @@ export declare class HTTPResponse {
5864
5243
  * selector
5865
5244
  * );
5866
5245
  * ```
5867
- * The predicate of `page.waitForFunction` can be asynchronous too:
5868
- * ```
5246
+ *
5247
+ * @example
5248
+ * The predicate of {@link Page.waitForFunction} can be asynchronous too:
5249
+ * ```ts
5869
5250
  * const username = 'github-username';
5870
5251
  * await page.waitForFunction(
5871
5252
  * async (username) => {
@@ -5884,42 +5265,39 @@ export declare class HTTPResponse {
5884
5265
  * username
5885
5266
  * );
5886
5267
  * ```
5268
+ *
5887
5269
  * @param pageFunction - Function to be evaluated in browser context
5888
5270
  * @param options - Optional waiting parameters
5889
- * @param args - Arguments to pass to `pageFunction`
5890
- * @returns Promise which resolves when the `pageFunction` returns a truthy
5891
- * value. It resolves to a JSHandle of the truthy value.
5892
- *
5893
- * The optional waiting parameter can be:
5894
- *
5895
- * - `Polling`: An interval at which the `pageFunction` is executed, defaults to
5896
- * `raf`. If `polling` is a number, then it is treated as an interval in
5271
+ * - `polling` - An interval at which the `pageFunction` is executed, defaults
5272
+ * to `raf`. If `polling` is a number, then it is treated as an interval in
5897
5273
  * milliseconds at which the function would be executed. If polling is a
5898
- * string, then it can be one of the following values:<br/>
5899
- * - `raf`: to constantly execute `pageFunction` in `requestAnimationFrame`
5900
- * callback. This is the tightest polling mode which is suitable to
5901
- * observe styling changes.<br/>
5902
- * - `mutation`: to execute pageFunction on every DOM mutation.
5903
- *
5904
- * - `timeout`: maximum time to wait for in milliseconds. Defaults to `30000`
5905
- * (30 seconds). Pass `0` to disable timeout. The default value can be changed
5906
- * by using the
5907
- * {@link Page.setDefaultTimeout | page.setDefaultTimeout(timeout)} method.
5908
- *
5274
+ * string, then it can be one of the following values:
5275
+ * - `raf` - to constantly execute `pageFunction` in
5276
+ * `requestAnimationFrame` callback. This is the tightest polling mode
5277
+ * which is suitable to observe styling changes.
5278
+ * - `mutation`- to execute pageFunction on every DOM mutation.
5279
+ * - `timeout` - maximum time to wait for in milliseconds. Defaults to `30000`
5280
+ * (30 seconds). Pass `0` to disable timeout. The default value can be
5281
+ * changed by using the {@link Page.setDefaultTimeout} method.
5282
+ * @param args - Arguments to pass to `pageFunction`
5283
+ * @returns A `Promise` which resolves to a JSHandle/ElementHandle of the the
5284
+ * `pageFunction`'s return value.
5909
5285
  */
5910
- waitForFunction(pageFunction: Function | string, options?: {
5286
+ waitForFunction<Params extends unknown[], Func extends EvaluateFunc<Params> = EvaluateFunc<Params>>(pageFunction: Func | string, options?: {
5911
5287
  timeout?: number;
5912
5288
  polling?: string | number;
5913
- }, ...args: SerializableOrJSHandle[]): Promise<JSHandle>;
5289
+ }, ...args: Params): Promise<HandleFor<Awaited<ReturnType<Func>>>>;
5914
5290
  }
5915
5291
 
5916
- /**
5917
- * @internal
5918
- */
5919
- export declare interface PageBinding {
5920
- name: string;
5921
- pptrFunction: Function;
5922
- }
5292
+ /* Excluded from this release type: PageBinding */
5293
+
5294
+ /* Excluded from this release type: pageBindingDeliverErrorString */
5295
+
5296
+ /* Excluded from this release type: pageBindingDeliverErrorValueString */
5297
+
5298
+ /* Excluded from this release type: pageBindingDeliverResultString */
5299
+
5300
+ /* Excluded from this release type: pageBindingInitString */
5923
5301
 
5924
5302
  /**
5925
5303
  * All the events that a page instance may emit.
@@ -5937,13 +5315,12 @@ export declare class HTTPResponse {
5937
5315
  * error or a warning.
5938
5316
  *
5939
5317
  * @remarks
5940
- *
5941
5318
  * A `console` event provides a {@link ConsoleMessage} representing the
5942
5319
  * console message that was logged.
5943
5320
  *
5944
5321
  * @example
5945
5322
  * An example of handling `console` event:
5946
- * ```js
5323
+ * ```ts
5947
5324
  * page.on('console', msg => {
5948
5325
  * for (let i = 0; i < msg.args().length; ++i)
5949
5326
  * console.log(`${i}: ${msg.args()[i]}`);
@@ -5960,7 +5337,8 @@ export declare class HTTPResponse {
5960
5337
  Dialog = "dialog",
5961
5338
  /**
5962
5339
  * Emitted when the JavaScript
5963
- * {@link https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded | DOMContentLoaded } event is dispatched.
5340
+ * {@link https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded | DOMContentLoaded }
5341
+ * event is dispatched.
5964
5342
  */
5965
5343
  DOMContentLoaded = "domcontentloaded",
5966
5344
  /**
@@ -5971,7 +5349,10 @@ export declare class HTTPResponse {
5971
5349
  FrameAttached = "frameattached",
5972
5350
  /** Emitted when a frame is detached. Will contain a {@link Frame}. */
5973
5351
  FrameDetached = "framedetached",
5974
- /** Emitted when a frame is navigated to a new URL. Will contain a {@link Frame}. */
5352
+ /**
5353
+ * Emitted when a frame is navigated to a new URL. Will contain a
5354
+ * {@link Frame}.
5355
+ */
5975
5356
  FrameNavigated = "framenavigated",
5976
5357
  /**
5977
5358
  * Emitted when the JavaScript
@@ -6002,14 +5383,14 @@ export declare class HTTPResponse {
6002
5383
  *
6003
5384
  * @example
6004
5385
  *
6005
- * ```js
5386
+ * ```ts
6006
5387
  * const [popup] = await Promise.all([
6007
5388
  * new Promise(resolve => page.once('popup', resolve)),
6008
5389
  * page.click('a[target=_blank]'),
6009
5390
  * ]);
6010
5391
  * ```
6011
5392
  *
6012
- * ```js
5393
+ * ```ts
6013
5394
  * const [popup] = await Promise.all([
6014
5395
  * new Promise(resolve => page.once('popup', resolve)),
6015
5396
  * page.evaluate(() => window.open('https://example.com')),
@@ -6039,10 +5420,9 @@ export declare class HTTPResponse {
6039
5420
  * Contains a {@link HTTPRequest}.
6040
5421
  *
6041
5422
  * @remarks
6042
- *
6043
- * NOTE: HTTP Error responses, such as 404 or 503, are still successful
6044
- * responses from HTTP standpoint, so request will complete with
6045
- * `requestfinished` event and not with `requestfailed`.
5423
+ * HTTP Error responses, such as 404 or 503, are still successful responses
5424
+ * from HTTP standpoint, so request will complete with `requestfinished` event
5425
+ * and not with `requestfailed`.
6046
5426
  */
6047
5427
  RequestFailed = "requestfailed",
6048
5428
  /**
@@ -6131,18 +5511,9 @@ export declare class HTTPResponse {
6131
5511
  */
6132
5512
  export declare type PaperFormat = Uppercase<LowerCasePaperFormat> | Capitalize<LowerCasePaperFormat> | LowerCasePaperFormat;
6133
5513
 
6134
- /**
6135
- * @internal
6136
- */
6137
- export declare interface PaperFormatDimensions {
6138
- width: number;
6139
- height: number;
6140
- }
5514
+ /* Excluded from this release type: PaperFormatDimensions */
6141
5515
 
6142
- /**
6143
- * @internal
6144
- */
6145
- export declare const paperFormats: Record<LowerCasePaperFormat, PaperFormatDimensions>;
5516
+ /* Excluded from this release type: _paperFormats */
6146
5517
 
6147
5518
  /**
6148
5519
  * Copyright 2020 Google Inc. All rights reserved.
@@ -6270,8 +5641,11 @@ export declare class HTTPResponse {
6270
5641
  */
6271
5642
  export declare type Permission = 'geolocation' | 'midi' | 'notifications' | 'camera' | 'microphone' | 'background-sync' | 'ambient-light-sensor' | 'accelerometer' | 'gyroscope' | 'magnetometer' | 'accessibility-events' | 'clipboard-read' | 'clipboard-write' | 'payment-handler' | 'persistent-storage' | 'idle-detection' | 'midi-sysex';
6272
5643
 
5644
+ /* Excluded from this release type: PipeTransport */
5645
+
6273
5646
  /**
6274
5647
  * Supported platforms.
5648
+ *
6275
5649
  * @public
6276
5650
  */
6277
5651
  export declare type Platform = 'linux' | 'mac' | 'mac_arm' | 'win32' | 'win64';
@@ -6284,13 +5658,6 @@ export declare class HTTPResponse {
6284
5658
  y: number;
6285
5659
  }
6286
5660
 
6287
- /**
6288
- * @public
6289
- */
6290
- export declare type PredefinedNetworkConditions = {
6291
- [name: string]: NetworkConditions;
6292
- };
6293
-
6294
5661
  /**
6295
5662
  * @public
6296
5663
  */
@@ -6366,10 +5733,7 @@ export declare class HTTPResponse {
6366
5733
  export declare class Puppeteer {
6367
5734
  protected _isPuppeteerCore: boolean;
6368
5735
  protected _changedProduct: boolean;
6369
- /**
6370
- * @internal
6371
- */
6372
- constructor(settings: CommonPuppeteerSettings);
5736
+ /* Excluded from this release type: __constructor */
6373
5737
  /**
6374
5738
  * This method attaches Puppeteer to an existing browser instance.
6375
5739
  *
@@ -6380,118 +5744,83 @@ export declare class HTTPResponse {
6380
5744
  */
6381
5745
  connect(options: ConnectOptions): Promise<Browser>;
6382
5746
  /**
6383
- * @remarks
6384
- * A list of devices to be used with `page.emulate(options)`. Actual list of devices can be found in {@link https://github.com/puppeteer/puppeteer/blob/main/src/common/DeviceDescriptors.ts | src/common/DeviceDescriptors.ts}.
6385
- *
5747
+ * @deprecated Import directly puppeteer.
6386
5748
  * @example
6387
- *
6388
- * ```js
6389
- * const puppeteer = require('puppeteer');
6390
- * const iPhone = puppeteer.devices['iPhone 6'];
6391
- *
6392
- * (async () => {
6393
- * const browser = await puppeteer.launch();
6394
- * const page = await browser.newPage();
6395
- * await page.emulate(iPhone);
6396
- * await page.goto('https://www.google.com');
6397
- * // other actions...
6398
- * await browser.close();
6399
- * })();
5749
+ * ```ts
5750
+ * import { devices } from 'puppeteer';
6400
5751
  * ```
6401
- *
6402
5752
  */
6403
- get devices(): DevicesMap;
5753
+ get devices(): typeof devices;
6404
5754
  /**
6405
- * @remarks
6406
- *
6407
- * Puppeteer methods might throw errors if they are unable to fulfill a request.
6408
- * For example, `page.waitForSelector(selector[, options])` might fail if
6409
- * the selector doesn't match any nodes during the given timeframe.
6410
- *
6411
- * For certain types of errors Puppeteer uses specific error classes.
6412
- * These classes are available via `puppeteer.errors`.
6413
- *
5755
+ * @deprecated Import directly puppeteer.
6414
5756
  * @example
6415
- * An example of handling a timeout error:
6416
- * ```js
6417
- * try {
6418
- * await page.waitForSelector('.foo');
6419
- * } catch (e) {
6420
- * if (e instanceof puppeteer.errors.TimeoutError) {
6421
- * // Do something if this is a timeout.
6422
- * }
6423
- * }
5757
+ * ```ts
5758
+ * import { errors } from 'puppeteer';
6424
5759
  * ```
6425
5760
  */
6426
- get errors(): PuppeteerErrors;
5761
+ get errors(): typeof errors;
6427
5762
  /**
6428
- * @remarks
6429
- * Returns a list of network conditions to be used with `page.emulateNetworkConditions(networkConditions)`. Actual list of predefined conditions can be found in {@link https://github.com/puppeteer/puppeteer/blob/main/src/common/NetworkConditions.ts | src/common/NetworkConditions.ts}.
6430
- *
5763
+ * @deprecated Import directly puppeteer.
6431
5764
  * @example
6432
- *
6433
- * ```js
6434
- * const puppeteer = require('puppeteer');
6435
- * const slow3G = puppeteer.networkConditions['Slow 3G'];
6436
- *
6437
- * (async () => {
6438
- * const browser = await puppeteer.launch();
6439
- * const page = await browser.newPage();
6440
- * await page.emulateNetworkConditions(slow3G);
6441
- * await page.goto('https://www.google.com');
6442
- * // other actions...
6443
- * await browser.close();
6444
- * })();
5765
+ * ```ts
5766
+ * import { networkConditions } from 'puppeteer';
6445
5767
  * ```
6446
- *
6447
5768
  */
6448
- get networkConditions(): PredefinedNetworkConditions;
5769
+ get networkConditions(): typeof networkConditions;
6449
5770
  /**
6450
- * Registers a {@link CustomQueryHandler | custom query handler}. After
6451
- * registration, the handler can be used everywhere where a selector is
6452
- * expected by prepending the selection string with `<name>/`. The name is
6453
- * only allowed to consist of lower- and upper case latin letters.
5771
+ * @deprecated Import directly puppeteer.
6454
5772
  * @example
5773
+ * ```ts
5774
+ * import { registerCustomQueryHandler } from 'puppeteer';
6455
5775
  * ```
6456
- * puppeteer.registerCustomQueryHandler('text', { … });
6457
- * const aHandle = await page.$('text/…');
6458
- * ```
6459
- * @param name - The name that the custom query handler will be registered under.
6460
- * @param queryHandler - The {@link CustomQueryHandler | custom query handler} to
6461
- * register.
6462
5776
  */
6463
5777
  registerCustomQueryHandler(name: string, queryHandler: CustomQueryHandler): void;
6464
5778
  /**
6465
- * @param name - The name of the query handler to unregistered.
5779
+ * @deprecated Import directly puppeteer.
5780
+ * @example
5781
+ * ```ts
5782
+ * import { unregisterCustomQueryHandler } from 'puppeteer';
5783
+ * ```
6466
5784
  */
6467
5785
  unregisterCustomQueryHandler(name: string): void;
6468
5786
  /**
6469
- * @returns a list with the names of all registered custom query handlers.
5787
+ * @deprecated Import directly puppeteer.
5788
+ * @example
5789
+ * ```ts
5790
+ * import { customQueryHandlerNames } from 'puppeteer';
5791
+ * ```
6470
5792
  */
6471
5793
  customQueryHandlerNames(): string[];
6472
5794
  /**
6473
- * Clears all registered handlers.
5795
+ * @deprecated Import directly puppeteer.
5796
+ * @example
5797
+ * ```ts
5798
+ * import { clearCustomQueryHandlers } from 'puppeteer';
5799
+ * ```
6474
5800
  */
6475
5801
  clearCustomQueryHandlers(): void;
6476
5802
  }
6477
5803
 
6478
- /**
6479
- * @public
6480
- */
6481
- export declare type PuppeteerErrors = Record<string, typeof CustomError>;
5804
+ /* Excluded from this release type: PUPPETEER_REVISIONS */
5805
+
5806
+ /* Excluded from this release type: puppeteerDirname */
6482
5807
 
6483
5808
  /**
6484
5809
  * @public
6485
5810
  */
6486
- export declare const puppeteerErrors: PuppeteerErrors;
5811
+ export declare interface PuppeteerErrors {
5812
+ TimeoutError: typeof TimeoutError;
5813
+ ProtocolError: typeof ProtocolError;
5814
+ }
5815
+
5816
+ /* Excluded from this release type: PuppeteerEventListener */
6487
5817
 
6488
5818
  /**
6489
5819
  * @public
6490
5820
  */
6491
- export declare interface PuppeteerEventListener {
6492
- emitter: CommonEventEmitter;
6493
- eventName: string | symbol;
6494
- handler: (...args: any[]) => void;
5821
+ export declare interface PuppeteerLaunchOptions extends LaunchOptions, BrowserLaunchArgumentOptions, BrowserConnectOptions {
5822
+ product?: Product;
5823
+ extraPrefsFirefox?: Record<string, unknown>;
6495
5824
  }
6496
5825
 
6497
5826
  /**
@@ -6500,14 +5829,13 @@ export declare class HTTPResponse {
6500
5829
  export declare type PuppeteerLifeCycleEvent = 'load' | 'domcontentloaded' | 'networkidle0' | 'networkidle2';
6501
5830
 
6502
5831
  /**
6503
- * Extends the main {@link Puppeteer} class with Node specific behaviour for fetching and
6504
- * downloading browsers.
5832
+ * Extends the main {@link Puppeteer} class with Node specific behaviour for
5833
+ * fetching and downloading browsers.
6505
5834
  *
6506
5835
  * If you're using Puppeteer in a Node environment, this is the class you'll get
6507
5836
  * when you run `require('puppeteer')` (or the equivalent ES `import`).
6508
5837
  *
6509
5838
  * @remarks
6510
- *
6511
5839
  * The most common method to use is {@link PuppeteerNode.launch | launch}, which
6512
5840
  * is used to launch and connect to a new browser instance.
6513
5841
  *
@@ -6516,7 +5844,7 @@ export declare class HTTPResponse {
6516
5844
  *
6517
5845
  * @example
6518
5846
  * The following is a typical example of using Puppeteer to drive automation:
6519
- * ```js
5847
+ * ```ts
6520
5848
  * const puppeteer = require('puppeteer');
6521
5849
  *
6522
5850
  * (async () => {
@@ -6535,97 +5863,79 @@ export declare class HTTPResponse {
6535
5863
  * @public
6536
5864
  */
6537
5865
  export declare class PuppeteerNode extends Puppeteer {
6538
- private _lazyLauncher?;
6539
- private _projectRoot?;
6540
- private __productName?;
6541
- /**
6542
- * @internal
6543
- */
5866
+ #private;
6544
5867
  _preferredRevision: string;
6545
- /**
6546
- * @internal
6547
- */
6548
- constructor(settings: {
6549
- projectRoot?: string;
6550
- preferredRevision: string;
6551
- productName?: Product;
6552
- } & CommonPuppeteerSettings);
5868
+ /* Excluded from this release type: __constructor */
6553
5869
  /**
6554
5870
  * This method attaches Puppeteer to an existing browser instance.
6555
5871
  *
6556
- * @remarks
6557
- *
6558
5872
  * @param options - Set of configurable options to set on the browser.
6559
5873
  * @returns Promise which resolves to browser instance.
6560
5874
  */
6561
5875
  connect(options: ConnectOptions): Promise<Browser>;
5876
+ /* Excluded from this release type: _productName */
5877
+ /* Excluded from this release type: _productName */
6562
5878
  /**
6563
- * @internal
6564
- */
6565
- get _productName(): Product | undefined;
6566
- set _productName(name: Product | undefined);
6567
- /**
6568
- * Launches puppeteer and launches a browser instance with given arguments
6569
- * and options when specified.
6570
- *
6571
- * @remarks
5879
+ * Launches puppeteer and launches a browser instance with given arguments and
5880
+ * options when specified.
6572
5881
  *
6573
5882
  * @example
6574
5883
  * You can use `ignoreDefaultArgs` to filter out `--mute-audio` from default arguments:
6575
- * ```js
5884
+ * ```ts
6576
5885
  * const browser = await puppeteer.launch({
6577
5886
  * ignoreDefaultArgs: ['--mute-audio']
6578
5887
  * });
6579
5888
  * ```
6580
5889
  *
6581
- * **NOTE** Puppeteer can also be used to control the Chrome browser,
6582
- * but it works best with the version of Chromium it is bundled with.
6583
- * There is no guarantee it will work with any other version.
6584
- * Use `executablePath` option with extreme caution.
6585
- * If Google Chrome (rather than Chromium) is preferred, a {@link https://www.google.com/chrome/browser/canary.html | Chrome Canary} or {@link https://www.chromium.org/getting-involved/dev-channel | Dev Channel} build is suggested.
6586
- * In `puppeteer.launch([options])`, any mention of Chromium also applies to Chrome.
6587
- * See {@link https://www.howtogeek.com/202825/what%E2%80%99s-the-difference-between-chromium-and-chrome/ | this article} for a description of the differences between Chromium and Chrome. {@link https://chromium.googlesource.com/chromium/src/+/lkgr/docs/chromium_browser_vs_google_chrome.md | This article} describes some differences for Linux users.
5890
+ * @remarks
5891
+ * **NOTE** Puppeteer can also be used to control the Chrome browser, but it
5892
+ * works best with the version of Chromium it is bundled with. There is no
5893
+ * guarantee it will work with any other version. Use `executablePath` option
5894
+ * with extreme caution. If Google Chrome (rather than Chromium) is preferred,
5895
+ * a {@link https://www.google.com/chrome/browser/canary.html | Chrome Canary}
5896
+ * or
5897
+ * {@link https://www.chromium.org/getting-involved/dev-channel | Dev Channel}
5898
+ * build is suggested. In `puppeteer.launch([options])`, any mention of
5899
+ * Chromium also applies to Chrome. See
5900
+ * {@link https://www.howtogeek.com/202825/what%E2%80%99s-the-difference-between-chromium-and-chrome/ | this article}
5901
+ * for a description of the differences between Chromium and Chrome.
5902
+ * {@link https://chromium.googlesource.com/chromium/src/+/lkgr/docs/chromium_browser_vs_google_chrome.md | This article}
5903
+ * describes some differences for Linux users.
6588
5904
  *
6589
5905
  * @param options - Set of configurable options to set on the browser.
6590
5906
  * @returns Promise which resolves to browser instance.
6591
5907
  */
6592
- launch(options?: LaunchOptions & BrowserLaunchArgumentOptions & BrowserConnectOptions & {
6593
- product?: Product;
6594
- extraPrefsFirefox?: Record<string, unknown>;
6595
- }): Promise<Browser>;
5908
+ launch(options?: PuppeteerLaunchOptions): Promise<Browser>;
6596
5909
  /**
6597
5910
  * @remarks
5911
+ * **NOTE** `puppeteer.executablePath()` is affected by the
5912
+ * `PUPPETEER_EXECUTABLE_PATH` and `PUPPETEER_CHROMIUM_REVISION` environment
5913
+ * variables.
6598
5914
  *
6599
- * **NOTE** `puppeteer.executablePath()` is affected by the `PUPPETEER_EXECUTABLE_PATH`
6600
- * and `PUPPETEER_CHROMIUM_REVISION` environment variables.
6601
- *
6602
- * @returns A path where Puppeteer expects to find the bundled browser.
6603
- * The browser binary might not be there if the download was skipped with
6604
- * the `PUPPETEER_SKIP_DOWNLOAD` environment variable.
5915
+ * @returns A path where Puppeteer expects to find the bundled browser. The
5916
+ * browser binary might not be there if the download was skipped with the
5917
+ * `PUPPETEER_SKIP_DOWNLOAD` environment variable.
6605
5918
  */
6606
5919
  executablePath(channel?: string): string;
5920
+ /* Excluded from this release type: _launcher */
6607
5921
  /**
6608
- * @internal
6609
- */
6610
- get _launcher(): ProductLauncher;
6611
- /**
6612
- * The name of the browser that is under automation (`"chrome"` or `"firefox"`)
5922
+ * The name of the browser that is under automation (`"chrome"` or
5923
+ * `"firefox"`)
6613
5924
  *
6614
5925
  * @remarks
6615
- * The product is set by the `PUPPETEER_PRODUCT` environment variable or the `product`
6616
- * option in `puppeteer.launch([options])` and defaults to `chrome`.
5926
+ * The product is set by the `PUPPETEER_PRODUCT` environment variable or the
5927
+ * `product` option in `puppeteer.launch([options])` and defaults to `chrome`.
6617
5928
  * Firefox support is experimental.
6618
5929
  */
6619
5930
  get product(): string;
6620
5931
  /**
6621
- *
6622
5932
  * @param options - Set of configurable options to set on the browser.
6623
5933
  * @returns The default flags that Chromium will be launched with.
6624
5934
  */
6625
5935
  defaultArgs(options?: BrowserLaunchArgumentOptions): string[];
6626
5936
  /**
6627
- * @param options - Set of configurable options to specify the settings
6628
- * of the BrowserFetcher.
5937
+ * @param options - Set of configurable options to specify the settings of the
5938
+ * BrowserFetcher.
6629
5939
  * @returns A new BrowserFetcher instance.
6630
5940
  */
6631
5941
  createBrowserFetcher(options: BrowserFetcherOptions): BrowserFetcher;
@@ -6638,22 +5948,34 @@ export declare class HTTPResponse {
6638
5948
  */
6639
5949
  export declare type PuppeteerNodeLaunchOptions = BrowserLaunchArgumentOptions & LaunchOptions & BrowserConnectOptions;
6640
5950
 
6641
- declare type QueuedEventGroup = {
6642
- responseReceivedEvent: Protocol.Network.ResponseReceivedEvent;
6643
- loadingFinishedEvent?: Protocol.Network.LoadingFinishedEvent;
6644
- loadingFailedEvent?: Protocol.Network.LoadingFailedEvent;
6645
- };
5951
+ /* Excluded from this release type: QueuedEventGroup */
6646
5952
 
6647
- declare type RedirectInfo = {
6648
- event: Protocol.Network.RequestWillBeSentEvent;
6649
- fetchRequestId?: FetchRequestId;
6650
- };
5953
+ /* Excluded from this release type: RedirectInfo */
6651
5954
 
6652
5955
  /**
5956
+ * Registers a {@link CustomQueryHandler | custom query handler}.
5957
+ *
5958
+ * @remarks
5959
+ * After registration, the handler can be used everywhere where a selector is
5960
+ * expected by prepending the selection string with `<name>/`. The name is only
5961
+ * allowed to consist of lower- and upper case latin letters.
5962
+ *
5963
+ * @example
5964
+ * ```
5965
+ * puppeteer.registerCustomQueryHandler('text', { … });
5966
+ * const aHandle = await page.$('text/…');
5967
+ * ```
5968
+ *
5969
+ * @param name - The name that the custom query handler will be registered
5970
+ * under.
5971
+ * @param queryHandler - The {@link CustomQueryHandler | custom query handler}
5972
+ * to register.
5973
+ *
6653
5974
  * @public
6654
- * {@inheritDoc Puppeteer.registerCustomQueryHandler}
6655
5975
  */
6656
- export declare function registerCustomQueryHandler(name: string, queryHandler: CustomQueryHandler): void;
5976
+ export declare function registerCustomQueryHandler(name: string, handler: CustomQueryHandler): void;
5977
+
5978
+ /* Excluded from this release type: releaseObject */
6657
5979
 
6658
5980
  /**
6659
5981
  * @public
@@ -6663,6 +5985,10 @@ export declare class HTTPResponse {
6663
5985
  port?: number;
6664
5986
  }
6665
5987
 
5988
+ /* Excluded from this release type: removeEventListeners */
5989
+
5990
+ /* Excluded from this release type: resolveExecutablePath */
5991
+
6666
5992
  /**
6667
5993
  * Resource types for HTTPRequests as perceived by the rendering engine.
6668
5994
  *
@@ -6685,6 +6011,8 @@ export declare class HTTPResponse {
6685
6011
  body: string | Buffer;
6686
6012
  }
6687
6013
 
6014
+ /* Excluded from this release type: rootDirname */
6015
+
6688
6016
  /**
6689
6017
  * @public
6690
6018
  */
@@ -6734,10 +6062,15 @@ export declare class HTTPResponse {
6734
6062
  */
6735
6063
  encoding?: 'base64' | 'binary';
6736
6064
  /**
6737
- * If you need a screenshot bigger than the Viewport
6065
+ * Capture the screenshot beyond the viewport.
6738
6066
  * @defaultValue true
6739
6067
  */
6740
6068
  captureBeyondViewport?: boolean;
6069
+ /**
6070
+ * Capture the screenshot from the surface, rather than the view.
6071
+ * @defaultValue true
6072
+ */
6073
+ fromSurface?: boolean;
6741
6074
  }
6742
6075
 
6743
6076
  /**
@@ -6747,16 +6080,8 @@ export declare class HTTPResponse {
6747
6080
  * @public
6748
6081
  */
6749
6082
  export declare class SecurityDetails {
6750
- private _subjectName;
6751
- private _issuer;
6752
- private _validFrom;
6753
- private _validTo;
6754
- private _protocol;
6755
- private _sanList;
6756
- /**
6757
- * @internal
6758
- */
6759
- constructor(securityPayload: Protocol.Network.SecurityDetails);
6083
+ #private;
6084
+ /* Excluded from this release type: __constructor */
6760
6085
  /**
6761
6086
  * @returns The name of the issuer of the certificate.
6762
6087
  */
@@ -6785,16 +6110,6 @@ export declare class HTTPResponse {
6785
6110
  subjectAlternativeNames(): string[];
6786
6111
  }
6787
6112
 
6788
- /**
6789
- * @public
6790
- */
6791
- export declare type Serializable = number | string | boolean | null | BigInt | JSONArray | JSONObject;
6792
-
6793
- /**
6794
- * @public
6795
- */
6796
- export declare type SerializableOrJSHandle = Serializable | JSHandle;
6797
-
6798
6113
  /**
6799
6114
  * Represents a Node and the properties of it that are relevant to Accessibility.
6800
6115
  * @public
@@ -6881,57 +6196,27 @@ export declare class HTTPResponse {
6881
6196
  * Root node to get the accessibility tree for
6882
6197
  * @defaultValue The root node of the entire page.
6883
6198
  */
6884
- root?: ElementHandle;
6199
+ root?: ElementHandle<Node>;
6885
6200
  }
6886
6201
 
6887
6202
  /**
6888
6203
  * @public
6889
6204
  */
6890
6205
  export declare class Target {
6891
- private _targetInfo;
6892
- private _browserContext;
6893
- private _sessionFactory;
6894
- private _ignoreHTTPSErrors;
6895
- private _defaultViewport?;
6896
- private _pagePromise?;
6897
- private _workerPromise?;
6898
- private _screenshotTaskQueue;
6899
- /**
6900
- * @internal
6901
- */
6902
- _initializedPromise: Promise<boolean>;
6903
- /**
6904
- * @internal
6905
- */
6906
- _initializedCallback: (x: boolean) => void;
6907
- /**
6908
- * @internal
6909
- */
6910
- _isClosedPromise: Promise<void>;
6911
- /**
6912
- * @internal
6913
- */
6914
- _closedCallback: () => void;
6915
- /**
6916
- * @internal
6917
- */
6918
- _isInitialized: boolean;
6919
- /**
6920
- * @internal
6921
- */
6922
- _targetId: string;
6923
- /**
6924
- * @internal
6925
- */
6926
- _isPageTargetCallback: IsPageTargetCallback;
6927
- /**
6928
- * @internal
6929
- */
6930
- constructor(targetInfo: Protocol.Target.TargetInfo, browserContext: BrowserContext, sessionFactory: () => Promise<CDPSession>, ignoreHTTPSErrors: boolean, defaultViewport: Viewport | null, screenshotTaskQueue: TaskQueue, isPageTargetCallback: IsPageTargetCallback);
6206
+ #private;
6207
+ /* Excluded from this release type: _initializedPromise */
6208
+ /* Excluded from this release type: _initializedCallback */
6209
+ /* Excluded from this release type: _isClosedPromise */
6210
+ /* Excluded from this release type: _closedCallback */
6211
+ /* Excluded from this release type: _isInitialized */
6212
+ /* Excluded from this release type: _targetId */
6213
+ /* Excluded from this release type: _isPageTargetCallback */
6214
+ /* Excluded from this release type: __constructor */
6931
6215
  /**
6932
6216
  * Creates a Chrome Devtools Protocol session attached to the target.
6933
6217
  */
6934
6218
  createCDPSession(): Promise<CDPSession>;
6219
+ /* Excluded from this release type: _getTargetInfo */
6935
6220
  /**
6936
6221
  * If the target is not of type `"page"` or `"background_page"`, returns `null`.
6937
6222
  */
@@ -6960,11 +6245,8 @@ export declare class HTTPResponse {
6960
6245
  /**
6961
6246
  * Get the target that opened this target. Top-level targets return `null`.
6962
6247
  */
6963
- opener(): Target | null;
6964
- /**
6965
- * @internal
6966
- */
6967
- _targetInfoChanged(targetInfo: Protocol.Target.TargetInfo): void;
6248
+ opener(): Target | undefined;
6249
+ /* Excluded from this release type: _targetInfoChanged */
6968
6250
  }
6969
6251
 
6970
6252
  /**
@@ -6972,79 +6254,32 @@ export declare class HTTPResponse {
6972
6254
  */
6973
6255
  export declare type TargetFilterCallback = (target: Protocol.Target.TargetInfo) => boolean;
6974
6256
 
6975
- /**
6976
- * Copyright 2020 Google Inc. All rights reserved.
6977
- *
6978
- * Licensed under the Apache License, Version 2.0 (the "License");
6979
- * you may not use this file except in compliance with the License.
6980
- * You may obtain a copy of the License at
6981
- *
6982
- * http://www.apache.org/licenses/LICENSE-2.0
6983
- *
6984
- * Unless required by applicable law or agreed to in writing, software
6985
- * distributed under the License is distributed on an "AS IS" BASIS,
6986
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
6987
- * See the License for the specific language governing permissions and
6988
- * limitations under the License.
6989
- */
6990
- declare class TaskQueue {
6991
- private _chain;
6992
- constructor();
6993
- postTask<T>(task: () => Promise<T>): Promise<T>;
6994
- }
6257
+ /* Excluded from this release type: TaskQueue */
6995
6258
 
6996
6259
  /**
6997
- * TimeoutError is emitted whenever certain operations are terminated due to timeout.
6260
+ * TimeoutError is emitted whenever certain operations are terminated due to
6261
+ * timeout.
6998
6262
  *
6999
6263
  * @remarks
7000
- *
7001
- * Example operations are {@link Page.waitForSelector | page.waitForSelector}
7002
- * or {@link PuppeteerNode.launch | puppeteer.launch}.
6264
+ * Example operations are {@link Page.waitForSelector | page.waitForSelector} or
6265
+ * {@link PuppeteerNode.launch | puppeteer.launch}.
7003
6266
  *
7004
6267
  * @public
7005
6268
  */
7006
6269
  export declare class TimeoutError extends CustomError {
7007
6270
  }
7008
6271
 
7009
- /**
7010
- * Copyright 2019 Google Inc. All rights reserved.
7011
- *
7012
- * Licensed under the Apache License, Version 2.0 (the "License");
7013
- * you may not use this file except in compliance with the License.
7014
- * You may obtain a copy of the License at
7015
- *
7016
- * http://www.apache.org/licenses/LICENSE-2.0
7017
- *
7018
- * Unless required by applicable law or agreed to in writing, software
7019
- * distributed under the License is distributed on an "AS IS" BASIS,
7020
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
7021
- * See the License for the specific language governing permissions and
7022
- * limitations under the License.
7023
- */
7024
- /**
7025
- * @internal
7026
- */
7027
- export declare class TimeoutSettings {
7028
- _defaultTimeout: number | null;
7029
- _defaultNavigationTimeout: number | null;
7030
- constructor();
7031
- setDefaultTimeout(timeout: number): void;
7032
- setDefaultNavigationTimeout(timeout: number): void;
7033
- navigationTimeout(): number;
7034
- timeout(): number;
7035
- }
6272
+ /* Excluded from this release type: TimeoutSettings */
6273
+
6274
+ /* Excluded from this release type: tmpdir */
7036
6275
 
7037
6276
  /**
7038
6277
  * The Touchscreen class exposes touchscreen events.
7039
6278
  * @public
7040
6279
  */
7041
6280
  export declare class Touchscreen {
7042
- private _client;
7043
- private _keyboard;
7044
- /**
7045
- * @internal
7046
- */
7047
- constructor(client: CDPSession, keyboard: Keyboard);
6281
+ #private;
6282
+ /* Excluded from this release type: __constructor */
7048
6283
  /**
7049
6284
  * Dispatches a `touchstart` and `touchend` event.
7050
6285
  * @param x - Horizontal position of the tap.
@@ -7060,7 +6295,7 @@ export declare class HTTPResponse {
7060
6295
  * which can be opened in Chrome DevTools or {@link https://chromedevtools.github.io/timeline-viewer/ | timeline viewer}.
7061
6296
  *
7062
6297
  * @example
7063
- * ```js
6298
+ * ```ts
7064
6299
  * await page.tracing.start({path: 'trace.json'});
7065
6300
  * await page.goto('https://www.google.com');
7066
6301
  * await page.tracing.stop();
@@ -7069,17 +6304,13 @@ export declare class HTTPResponse {
7069
6304
  * @public
7070
6305
  */
7071
6306
  export declare class Tracing {
7072
- _client: CDPSession;
7073
- _recording: boolean;
7074
- _path: string;
7075
- /**
7076
- * @internal
7077
- */
7078
- constructor(client: CDPSession);
6307
+ #private;
6308
+ /* Excluded from this release type: __constructor */
7079
6309
  /**
7080
6310
  * Starts a trace for the current page.
7081
6311
  * @remarks
7082
6312
  * Only one trace can be active at a time per browser.
6313
+ *
7083
6314
  * @param options - Optional `TracingOptions`.
7084
6315
  */
7085
6316
  start(options?: TracingOptions): Promise<void>;
@@ -7087,7 +6318,7 @@ export declare class HTTPResponse {
7087
6318
  * Stops a trace started with the `start` method.
7088
6319
  * @returns Promise which resolves to buffer with trace data.
7089
6320
  */
7090
- stop(): Promise<Buffer>;
6321
+ stop(): Promise<Buffer | undefined>;
7091
6322
  }
7092
6323
 
7093
6324
  /**
@@ -7100,21 +6331,13 @@ export declare class HTTPResponse {
7100
6331
  }
7101
6332
 
7102
6333
  /**
6334
+ * @param name - The name of the query handler to unregistered.
6335
+ *
7103
6336
  * @public
7104
- * {@inheritDoc Puppeteer.unregisterCustomQueryHandler}
7105
6337
  */
7106
6338
  export declare function unregisterCustomQueryHandler(name: string): void;
7107
6339
 
7108
- /**
7109
- * Unwraps a DOM element out of an ElementHandle instance
7110
- * @public
7111
- **/
7112
- export declare type UnwrapElementHandle<X> = X extends ElementHandle<infer E> ? E : X;
7113
-
7114
- /**
7115
- * @public
7116
- */
7117
- export declare type UnwrapPromiseLike<T> = T extends PromiseLike<infer U> ? U : T;
6340
+ /* Excluded from this release type: valueFromRemoteObject */
7118
6341
 
7119
6342
  /**
7120
6343
  * Copyright 2020 Google Inc. All rights reserved.
@@ -7168,6 +6391,8 @@ export declare class HTTPResponse {
7168
6391
  hasTouch?: boolean;
7169
6392
  }
7170
6393
 
6394
+ /* Excluded from this release type: waitForEvent */
6395
+
7171
6396
  /**
7172
6397
  * @public
7173
6398
  */
@@ -7192,7 +6417,7 @@ export declare class HTTPResponse {
7192
6417
  visible?: boolean;
7193
6418
  hidden?: boolean;
7194
6419
  timeout?: number;
7195
- root?: ElementHandle;
6420
+ root?: ElementHandle<Node>;
7196
6421
  }
7197
6422
 
7198
6423
  /**
@@ -7206,44 +6431,9 @@ export declare class HTTPResponse {
7206
6431
  timeout?: number;
7207
6432
  }
7208
6433
 
7209
- /**
7210
- * @internal
7211
- */
7212
- export declare class WaitTask {
7213
- _domWorld: DOMWorld;
7214
- _polling: string | number;
7215
- _timeout: number;
7216
- _predicateBody: string;
7217
- _predicateAcceptsContextElement: boolean;
7218
- _args: SerializableOrJSHandle[];
7219
- _binding: PageBinding;
7220
- _runCount: number;
7221
- promise: Promise<JSHandle>;
7222
- _resolve: (x: JSHandle) => void;
7223
- _reject: (x: Error) => void;
7224
- _timeoutTimer?: NodeJS.Timeout;
7225
- _terminated: boolean;
7226
- _root: ElementHandle;
7227
- constructor(options: WaitTaskOptions);
7228
- terminate(error: Error): void;
7229
- rerun(): Promise<void>;
7230
- _cleanup(): void;
7231
- }
6434
+ /* Excluded from this release type: WaitTask */
7232
6435
 
7233
- /**
7234
- * @internal
7235
- */
7236
- export declare interface WaitTaskOptions {
7237
- domWorld: DOMWorld;
7238
- predicateBody: Function | string;
7239
- predicateAcceptsContextElement: boolean;
7240
- title: string;
7241
- polling: string | number;
7242
- timeout: number;
7243
- binding?: PageBinding;
7244
- args: SerializableOrJSHandle[];
7245
- root?: ElementHandle;
7246
- }
6436
+ /* Excluded from this release type: WaitTaskOptions */
7247
6437
 
7248
6438
  /**
7249
6439
  * @public
@@ -7260,6 +6450,8 @@ export declare class HTTPResponse {
7260
6450
  timeout?: number;
7261
6451
  }
7262
6452
 
6453
+ /* Excluded from this release type: waitWithTimeout */
6454
+
7263
6455
  /**
7264
6456
  * The WebWorker class represents a
7265
6457
  * {@link https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API | WebWorker}.
@@ -7269,7 +6461,7 @@ export declare class HTTPResponse {
7269
6461
  * object to signal the worker lifecycle.
7270
6462
  *
7271
6463
  * @example
7272
- * ```js
6464
+ * ```ts
7273
6465
  * page.on('workercreated', worker => console.log('Worker created: ' + worker.url()));
7274
6466
  * page.on('workerdestroyed', worker => console.log('Worker destroyed: ' + worker.url()));
7275
6467
  *
@@ -7282,15 +6474,8 @@ export declare class HTTPResponse {
7282
6474
  * @public
7283
6475
  */
7284
6476
  export declare class WebWorker extends EventEmitter {
7285
- _client: CDPSession;
7286
- _url: string;
7287
- _executionContextPromise: Promise<ExecutionContext>;
7288
- _executionContextCallback: (value: ExecutionContext) => void;
7289
- /**
7290
- *
7291
- * @internal
7292
- */
7293
- constructor(client: CDPSession, url: string, consoleAPICalled: ConsoleAPICalledCallback, exceptionThrown: ExceptionThrownCallback);
6477
+ #private;
6478
+ /* Excluded from this release type: __constructor */
7294
6479
  /**
7295
6480
  * @returns The URL of this web worker.
7296
6481
  */
@@ -7314,7 +6499,7 @@ export declare class HTTPResponse {
7314
6499
  * @param args - Arguments to pass to `pageFunction`.
7315
6500
  * @returns Promise which resolves to the return value of `pageFunction`.
7316
6501
  */
7317
- evaluate<ReturnType>(pageFunction: Function | string, ...args: any[]): Promise<ReturnType>;
6502
+ evaluate<Params extends unknown[], Func extends EvaluateFunc<Params> = EvaluateFunc<Params>>(pageFunction: Func | string, ...args: Params): Promise<Awaited<ReturnType<Func>>>;
7318
6503
  /**
7319
6504
  * The only difference between `worker.evaluate` and `worker.evaluateHandle`
7320
6505
  * is that `worker.evaluateHandle` returns in-page object (JSHandle). If the
@@ -7327,16 +6512,7 @@ export declare class HTTPResponse {
7327
6512
  * @param args - Arguments to pass to `pageFunction`.
7328
6513
  * @returns Promise which resolves to the return value of `pageFunction`.
7329
6514
  */
7330
- evaluateHandle<HandlerType extends JSHandle = JSHandle>(pageFunction: EvaluateHandleFn, ...args: SerializableOrJSHandle[]): Promise<JSHandle>;
6515
+ evaluateHandle<Params extends unknown[], Func extends EvaluateFunc<Params> = EvaluateFunc<Params>>(pageFunction: Func | string, ...args: Params): Promise<HandleFor<Awaited<ReturnType<Func>>>>;
7331
6516
  }
7332
6517
 
7333
- /**
7334
- * Wraps a DOM element into an ElementHandle instance
7335
- * @public
7336
- **/
7337
- export declare type WrapElementHandle<X> = X extends Element ? ElementHandle<X> : X;
7338
-
7339
-
7340
- export * from "devtools-protocol/types/protocol";
7341
-
7342
6518
  export { }