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.
- package/config/gni/devtools_grd_files.gni +15 -10
- package/front_end/.eslintrc.js +1 -0
- package/front_end/core/i18n/locales/en-US.json +118 -4
- package/front_end/core/i18n/locales/en-XL.json +118 -4
- package/front_end/models/bindings/DebuggerLanguagePlugins.ts +8 -0
- package/front_end/panels/application/components/FrameDetailsView.ts +3 -2
- package/front_end/panels/application/components/Prerender2.ts +188 -0
- package/front_end/panels/elements/CSSRuleValidator.ts +103 -13
- package/front_end/panels/elements/ElementsTreeElement.ts +3 -1
- package/front_end/panels/elements/StylePropertyTreeElement.ts +10 -8
- package/front_end/panels/elements/components/CSSHintDetailsView.ts +71 -0
- package/front_end/panels/elements/components/components.ts +2 -0
- package/front_end/panels/elements/components/cssHintDetailsView.css +36 -0
- package/front_end/panels/elements/stylesSectionTree.css +1 -1
- package/front_end/panels/network/components/RequestHeadersView.ts +2 -1
- package/front_end/services/puppeteer/PuppeteerConnection.ts +3 -5
- package/front_end/third_party/lit-html/directives.ts +1 -0
- package/front_end/third_party/lit-html/lit-html-tsconfig.json +1 -0
- package/front_end/third_party/puppeteer/package/README.md +136 -214
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Accessibility.d.ts +6 -6
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Accessibility.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Accessibility.js +149 -85
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Accessibility.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/AriaQueryHandler.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/AriaQueryHandler.js +34 -10
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/AriaQueryHandler.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Browser.d.ts +17 -36
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Browser.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Browser.js +217 -160
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Browser.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/BrowserConnector.d.ts +5 -4
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/BrowserConnector.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/BrowserConnector.js +18 -13
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/BrowserConnector.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/BrowserWebSocketTransport.d.ts +4 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/BrowserWebSocketTransport.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/BrowserWebSocketTransport.js +30 -11
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/BrowserWebSocketTransport.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Connection.d.ts +21 -20
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Connection.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Connection.js +125 -82
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Connection.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ConsoleMessage.d.ts +1 -4
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ConsoleMessage.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ConsoleMessage.js +27 -9
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ConsoleMessage.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Coverage.d.ts +6 -30
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Coverage.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Coverage.js +167 -131
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Coverage.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/DOMWorld.d.ts +36 -67
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/DOMWorld.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/DOMWorld.js +359 -215
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/DOMWorld.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Debug.d.ts +8 -4
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Debug.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Debug.js +9 -6
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Debug.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/DeviceDescriptors.d.ts +21 -2
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/DeviceDescriptors.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/DeviceDescriptors.js +26 -6
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/DeviceDescriptors.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Dialog.d.ts +2 -6
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Dialog.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Dialog.js +32 -15
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Dialog.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ElementHandle.d.ts +355 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ElementHandle.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ElementHandle.js +847 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ElementHandle.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/EmulationManager.d.ts +4 -3
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/EmulationManager.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/EmulationManager.js +25 -8
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/EmulationManager.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Errors.d.ts +28 -6
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Errors.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Errors.js +27 -7
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Errors.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/EventEmitter.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/EventEmitter.js +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/EventEmitter.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ExecutionContext.d.ts +20 -19
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ExecutionContext.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ExecutionContext.js +146 -126
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/ExecutionContext.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/FileChooser.d.ts +4 -6
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/FileChooser.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/FileChooser.js +25 -10
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/FileChooser.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/FrameManager.d.ts +53 -92
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/FrameManager.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/FrameManager.js +337 -320
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/FrameManager.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/HTTPRequest.d.ts +16 -28
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/HTTPRequest.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/HTTPRequest.js +200 -147
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/HTTPRequest.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/HTTPResponse.d.ts +1 -18
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/HTTPResponse.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/HTTPResponse.js +86 -60
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/HTTPResponse.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Input.d.ts +18 -22
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Input.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Input.js +166 -117
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Input.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/JSHandle.d.ts +46 -395
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/JSHandle.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/JSHandle.js +80 -842
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/JSHandle.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/LifecycleWatcher.d.ts +4 -32
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/LifecycleWatcher.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/LifecycleWatcher.js +136 -108
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/LifecycleWatcher.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkConditions.d.ts +25 -7
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkConditions.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkConditions.js +23 -2
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkConditions.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkEventManager.d.ts +16 -11
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkEventManager.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkEventManager.js +39 -32
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkEventManager.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkManager.d.ts +2 -42
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkManager.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkManager.js +315 -316
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/NetworkManager.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/PDFOptions.d.ts +5 -3
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/PDFOptions.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/PDFOptions.js +2 -2
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/PDFOptions.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Page.d.ts +246 -287
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Page.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Page.js +841 -700
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Page.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Puppeteer.d.ts +37 -74
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Puppeteer.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Puppeteer.js +37 -89
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Puppeteer.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/QueryHandler.d.ts +38 -13
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/QueryHandler.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/QueryHandler.js +79 -29
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/QueryHandler.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/SecurityDetails.d.ts +1 -6
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/SecurityDetails.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/SecurityDetails.js +31 -12
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/SecurityDetails.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Target.d.ts +6 -9
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Target.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Target.js +80 -40
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Target.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/TaskQueue.d.ts +4 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/TaskQueue.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/TaskQueue.js +24 -3
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/TaskQueue.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/TimeoutSettings.d.ts +1 -2
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/TimeoutSettings.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/TimeoutSettings.js +28 -10
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/TimeoutSettings.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Tracing.d.ts +4 -5
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Tracing.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Tracing.js +50 -23
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Tracing.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/USKeyboardLayout.d.ts +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/USKeyboardLayout.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/USKeyboardLayout.js +2 -2
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/USKeyboardLayout.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/WebWorker.d.ts +9 -11
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/WebWorker.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/WebWorker.js +41 -31
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/WebWorker.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/assert.d.ts +4 -3
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/assert.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/assert.js +6 -8
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/assert.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/fetch.d.ts +5 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/fetch.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/fetch.js +6 -3
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/fetch.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/types.d.ts +48 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/types.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/{EvalTypes.js → types.js} +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/types.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/util.d.ts +129 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/util.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/{helper.js → util.js} +168 -87
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/util.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/compat.d.ts +3 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/compat.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/compat.js +3 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/compat.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/constants.d.ts +3 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/constants.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/constants.js +3 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/constants.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/environment.d.ts +3 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/environment.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/environment.js +3 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/environment.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/generated/version.d.ts +4 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/generated/version.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/generated/version.js +4 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/generated/version.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/{esm/puppeteer/initialize-node.d.ts → cjs/puppeteer/initializePuppeteer.d.ts} +5 -2
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/initializePuppeteer.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/{initialize-node.js → initializePuppeteer.js} +18 -14
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/initializePuppeteer.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/BrowserFetcher.d.ts +4 -11
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/BrowserFetcher.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/BrowserFetcher.js +226 -158
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/BrowserFetcher.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/BrowserRunner.d.ts +9 -11
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/BrowserRunner.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/BrowserRunner.js +116 -72
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/BrowserRunner.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/ChromeLauncher.d.ts +27 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/ChromeLauncher.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/ChromeLauncher.js +176 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/ChromeLauncher.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/FirefoxLauncher.d.ts +49 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/FirefoxLauncher.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/FirefoxLauncher.js +361 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/FirefoxLauncher.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/LaunchOptions.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/NodeWebSocketTransport.d.ts +6 -3
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/NodeWebSocketTransport.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/NodeWebSocketTransport.js +44 -12
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/NodeWebSocketTransport.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/PipeTransport.d.ts +4 -20
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/PipeTransport.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/PipeTransport.js +60 -35
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/PipeTransport.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/ProductLauncher.d.ts +31 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/ProductLauncher.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/ProductLauncher.js +166 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/ProductLauncher.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/Puppeteer.d.ts +42 -41
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/Puppeteer.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/Puppeteer.js +69 -47
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/Puppeteer.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/install.d.ts +6 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/install.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/install.js +55 -32
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/install.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/util.d.ts +10 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/util.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/util.js +40 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/util.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/puppeteer-core.d.ts +23 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/puppeteer-core.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/puppeteer-core.js +41 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/puppeteer-core.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/puppeteer.d.ts +26 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/puppeteer.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/puppeteer.js +44 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/puppeteer.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/revisions.d.ts +6 -5
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/revisions.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/revisions.js +6 -3
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/revisions.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/tsconfig.cjs.tsbuildinfo +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/tsconfig.tsbuildinfo +1 -0
- package/front_end/third_party/puppeteer/package/lib/{esm/puppeteer/api-docs-entry.js → cjs/puppeteer/types.d.ts} +46 -63
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/types.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/{api-docs-entry.js → types.js} +50 -51
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/types.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/cjs/vendor/mitt/src/index.d.ts +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/vendor/mitt/src/index.js +11 -12
- package/front_end/third_party/puppeteer/package/lib/cjs/vendor/tsconfig.cjs.tsbuildinfo +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Accessibility.d.ts +6 -6
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Accessibility.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Accessibility.js +149 -85
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Accessibility.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/AriaQueryHandler.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/AriaQueryHandler.js +34 -10
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/AriaQueryHandler.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Browser.d.ts +17 -36
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Browser.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Browser.js +217 -160
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Browser.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/BrowserConnector.d.ts +5 -4
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/BrowserConnector.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/BrowserConnector.js +16 -11
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/BrowserConnector.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/BrowserWebSocketTransport.d.ts +4 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/BrowserWebSocketTransport.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/BrowserWebSocketTransport.js +30 -11
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/BrowserWebSocketTransport.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Connection.d.ts +21 -20
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Connection.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Connection.js +125 -82
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Connection.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ConsoleMessage.d.ts +1 -4
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ConsoleMessage.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ConsoleMessage.js +27 -9
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ConsoleMessage.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Coverage.d.ts +6 -30
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Coverage.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Coverage.js +167 -131
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Coverage.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/DOMWorld.d.ts +36 -67
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/DOMWorld.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/DOMWorld.js +335 -214
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/DOMWorld.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Debug.d.ts +8 -4
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Debug.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Debug.js +9 -6
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Debug.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/DeviceDescriptors.d.ts +21 -2
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/DeviceDescriptors.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/DeviceDescriptors.js +25 -5
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/DeviceDescriptors.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Dialog.d.ts +2 -6
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Dialog.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Dialog.js +32 -15
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Dialog.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ElementHandle.d.ts +355 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ElementHandle.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ElementHandle.js +820 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ElementHandle.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EmulationManager.d.ts +4 -3
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EmulationManager.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EmulationManager.js +25 -8
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EmulationManager.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Errors.d.ts +28 -6
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Errors.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Errors.js +26 -6
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Errors.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EventEmitter.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EventEmitter.js +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EventEmitter.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ExecutionContext.d.ts +20 -19
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ExecutionContext.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ExecutionContext.js +145 -125
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/ExecutionContext.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/FileChooser.d.ts +4 -6
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/FileChooser.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/FileChooser.js +25 -10
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/FileChooser.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/FrameManager.d.ts +53 -92
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/FrameManager.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/FrameManager.js +337 -320
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/FrameManager.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/HTTPRequest.d.ts +16 -28
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/HTTPRequest.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/HTTPRequest.js +199 -146
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/HTTPRequest.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/HTTPResponse.d.ts +1 -18
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/HTTPResponse.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/HTTPResponse.js +86 -60
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/HTTPResponse.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Input.d.ts +18 -22
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Input.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Input.js +167 -118
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Input.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/JSHandle.d.ts +46 -395
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/JSHandle.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/JSHandle.js +80 -817
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/JSHandle.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/LifecycleWatcher.d.ts +4 -32
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/LifecycleWatcher.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/LifecycleWatcher.js +135 -107
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/LifecycleWatcher.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkConditions.d.ts +25 -7
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkConditions.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkConditions.js +23 -2
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkConditions.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkEventManager.d.ts +16 -11
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkEventManager.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkEventManager.js +39 -32
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkEventManager.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkManager.d.ts +2 -42
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkManager.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkManager.js +312 -313
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/NetworkManager.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/PDFOptions.d.ts +5 -3
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/PDFOptions.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/PDFOptions.js +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/PDFOptions.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Page.d.ts +246 -287
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Page.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Page.js +819 -701
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Page.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Puppeteer.d.ts +37 -74
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Puppeteer.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Puppeteer.js +39 -91
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Puppeteer.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/QueryHandler.d.ts +38 -13
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/QueryHandler.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/QueryHandler.js +79 -29
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/QueryHandler.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/SecurityDetails.d.ts +1 -6
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/SecurityDetails.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/SecurityDetails.js +31 -12
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/SecurityDetails.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Target.d.ts +6 -9
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Target.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Target.js +80 -40
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Target.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/TaskQueue.d.ts +4 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/TaskQueue.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/TaskQueue.js +24 -3
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/TaskQueue.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/TimeoutSettings.d.ts +1 -2
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/TimeoutSettings.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/TimeoutSettings.js +28 -10
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/TimeoutSettings.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Tracing.d.ts +4 -5
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Tracing.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Tracing.js +50 -23
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Tracing.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/USKeyboardLayout.d.ts +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/USKeyboardLayout.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/USKeyboardLayout.js +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/USKeyboardLayout.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/WebWorker.d.ts +9 -11
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/WebWorker.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/WebWorker.js +41 -31
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/WebWorker.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/assert.d.ts +4 -3
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/assert.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/assert.js +5 -6
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/assert.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/fetch.d.ts +5 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/fetch.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/fetch.js +6 -3
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/fetch.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/types.d.ts +48 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/types.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/{EvalTypes.js → types.js} +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/types.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/util.d.ts +129 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/util.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/{helper.js → util.js} +161 -100
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/util.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/compat.d.ts +3 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/compat.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/compat.js +3 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/compat.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/constants.d.ts +3 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/constants.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/constants.js +3 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/constants.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/environment.d.ts +3 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/environment.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/environment.js +3 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/environment.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/generated/version.d.ts +4 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/generated/version.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/generated/version.js +4 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/generated/version.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/{cjs/puppeteer/initialize-node.d.ts → esm/puppeteer/initializePuppeteer.d.ts} +5 -2
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/initializePuppeteer.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/{initialize-node.js → initializePuppeteer.js} +16 -12
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/initializePuppeteer.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/BrowserFetcher.d.ts +4 -11
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/BrowserFetcher.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/BrowserFetcher.js +226 -158
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/BrowserFetcher.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/BrowserRunner.d.ts +9 -11
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/BrowserRunner.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/BrowserRunner.js +113 -69
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/BrowserRunner.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/ChromeLauncher.d.ts +27 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/ChromeLauncher.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/ChromeLauncher.js +169 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/ChromeLauncher.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/FirefoxLauncher.d.ts +49 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/FirefoxLauncher.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/{Launcher.js → FirefoxLauncher.js} +51 -345
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/FirefoxLauncher.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/LaunchOptions.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/NodeWebSocketTransport.d.ts +6 -3
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/NodeWebSocketTransport.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/NodeWebSocketTransport.js +44 -12
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/NodeWebSocketTransport.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/PipeTransport.d.ts +4 -20
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/PipeTransport.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/PipeTransport.js +60 -35
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/PipeTransport.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/ProductLauncher.d.ts +31 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/ProductLauncher.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/ProductLauncher.js +157 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/ProductLauncher.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/Puppeteer.d.ts +42 -41
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/Puppeteer.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/Puppeteer.js +70 -45
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/Puppeteer.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/install.d.ts +6 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/install.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/install.js +53 -30
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/install.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/util.d.ts +10 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/util.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/util.js +13 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/util.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/puppeteer-core.d.ts +23 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/puppeteer-core.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/{node-puppeteer-core.d.ts → puppeteer-core.js} +8 -2
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/puppeteer-core.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/puppeteer.d.ts +26 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/puppeteer.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/{cjs/puppeteer/node-puppeteer-core.d.ts → esm/puppeteer/puppeteer.js} +11 -2
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/puppeteer.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/revisions.d.ts +6 -5
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/revisions.d.ts.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/revisions.js +6 -3
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/revisions.js.map +1 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/tsconfig.esm.tsbuildinfo +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/tsconfig.tsbuildinfo +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/types.d.ts +64 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/types.d.ts.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/types.js +68 -0
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/types.js.map +1 -0
- package/front_end/third_party/puppeteer/package/lib/esm/vendor/mitt/src/index.d.ts +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/vendor/mitt/src/index.js +9 -10
- package/front_end/third_party/puppeteer/package/lib/esm/vendor/tsconfig.esm.tsbuildinfo +1 -0
- package/front_end/third_party/puppeteer/package/lib/types.d.ts +846 -1670
- package/front_end/third_party/puppeteer/package/package.json +65 -68
- package/front_end/third_party/puppeteer/package/typescript-if-required.js +17 -8
- package/front_end/third_party/puppeteer/puppeteer.ts +7 -14
- package/front_end/ui/components/linear_memory_inspector/LinearMemoryInspector.ts +2 -5
- package/front_end/ui/components/linear_memory_inspector/LinearMemoryInspectorController.ts +22 -2
- package/front_end/ui/components/linear_memory_inspector/LinearMemoryInspectorPane.ts +40 -12
- package/front_end/ui/components/linear_memory_inspector/LinearMemoryViewer.ts +5 -5
- package/front_end/ui/legacy/components/utils/Linkifier.ts +3 -1
- package/package.json +1 -1
- package/scripts/eslint_rules/lib/inject_checkbox_styles.js +4 -2
- package/scripts/eslint_rules/tests/inject_checkbox_styles_test.js +45 -5
- package/front_end/third_party/puppeteer/package/cjs-entry-core.js +0 -29
- package/front_end/third_party/puppeteer/package/cjs-entry.js +0 -29
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/api-docs-entry.d.ts +0 -111
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/api-docs-entry.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/api-docs-entry.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/EvalTypes.d.ts +0 -61
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/EvalTypes.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/EvalTypes.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Events.d.ts +0 -82
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Events.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Events.js +0 -87
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/Events.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/helper.d.ts +0 -85
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/helper.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/common/helper.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/initialize-node.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/initialize-node.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/initialize-web.d.ts +0 -18
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/initialize-web.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/initialize-web.js +0 -27
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/initialize-web.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/Launcher.d.ts +0 -18
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/Launcher.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/Launcher.js +0 -674
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node/Launcher.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node-puppeteer-core.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node-puppeteer-core.js +0 -25
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node-puppeteer-core.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node.d.ts +0 -18
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node.js +0 -24
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/node.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/web.d.ts +0 -18
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/web.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/web.js +0 -24
- package/front_end/third_party/puppeteer/package/lib/cjs/puppeteer/web.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/vendor/mitt/src/index.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/cjs/vendor/mitt/src/index.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/api-docs-entry.d.ts +0 -111
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/api-docs-entry.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/api-docs-entry.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EvalTypes.d.ts +0 -61
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EvalTypes.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/EvalTypes.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Events.d.ts +0 -82
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Events.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Events.js +0 -84
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/Events.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/helper.d.ts +0 -85
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/helper.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/common/helper.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/initialize-node.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/initialize-node.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/initialize-web.d.ts +0 -18
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/initialize-web.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/initialize-web.js +0 -23
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/initialize-web.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/Launcher.d.ts +0 -18
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/Launcher.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node/Launcher.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node-puppeteer-core.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node-puppeteer-core.js +0 -23
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node-puppeteer-core.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node.d.ts +0 -18
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node.js +0 -22
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/node.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/web.d.ts +0 -18
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/web.d.ts.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/web.js +0 -22
- package/front_end/third_party/puppeteer/package/lib/esm/puppeteer/web.js.map +0 -1
- package/front_end/third_party/puppeteer/package/lib/esm/vendor/mitt/src/index.d.ts.map +0 -1
- 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
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
89
|
-
|
90
|
-
|
91
|
-
|
92
|
-
|
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:
|
112
|
-
|
113
|
-
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
|
179
|
-
|
180
|
-
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
410
|
-
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
611
|
-
|
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
|
-
* ```
|
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
|
-
|
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
|
-
*
|
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
|
-
|
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
|
-
|
912
|
-
|
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:
|
927
|
-
reject:
|
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
|
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
|
-
* ```
|
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
|
-
|
1171
|
-
*/
|
1172
|
-
|
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
|
-
|
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
|
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:
|
1248
|
-
queryAll?: (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
|
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
|
-
* ```
|
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
|
1337
|
-
|
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
|
-
|
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
|
-
* ```
|
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
|
1510
|
-
private
|
1511
|
-
|
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:
|
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
|
-
* ```
|
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
|
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
|
-
* ```
|
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
|
1676
|
-
*
|
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
|
-
* ```
|
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
|
-
* ```
|
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.
|
1751
|
-
*
|
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
|
-
$<
|
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
|
-
|
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
|
-
* ```
|
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<
|
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
|
-
* ```
|
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<
|
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
|
1627
|
+
export declare const errors: PuppeteerErrors;
|
1827
1628
|
|
1828
1629
|
/**
|
1829
1630
|
* @public
|
1830
1631
|
*/
|
1831
|
-
export declare type
|
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
|
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
|
-
|
1925
|
-
|
1926
|
-
|
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
|
-
|
1948
|
-
|
1949
|
-
|
1950
|
-
|
1951
|
-
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* ```
|
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<
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* ```
|
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<
|
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
|
-
* ```
|
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<
|
2087
|
-
|
2088
|
-
|
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
|
-
|
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
|
-
* ```
|
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
|
2119
|
-
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
|
2193
|
-
|
2194
|
-
|
2195
|
-
|
2196
|
-
|
2197
|
-
|
2198
|
-
|
2199
|
-
|
2200
|
-
|
2201
|
-
|
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
|
-
* ```
|
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<
|
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<
|
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
|
-
$<
|
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
|
-
* ```
|
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<
|
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
|
-
* ```
|
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<
|
2402
|
-
|
2403
|
-
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* ```
|
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:
|
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
|
-
* ```
|
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
|
-
* ```
|
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:
|
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
|
-
*
|
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
|
-
* @
|
2551
|
+
* @public
|
2905
2552
|
*/
|
2906
|
-
export declare
|
2907
|
-
|
2908
|
-
|
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
|
-
*
|
2951
|
-
|
2952
|
-
|
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
|
-
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
3216
|
-
|
3217
|
-
|
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
|
-
|
3361
|
-
|
3362
|
-
|
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
|
-
|
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
|
-
* ```
|
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<
|
3436
|
-
|
3437
|
-
* @internal
|
3438
|
-
*/
|
3439
|
-
_context: ExecutionContext;
|
3027
|
+
export declare class JSHandle<T = unknown> {
|
3028
|
+
#private;
|
3440
3029
|
/**
|
3441
|
-
* @
|
3030
|
+
* Used for nominally typing {@link JSHandle}.
|
3442
3031
|
*/
|
3443
|
-
|
3444
|
-
|
3445
|
-
|
3446
|
-
|
3447
|
-
|
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
|
-
*
|
3462
|
-
*
|
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
|
-
* ```
|
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<
|
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
|
-
*
|
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
|
-
*
|
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<
|
3487
|
-
|
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:
|
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
|
-
*
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
3589
|
-
|
3590
|
-
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* @
|
3829
|
-
*/
|
3830
|
-
export declare
|
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
|
-
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
3954
|
-
|
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
|
-
* ```
|
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
|
4082
|
-
|
4083
|
-
|
4084
|
-
|
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
|
-
|
4117
|
-
|
4118
|
-
|
4119
|
-
|
4120
|
-
|
4121
|
-
|
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
|
-
*
|
4173
|
-
* They are internal to Puppeteer.
|
4174
|
-
*
|
4175
|
-
* @internal
|
3615
|
+
* @public
|
4176
3616
|
*/
|
4177
|
-
export declare
|
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
|
-
|
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}
|
3639
|
+
* {@link https://developer.chrome.com/extensions/background_pages | extension background page}
|
3640
|
+
* in Chromium.
|
4204
3641
|
*
|
4205
|
-
*
|
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
|
4211
|
-
* ```
|
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
|
-
* ```
|
3667
|
+
* ```ts
|
4229
3668
|
* page.once('load', () => console.log('Page loaded!'));
|
4230
3669
|
* ```
|
4231
3670
|
*
|
4232
|
-
* To unsubscribe from events use the
|
3671
|
+
* To unsubscribe from events use the {@link Page.off} method:
|
4233
3672
|
*
|
4234
|
-
* ```
|
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
|
-
|
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.
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
$<
|
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<
|
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
|
-
* ```
|
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<
|
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<
|
4673
|
-
|
4674
|
-
|
4675
|
-
|
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
|
-
* ```
|
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
|
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
|
-
* ```
|
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
|
-
* ```
|
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,
|
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.
|
4881
|
-
*
|
4882
|
-
*
|
4883
|
-
*
|
4884
|
-
*
|
4885
|
-
*
|
4886
|
-
*
|
4887
|
-
*
|
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
|
-
*
|
4892
|
-
* - `networkidle0` : consider setting content to be finished when there are
|
4893
|
-
*
|
4894
|
-
* - `networkidle2` : consider setting content to be finished when there are
|
4895
|
-
*
|
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.
|
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
|
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
|
-
*
|
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.
|
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
|
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
|
-
*
|
4380
|
+
* DOMContentLoaded event is fired.<br/>
|
4980
4381
|
* - `networkidle0` : consider navigation to be finished when there are no
|
4981
|
-
*
|
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
|
-
*
|
4384
|
+
* more than 2 network connections for at least `500` ms.
|
4984
4385
|
*/
|
4985
4386
|
reload(options?: WaitForOptions): Promise<HTTPResponse | null>;
|
4986
4387
|
/**
|
4987
|
-
*
|
4988
|
-
*
|
4989
|
-
*
|
4990
|
-
*
|
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
|
-
*
|
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
|
-
*
|
5008
|
-
*
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* ```
|
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.
|
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
|
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
|
-
*
|
4517
|
+
* DOMContentLoaded event is fired.<br/>
|
5119
4518
|
* - `networkidle0` : consider navigation to be finished when there are no
|
5120
|
-
*
|
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
|
-
*
|
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.
|
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
|
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
|
-
*
|
4544
|
+
* DOMContentLoaded event is fired.<br/>
|
5148
4545
|
* - `networkidle0` : consider navigation to be finished when there are no
|
5149
|
-
*
|
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
|
-
*
|
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.
|
5161
|
-
*
|
5162
|
-
*
|
5163
|
-
*
|
5164
|
-
*
|
5165
|
-
*
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
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<
|
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
|
-
* ```
|
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:
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
* ```
|
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:
|
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
|
-
* ```
|
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
|
-
*
|
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
|
-
*
|
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
|
-
*
|
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
|
-
*
|
5890
|
-
*
|
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
|
5899
|
-
* - `raf
|
5900
|
-
* callback. This is the tightest polling mode
|
5901
|
-
* observe styling changes
|
5902
|
-
* - `mutation
|
5903
|
-
*
|
5904
|
-
*
|
5905
|
-
*
|
5906
|
-
*
|
5907
|
-
*
|
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:
|
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:
|
5289
|
+
}, ...args: Params): Promise<HandleFor<Awaited<ReturnType<Func>>>>;
|
5914
5290
|
}
|
5915
5291
|
|
5916
|
-
|
5917
|
-
|
5918
|
-
|
5919
|
-
|
5920
|
-
|
5921
|
-
|
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
|
-
* ```
|
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 }
|
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
|
-
/**
|
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
|
-
* ```
|
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
|
-
* ```
|
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
|
-
*
|
6044
|
-
*
|
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
|
-
* @
|
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
|
-
*
|
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():
|
5753
|
+
get devices(): typeof devices;
|
6404
5754
|
/**
|
6405
|
-
* @
|
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
|
-
*
|
6416
|
-
*
|
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():
|
5761
|
+
get errors(): typeof errors;
|
6427
5762
|
/**
|
6428
|
-
* @
|
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
|
-
*
|
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():
|
5769
|
+
get networkConditions(): typeof networkConditions;
|
6449
5770
|
/**
|
6450
|
-
*
|
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
|
-
* @
|
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
|
-
* @
|
5787
|
+
* @deprecated Import directly puppeteer.
|
5788
|
+
* @example
|
5789
|
+
* ```ts
|
5790
|
+
* import { customQueryHandlerNames } from 'puppeteer';
|
5791
|
+
* ```
|
6470
5792
|
*/
|
6471
5793
|
customQueryHandlerNames(): string[];
|
6472
5794
|
/**
|
6473
|
-
*
|
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
|
-
|
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
|
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
|
6492
|
-
|
6493
|
-
|
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
|
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
|
-
* ```
|
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
|
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
|
-
*
|
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
|
-
* ```
|
5884
|
+
* ```ts
|
6576
5885
|
* const browser = await puppeteer.launch({
|
6577
5886
|
* ignoreDefaultArgs: ['--mute-audio']
|
6578
5887
|
* });
|
6579
5888
|
* ```
|
6580
5889
|
*
|
6581
|
-
*
|
6582
|
-
*
|
6583
|
-
*
|
6584
|
-
* Use `executablePath` option
|
6585
|
-
* If Google Chrome (rather than Chromium) is preferred,
|
6586
|
-
*
|
6587
|
-
*
|
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?:
|
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
|
-
*
|
6600
|
-
*
|
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
|
-
*
|
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
|
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
|
-
*
|
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
|
-
|
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
|
-
|
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,
|
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
|
-
*
|
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
|
6751
|
-
|
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
|
6892
|
-
|
6893
|
-
|
6894
|
-
|
6895
|
-
|
6896
|
-
|
6897
|
-
|
6898
|
-
|
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 |
|
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
|
6260
|
+
* TimeoutError is emitted whenever certain operations are terminated due to
|
6261
|
+
* timeout.
|
6998
6262
|
*
|
6999
6263
|
* @remarks
|
7000
|
-
*
|
7001
|
-
*
|
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
|
-
|
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
|
7043
|
-
|
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
|
-
* ```
|
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
|
-
|
7073
|
-
|
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
|
-
* ```
|
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
|
-
|
7286
|
-
|
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<
|
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<
|
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 { }
|