isomorfeus-puppetmaster 0.5.5 → 0.5.6
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/lib/isomorfeus/puppetmaster/console_message.rb +18 -18
- data/lib/isomorfeus/puppetmaster/cookie.rb +46 -46
- data/lib/isomorfeus/puppetmaster/driver/puppeteer.rb +413 -415
- data/lib/isomorfeus/puppetmaster/driver/puppeteer_document.rb +953 -953
- data/lib/isomorfeus/puppetmaster/driver/puppeteer_node.rb +851 -851
- data/lib/isomorfeus/puppetmaster/errors.rb +90 -90
- data/lib/isomorfeus/puppetmaster/iframe.rb +16 -16
- data/lib/isomorfeus/puppetmaster/node/content_editable.rb +17 -17
- data/lib/isomorfeus/puppetmaster/node/input.rb +20 -20
- data/lib/isomorfeus/puppetmaster/node/select.rb +35 -35
- data/lib/isomorfeus/puppetmaster/node.rb +279 -279
- data/lib/isomorfeus/puppetmaster/request.rb +16 -16
- data/lib/isomorfeus/puppetmaster/response.rb +25 -25
- data/lib/isomorfeus/puppetmaster/self_forwardable.rb +38 -38
- data/lib/isomorfeus/puppetmaster/version.rb +3 -3
- data/lib/isomorfeus/puppetmaster.rb +85 -85
- data/lib/isomorfeus-puppetmaster.rb +1 -0
- data/node_modules/.bin/extract-zip +12 -12
- data/node_modules/.bin/extract-zip.ps1 +28 -28
- data/node_modules/.bin/rimraf +12 -12
- data/node_modules/.bin/rimraf.ps1 +28 -28
- data/node_modules/.package-lock.json +530 -585
- data/node_modules/@types/node/LICENSE +21 -21
- data/node_modules/@types/node/assert/strict.d.ts +8 -8
- data/node_modules/@types/node/assert.d.ts +912 -912
- data/node_modules/@types/node/async_hooks.d.ts +497 -497
- data/node_modules/@types/node/buffer.d.ts +2142 -2142
- data/node_modules/@types/node/child_process.d.ts +1355 -1355
- data/node_modules/@types/node/cluster.d.ts +414 -414
- data/node_modules/@types/node/console.d.ts +407 -407
- data/node_modules/@types/node/constants.d.ts +18 -18
- data/node_modules/@types/node/crypto.d.ts +3224 -3224
- data/node_modules/@types/node/dgram.d.ts +545 -545
- data/node_modules/@types/node/diagnostics_channel.d.ts +128 -128
- data/node_modules/@types/node/dns/promises.d.ts +357 -357
- data/node_modules/@types/node/dns.d.ts +643 -643
- data/node_modules/@types/node/domain.d.ts +169 -169
- data/node_modules/@types/node/events.d.ts +623 -623
- data/node_modules/@types/node/fs/promises.d.ts +997 -997
- data/node_modules/@types/node/fs.d.ts +3723 -3723
- data/node_modules/@types/node/globals.d.ts +285 -285
- data/node_modules/@types/node/globals.global.d.ts +1 -1
- data/node_modules/@types/node/http.d.ts +1358 -1358
- data/node_modules/@types/node/http2.d.ts +2100 -2100
- data/node_modules/@types/node/https.d.ts +391 -391
- data/node_modules/@types/node/index.d.ts +131 -131
- data/node_modules/@types/node/inspector.d.ts +2738 -2738
- data/node_modules/@types/node/module.d.ts +114 -114
- data/node_modules/@types/node/net.d.ts +783 -783
- data/node_modules/@types/node/os.d.ts +455 -455
- data/node_modules/@types/node/package.json +229 -229
- data/node_modules/@types/node/path.d.ts +172 -172
- data/node_modules/@types/node/perf_hooks.d.ts +555 -555
- data/node_modules/@types/node/process.d.ts +1477 -1477
- data/node_modules/@types/node/punycode.d.ts +117 -117
- data/node_modules/@types/node/querystring.d.ts +131 -131
- data/node_modules/@types/node/readline.d.ts +542 -542
- data/node_modules/@types/node/repl.d.ts +424 -424
- data/node_modules/@types/node/stream/consumers.d.ts +24 -24
- data/node_modules/@types/node/stream/promises.d.ts +42 -42
- data/node_modules/@types/node/stream/web.d.ts +6 -6
- data/node_modules/@types/node/stream.d.ts +1181 -1181
- data/node_modules/@types/node/string_decoder.d.ts +67 -67
- data/node_modules/@types/node/timers/promises.d.ts +68 -68
- data/node_modules/@types/node/timers.d.ts +94 -94
- data/node_modules/@types/node/tls.d.ts +1019 -1019
- data/node_modules/@types/node/trace_events.d.ts +161 -161
- data/node_modules/@types/node/tty.d.ts +206 -206
- data/node_modules/@types/node/url.d.ts +798 -798
- data/node_modules/@types/node/util.d.ts +1556 -1556
- data/node_modules/@types/node/v8.d.ts +378 -378
- data/node_modules/@types/node/vm.d.ts +504 -504
- data/node_modules/@types/node/wasi.d.ts +153 -153
- data/node_modules/@types/node/worker_threads.d.ts +649 -649
- data/node_modules/@types/node/zlib.d.ts +517 -517
- data/node_modules/@types/yauzl/LICENSE +21 -21
- data/node_modules/@types/yauzl/index.d.ts +98 -98
- data/node_modules/@types/yauzl/package.json +26 -26
- data/node_modules/agent-base/README.md +145 -145
- data/node_modules/agent-base/dist/src/index.d.ts +78 -78
- data/node_modules/agent-base/dist/src/index.js +202 -202
- data/node_modules/agent-base/dist/src/promisify.d.ts +4 -4
- data/node_modules/agent-base/dist/src/promisify.js +17 -17
- data/node_modules/agent-base/package.json +64 -64
- data/node_modules/agent-base/src/index.ts +345 -345
- data/node_modules/agent-base/src/promisify.ts +33 -33
- data/node_modules/balanced-match/.github/FUNDING.yml +2 -2
- data/node_modules/balanced-match/LICENSE.md +21 -21
- data/node_modules/balanced-match/README.md +97 -97
- data/node_modules/balanced-match/index.js +62 -62
- data/node_modules/balanced-match/package.json +48 -48
- data/node_modules/base64-js/LICENSE +21 -21
- data/node_modules/base64-js/README.md +34 -34
- data/node_modules/base64-js/index.d.ts +3 -3
- data/node_modules/base64-js/index.js +150 -150
- data/node_modules/base64-js/package.json +47 -47
- data/node_modules/bl/.travis.yml +17 -17
- data/node_modules/bl/BufferList.js +396 -396
- data/node_modules/bl/LICENSE.md +13 -13
- data/node_modules/bl/README.md +247 -247
- data/node_modules/bl/bl.js +84 -84
- data/node_modules/bl/package.json +37 -37
- data/node_modules/bl/test/convert.js +21 -21
- data/node_modules/bl/test/indexOf.js +492 -492
- data/node_modules/bl/test/isBufferList.js +32 -32
- data/node_modules/bl/test/test.js +869 -869
- data/node_modules/brace-expansion/LICENSE +21 -21
- data/node_modules/brace-expansion/README.md +129 -129
- data/node_modules/brace-expansion/index.js +201 -201
- data/node_modules/brace-expansion/package.json +47 -47
- data/node_modules/buffer/AUTHORS.md +70 -70
- data/node_modules/buffer/LICENSE +21 -21
- data/node_modules/buffer/README.md +410 -410
- data/node_modules/buffer/index.d.ts +186 -186
- data/node_modules/buffer/index.js +1817 -1817
- data/node_modules/buffer/package.json +96 -96
- data/node_modules/buffer-crc32/LICENSE +19 -19
- data/node_modules/buffer-crc32/README.md +47 -47
- data/node_modules/buffer-crc32/index.js +111 -111
- data/node_modules/buffer-crc32/package.json +39 -39
- data/node_modules/chownr/LICENSE +15 -15
- data/node_modules/chownr/README.md +3 -3
- data/node_modules/chownr/chownr.js +167 -167
- data/node_modules/chownr/package.json +29 -29
- data/node_modules/concat-map/.travis.yml +4 -4
- data/node_modules/concat-map/LICENSE +18 -18
- data/node_modules/concat-map/README.markdown +62 -62
- data/node_modules/concat-map/example/map.js +6 -6
- data/node_modules/concat-map/index.js +13 -13
- data/node_modules/concat-map/package.json +43 -43
- data/node_modules/concat-map/test/map.js +39 -39
- data/node_modules/debug/LICENSE +19 -19
- data/node_modules/debug/README.md +455 -455
- data/node_modules/debug/package.json +59 -59
- data/node_modules/debug/src/browser.js +269 -269
- data/node_modules/debug/src/common.js +274 -274
- data/node_modules/debug/src/index.js +10 -10
- data/node_modules/debug/src/node.js +263 -263
- data/node_modules/devtools-protocol/LICENSE +27 -27
- data/node_modules/devtools-protocol/README.md +12 -12
- data/node_modules/devtools-protocol/json/browser_protocol.json +20985 -20640
- data/node_modules/devtools-protocol/json/js_protocol.json +3531 -3580
- data/node_modules/devtools-protocol/package.json +17 -18
- data/node_modules/devtools-protocol/pdl/browser_protocol.pdl +9849 -9637
- data/node_modules/devtools-protocol/pdl/js_protocol.pdl +1653 -1678
- data/node_modules/devtools-protocol/types/protocol-mapping.d.ts +4333 -4321
- data/node_modules/devtools-protocol/types/protocol-proxy-api.d.ts +3695 -3683
- data/node_modules/devtools-protocol/types/protocol.d.ts +15714 -15538
- data/node_modules/end-of-stream/LICENSE +20 -20
- data/node_modules/end-of-stream/README.md +54 -54
- data/node_modules/end-of-stream/index.js +94 -94
- data/node_modules/end-of-stream/package.json +37 -37
- data/node_modules/extract-zip/LICENSE +23 -23
- data/node_modules/extract-zip/cli.js +19 -19
- data/node_modules/extract-zip/index.d.ts +21 -21
- data/node_modules/extract-zip/index.js +173 -173
- data/node_modules/extract-zip/package.json +80 -80
- data/node_modules/extract-zip/readme.md +57 -57
- data/node_modules/fd-slicer/.npmignore +2 -2
- data/node_modules/fd-slicer/.travis.yml +7 -7
- data/node_modules/fd-slicer/CHANGELOG.md +49 -49
- data/node_modules/fd-slicer/LICENSE +21 -21
- data/node_modules/fd-slicer/README.md +199 -199
- data/node_modules/fd-slicer/index.js +296 -296
- data/node_modules/fd-slicer/package.json +36 -36
- data/node_modules/fd-slicer/test/test.js +350 -350
- data/node_modules/find-up/index.d.ts +137 -137
- data/node_modules/find-up/index.js +89 -89
- data/node_modules/find-up/license +9 -9
- data/node_modules/find-up/package.json +53 -53
- data/node_modules/find-up/readme.md +156 -156
- data/node_modules/fs-constants/LICENSE +21 -21
- data/node_modules/fs-constants/README.md +26 -26
- data/node_modules/fs-constants/browser.js +1 -1
- data/node_modules/fs-constants/index.js +1 -1
- data/node_modules/fs-constants/package.json +19 -19
- data/node_modules/fs.realpath/LICENSE +43 -43
- data/node_modules/fs.realpath/README.md +33 -33
- data/node_modules/fs.realpath/index.js +66 -66
- data/node_modules/fs.realpath/old.js +303 -303
- data/node_modules/fs.realpath/package.json +26 -26
- data/node_modules/get-stream/buffer-stream.js +52 -52
- data/node_modules/get-stream/index.d.ts +108 -108
- data/node_modules/get-stream/index.js +60 -60
- data/node_modules/get-stream/license +9 -9
- data/node_modules/get-stream/package.json +50 -50
- data/node_modules/get-stream/readme.md +124 -124
- data/node_modules/glob/LICENSE +21 -21
- data/node_modules/glob/README.md +375 -375
- data/node_modules/glob/changelog.md +67 -67
- data/node_modules/glob/common.js +234 -234
- data/node_modules/glob/glob.js +788 -788
- data/node_modules/glob/package.json +51 -51
- data/node_modules/glob/sync.js +484 -484
- data/node_modules/https-proxy-agent/README.md +137 -137
- data/node_modules/https-proxy-agent/dist/agent.d.ts +30 -30
- data/node_modules/https-proxy-agent/dist/agent.js +179 -179
- data/node_modules/https-proxy-agent/dist/index.d.ts +23 -23
- data/node_modules/https-proxy-agent/dist/index.js +13 -13
- data/node_modules/https-proxy-agent/dist/parse-proxy-response.d.ts +7 -7
- data/node_modules/https-proxy-agent/dist/parse-proxy-response.js +65 -65
- data/node_modules/https-proxy-agent/package.json +56 -56
- data/node_modules/ieee754/LICENSE +11 -11
- data/node_modules/ieee754/README.md +51 -51
- data/node_modules/ieee754/index.d.ts +9 -9
- data/node_modules/ieee754/index.js +85 -85
- data/node_modules/ieee754/package.json +52 -52
- data/node_modules/inflight/LICENSE +15 -15
- data/node_modules/inflight/README.md +37 -37
- data/node_modules/inflight/inflight.js +54 -54
- data/node_modules/inflight/package.json +29 -29
- data/node_modules/inherits/LICENSE +16 -16
- data/node_modules/inherits/README.md +42 -42
- data/node_modules/inherits/inherits.js +9 -9
- data/node_modules/inherits/inherits_browser.js +27 -27
- data/node_modules/inherits/package.json +29 -29
- data/node_modules/locate-path/index.d.ts +83 -83
- data/node_modules/locate-path/index.js +65 -65
- data/node_modules/locate-path/license +9 -9
- data/node_modules/locate-path/package.json +45 -45
- data/node_modules/locate-path/readme.md +122 -122
- data/node_modules/minimatch/LICENSE +15 -15
- data/node_modules/minimatch/README.md +209 -209
- data/node_modules/minimatch/minimatch.js +923 -923
- data/node_modules/minimatch/package.json +30 -30
- data/node_modules/mkdirp-classic/LICENSE +21 -21
- data/node_modules/mkdirp-classic/README.md +18 -18
- data/node_modules/mkdirp-classic/index.js +98 -98
- data/node_modules/mkdirp-classic/package.json +18 -18
- data/node_modules/ms/index.js +162 -162
- data/node_modules/ms/license.md +21 -21
- data/node_modules/ms/package.json +37 -37
- data/node_modules/ms/readme.md +60 -60
- data/node_modules/node-fetch/LICENSE.md +22 -22
- data/node_modules/node-fetch/README.md +590 -590
- data/node_modules/node-fetch/browser.js +24 -24
- data/node_modules/node-fetch/lib/index.es.js +1662 -1662
- data/node_modules/node-fetch/lib/index.js +1671 -1671
- data/node_modules/node-fetch/lib/index.mjs +1660 -1660
- data/node_modules/node-fetch/package.json +68 -68
- data/node_modules/once/LICENSE +15 -15
- data/node_modules/once/README.md +79 -79
- data/node_modules/once/once.js +42 -42
- data/node_modules/once/package.json +33 -33
- data/node_modules/p-limit/index.d.ts +38 -38
- data/node_modules/p-limit/index.js +57 -57
- data/node_modules/p-limit/license +9 -9
- data/node_modules/p-limit/package.json +52 -52
- data/node_modules/p-limit/readme.md +101 -101
- data/node_modules/p-locate/index.d.ts +64 -64
- data/node_modules/p-locate/index.js +52 -52
- data/node_modules/p-locate/license +9 -9
- data/node_modules/p-locate/package.json +53 -53
- data/node_modules/p-locate/readme.md +90 -90
- data/node_modules/p-try/index.d.ts +39 -39
- data/node_modules/p-try/index.js +9 -9
- data/node_modules/p-try/license +9 -9
- data/node_modules/p-try/package.json +42 -42
- data/node_modules/p-try/readme.md +58 -58
- data/node_modules/path-exists/index.d.ts +28 -28
- data/node_modules/path-exists/index.js +23 -23
- data/node_modules/path-exists/license +9 -9
- data/node_modules/path-exists/package.json +39 -39
- data/node_modules/path-exists/readme.md +52 -52
- data/node_modules/path-is-absolute/index.js +20 -20
- data/node_modules/path-is-absolute/license +21 -21
- data/node_modules/path-is-absolute/package.json +43 -43
- data/node_modules/path-is-absolute/readme.md +59 -59
- data/node_modules/pend/LICENSE +23 -23
- data/node_modules/pend/README.md +41 -41
- data/node_modules/pend/index.js +55 -55
- data/node_modules/pend/package.json +18 -18
- data/node_modules/pend/test.js +137 -137
- data/node_modules/pkg-dir/index.d.ts +44 -44
- data/node_modules/pkg-dir/index.js +17 -17
- data/node_modules/pkg-dir/license +9 -9
- data/node_modules/pkg-dir/package.json +56 -56
- data/node_modules/pkg-dir/readme.md +66 -66
- data/node_modules/progress/CHANGELOG.md +115 -115
- data/node_modules/progress/LICENSE +22 -22
- data/node_modules/progress/Makefile +8 -8
- data/node_modules/progress/Readme.md +146 -146
- data/node_modules/progress/index.js +1 -1
- data/node_modules/progress/lib/node-progress.js +236 -236
- data/node_modules/progress/package.json +26 -26
- data/node_modules/proxy-from-env/.eslintrc +29 -29
- data/node_modules/proxy-from-env/.travis.yml +10 -10
- data/node_modules/proxy-from-env/LICENSE +20 -20
- data/node_modules/proxy-from-env/README.md +131 -131
- data/node_modules/proxy-from-env/index.js +108 -108
- data/node_modules/proxy-from-env/package.json +34 -34
- data/node_modules/proxy-from-env/test.js +483 -483
- data/node_modules/pump/.travis.yml +5 -5
- data/node_modules/pump/LICENSE +20 -20
- data/node_modules/pump/README.md +65 -65
- data/node_modules/pump/index.js +82 -82
- data/node_modules/pump/package.json +24 -24
- data/node_modules/pump/test-browser.js +66 -66
- data/node_modules/pump/test-node.js +53 -53
- data/node_modules/puppeteer-core/CHANGELOG.md +319 -290
- data/node_modules/puppeteer-core/LICENSE +202 -202
- data/node_modules/puppeteer-core/README.md +481 -481
- data/node_modules/puppeteer-core/cjs-entry-core.js +29 -29
- data/node_modules/puppeteer-core/cjs-entry.js +29 -29
- data/node_modules/puppeteer-core/install.js +89 -89
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/api-docs-entry.d.ts +110 -110
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/api-docs-entry.js +80 -80
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Accessibility.d.ts +175 -175
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Accessibility.js +360 -360
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/AriaQueryHandler.d.ts +20 -20
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/AriaQueryHandler.js +84 -84
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/AriaQueryHandler.js.map +1 -1
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Browser.d.ts +455 -455
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Browser.js +540 -540
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/BrowserConnector.d.ts +53 -53
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/BrowserConnector.js +97 -97
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/BrowserWebSocketTransport.d.ts +25 -25
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/BrowserWebSocketTransport.js +34 -34
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Connection.d.ts +135 -135
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Connection.js +298 -298
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/ConnectionTransport.d.ts +24 -24
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/ConnectionTransport.js +17 -17
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/ConsoleMessage.d.ts +72 -72
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/ConsoleMessage.js +64 -64
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Coverage.d.ts +204 -204
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Coverage.js +335 -335
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/DOMWorld.d.ts +175 -175
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/DOMWorld.js +662 -662
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Debug.d.ts +52 -52
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Debug.js +81 -81
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/DeviceDescriptors.d.ts +40 -40
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/DeviceDescriptors.js +1070 -1070
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Dialog.d.ts +74 -74
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Dialog.js +97 -97
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/EmulationManager.d.ts +24 -24
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/EmulationManager.js +37 -37
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Errors.d.ts +50 -50
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Errors.js +56 -56
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/EvalTypes.d.ts +60 -60
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/EvalTypes.js +17 -17
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/EventEmitter.d.ts +92 -92
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/EventEmitter.js +116 -116
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Events.d.ts +81 -81
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Events.js +86 -86
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/ExecutionContext.d.ts +193 -193
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/ExecutionContext.js +321 -321
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/FileChooser.d.ts +58 -58
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/FileChooser.js +71 -71
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/FrameManager.d.ts +744 -744
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/FrameManager.js +1047 -1047
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/FrameManager.js.map +1 -1
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/HTTPRequest.d.ts +350 -345
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/HTTPRequest.d.ts.map +1 -1
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/HTTPRequest.js +549 -549
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/HTTPRequest.js.map +1 -1
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/HTTPResponse.d.ts +134 -125
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/HTTPResponse.d.ts.map +1 -1
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/HTTPResponse.js +184 -164
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/HTTPResponse.js.map +1 -1
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Input.d.ts +358 -358
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Input.js +543 -543
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/JSHandle.d.ts +490 -490
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/JSHandle.js +827 -827
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/LifecycleWatcher.d.ts +65 -65
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/LifecycleWatcher.d.ts.map +1 -1
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/LifecycleWatcher.js +149 -148
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/LifecycleWatcher.js.map +1 -1
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/NetworkConditions.d.ts +26 -26
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/NetworkConditions.js +33 -33
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/NetworkManager.d.ts +126 -97
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/NetworkManager.d.ts.map +1 -1
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/NetworkManager.js +467 -342
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/NetworkManager.js.map +1 -1
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/PDFOptions.d.ts +161 -161
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/PDFOptions.js +34 -34
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Page.d.ts +2055 -2055
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Page.js +2533 -2533
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Product.d.ts +20 -20
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Product.js +17 -17
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Puppeteer.d.ts +159 -159
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Puppeteer.js +161 -161
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/PuppeteerViewport.d.ts +51 -51
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/PuppeteerViewport.js +2 -2
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/QueryHandler.d.ts +64 -64
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/QueryHandler.js +165 -165
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/SecurityDetails.d.ts +60 -60
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/SecurityDetails.js +76 -76
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Target.d.ts +100 -100
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Target.js +145 -145
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/TaskQueue.d.ts +20 -20
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/TaskQueue.js +29 -29
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/TimeoutSettings.d.ts +27 -27
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/TimeoutSettings.js +47 -47
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Tracing.d.ts +46 -46
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/Tracing.js +109 -109
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/USKeyboardLayout.d.ts +39 -39
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/USKeyboardLayout.js +406 -406
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/WebWorker.d.ts +98 -98
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/WebWorker.js +112 -112
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/assert.d.ts +22 -22
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/assert.js +33 -33
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/fetch.d.ts +16 -16
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/fetch.js +43 -43
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/helper.d.ts +84 -84
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/common/helper.js +327 -327
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/environment.d.ts +16 -16
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/environment.js +19 -19
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/global.d.ts +16 -16
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/global.js +2 -2
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/initialize-node.d.ts +17 -17
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/initialize-node.js +44 -44
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/initialize-web.d.ts +17 -17
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/initialize-web.js +26 -26
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node/BrowserFetcher.d.ts +133 -133
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node/BrowserFetcher.js +500 -500
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node/BrowserRunner.d.ts +40 -39
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node/BrowserRunner.d.ts.map +1 -1
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node/BrowserRunner.js +256 -230
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node/BrowserRunner.js.map +1 -1
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node/LaunchOptions.d.ts +134 -134
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node/LaunchOptions.js +17 -17
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node/Launcher.d.ts +16 -16
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node/Launcher.d.ts.map +1 -1
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node/Launcher.js +655 -588
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node/Launcher.js.map +1 -1
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node/NodeWebSocketTransport.d.ts +26 -26
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node/NodeWebSocketTransport.js +47 -47
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node/PipeTransport.d.ts +29 -29
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node/PipeTransport.js +64 -64
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node/Puppeteer.d.ts +153 -153
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node/Puppeteer.js +188 -188
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node/install.d.ts +17 -17
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node/install.js +173 -173
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node-puppeteer-core.d.ts +17 -17
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node-puppeteer-core.js +24 -24
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node.d.ts +17 -17
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/node.js +23 -23
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/revisions.d.ts +21 -21
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/revisions.js +22 -22
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/web.d.ts +17 -17
- data/node_modules/puppeteer-core/lib/cjs/puppeteer/web.js +23 -23
- data/node_modules/puppeteer-core/lib/cjs/vendor/mitt/src/index.d.ts +27 -27
- data/node_modules/puppeteer-core/lib/cjs/vendor/mitt/src/index.js +56 -56
- data/node_modules/puppeteer-core/lib/esm/puppeteer/api-docs-entry.d.ts +110 -110
- data/node_modules/puppeteer-core/lib/esm/puppeteer/api-docs-entry.js +80 -80
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Accessibility.d.ts +175 -175
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Accessibility.js +356 -356
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/AriaQueryHandler.d.ts +20 -20
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/AriaQueryHandler.js +81 -81
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/AriaQueryHandler.js.map +1 -1
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Browser.d.ts +455 -455
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Browser.js +535 -535
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/BrowserConnector.d.ts +53 -53
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/BrowserConnector.js +74 -74
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/BrowserWebSocketTransport.d.ts +25 -25
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/BrowserWebSocketTransport.js +30 -30
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Connection.d.ts +135 -135
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Connection.js +293 -293
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/ConnectionTransport.d.ts +24 -24
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/ConnectionTransport.js +16 -16
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/ConsoleMessage.d.ts +72 -72
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/ConsoleMessage.js +60 -60
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Coverage.d.ts +204 -204
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Coverage.js +329 -329
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/DOMWorld.d.ts +175 -175
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/DOMWorld.js +657 -657
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Debug.d.ts +52 -52
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Debug.js +77 -77
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/DeviceDescriptors.d.ts +40 -40
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/DeviceDescriptors.js +1067 -1067
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Dialog.d.ts +74 -74
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Dialog.js +93 -93
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/EmulationManager.d.ts +24 -24
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/EmulationManager.js +33 -33
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Errors.d.ts +50 -50
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Errors.js +50 -50
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/EvalTypes.d.ts +60 -60
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/EvalTypes.js +16 -16
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/EventEmitter.d.ts +92 -92
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/EventEmitter.js +109 -109
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Events.d.ts +81 -81
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Events.js +83 -83
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/ExecutionContext.d.ts +193 -193
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/ExecutionContext.js +317 -317
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/FileChooser.d.ts +58 -58
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/FileChooser.js +67 -67
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/FrameManager.d.ts +744 -744
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/FrameManager.js +1042 -1042
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/FrameManager.js.map +1 -1
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/HTTPRequest.d.ts +350 -345
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/HTTPRequest.d.ts.map +1 -1
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/HTTPRequest.js +545 -545
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/HTTPRequest.js.map +1 -1
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/HTTPResponse.d.ts +134 -125
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/HTTPResponse.d.ts.map +1 -1
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/HTTPResponse.js +180 -160
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/HTTPResponse.js.map +1 -1
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Input.d.ts +358 -358
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Input.js +537 -537
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/JSHandle.d.ts +490 -490
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/JSHandle.js +802 -802
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/LifecycleWatcher.d.ts +65 -65
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/LifecycleWatcher.d.ts.map +1 -1
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/LifecycleWatcher.js +145 -144
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/LifecycleWatcher.js.map +1 -1
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/NetworkConditions.d.ts +26 -26
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/NetworkConditions.js +30 -30
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/NetworkManager.d.ts +126 -97
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/NetworkManager.d.ts.map +1 -1
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/NetworkManager.js +463 -338
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/NetworkManager.js.map +1 -1
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/PDFOptions.d.ts +161 -161
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/PDFOptions.js +31 -31
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Page.d.ts +2055 -2055
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Page.js +2529 -2529
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Product.d.ts +20 -20
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Product.js +16 -16
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Puppeteer.d.ts +159 -159
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Puppeteer.js +157 -157
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/PuppeteerViewport.d.ts +51 -51
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/PuppeteerViewport.js +1 -1
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/QueryHandler.d.ts +64 -64
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/QueryHandler.js +157 -157
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/SecurityDetails.d.ts +60 -60
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/SecurityDetails.js +72 -72
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Target.d.ts +100 -100
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Target.js +141 -141
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/TaskQueue.d.ts +20 -20
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/TaskQueue.js +25 -25
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/TimeoutSettings.d.ts +27 -27
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/TimeoutSettings.js +43 -43
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Tracing.d.ts +46 -46
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/Tracing.js +105 -105
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/USKeyboardLayout.d.ts +39 -39
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/USKeyboardLayout.js +403 -403
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/WebWorker.d.ts +98 -98
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/WebWorker.js +108 -108
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/assert.d.ts +22 -22
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/assert.js +28 -28
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/fetch.d.ts +16 -16
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/fetch.js +20 -20
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/helper.d.ts +84 -84
- data/node_modules/puppeteer-core/lib/esm/puppeteer/common/helper.js +305 -305
- data/node_modules/puppeteer-core/lib/esm/puppeteer/environment.d.ts +16 -16
- data/node_modules/puppeteer-core/lib/esm/puppeteer/environment.js +16 -16
- data/node_modules/puppeteer-core/lib/esm/puppeteer/global.d.ts +16 -16
- data/node_modules/puppeteer-core/lib/esm/puppeteer/global.js +1 -1
- data/node_modules/puppeteer-core/lib/esm/puppeteer/initialize-node.d.ts +17 -17
- data/node_modules/puppeteer-core/lib/esm/puppeteer/initialize-node.js +37 -37
- data/node_modules/puppeteer-core/lib/esm/puppeteer/initialize-web.d.ts +17 -17
- data/node_modules/puppeteer-core/lib/esm/puppeteer/initialize-web.js +22 -22
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node/BrowserFetcher.d.ts +133 -133
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node/BrowserFetcher.js +474 -474
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node/BrowserRunner.d.ts +40 -39
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node/BrowserRunner.d.ts.map +1 -1
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node/BrowserRunner.js +230 -204
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node/BrowserRunner.js.map +1 -1
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node/LaunchOptions.d.ts +134 -134
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node/LaunchOptions.js +16 -16
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node/Launcher.d.ts +16 -16
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node/Launcher.d.ts.map +1 -1
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node/Launcher.js +633 -566
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node/Launcher.js.map +1 -1
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node/NodeWebSocketTransport.d.ts +26 -26
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node/NodeWebSocketTransport.js +40 -40
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node/PipeTransport.d.ts +29 -29
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node/PipeTransport.js +60 -60
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node/Puppeteer.d.ts +153 -153
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node/Puppeteer.js +181 -181
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node/install.d.ts +17 -17
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node/install.js +165 -165
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node-puppeteer-core.d.ts +17 -17
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node-puppeteer-core.js +22 -22
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node.d.ts +17 -17
- data/node_modules/puppeteer-core/lib/esm/puppeteer/node.js +21 -21
- data/node_modules/puppeteer-core/lib/esm/puppeteer/revisions.d.ts +21 -21
- data/node_modules/puppeteer-core/lib/esm/puppeteer/revisions.js +19 -19
- data/node_modules/puppeteer-core/lib/esm/puppeteer/web.d.ts +17 -17
- data/node_modules/puppeteer-core/lib/esm/puppeteer/web.js +21 -21
- data/node_modules/puppeteer-core/lib/esm/vendor/mitt/src/index.d.ts +27 -27
- data/node_modules/puppeteer-core/lib/esm/vendor/mitt/src/index.js +53 -53
- data/node_modules/puppeteer-core/lib/types.d.ts +67 -25
- data/node_modules/puppeteer-core/package.json +115 -115
- data/node_modules/puppeteer-core/typescript-if-required.js +61 -61
- data/node_modules/readable-stream/CONTRIBUTING.md +38 -38
- data/node_modules/readable-stream/GOVERNANCE.md +136 -136
- data/node_modules/readable-stream/LICENSE +47 -47
- data/node_modules/readable-stream/README.md +106 -106
- data/node_modules/readable-stream/errors-browser.js +127 -127
- data/node_modules/readable-stream/errors.js +116 -116
- data/node_modules/readable-stream/experimentalWarning.js +17 -17
- data/node_modules/readable-stream/lib/_stream_duplex.js +138 -138
- data/node_modules/readable-stream/lib/_stream_passthrough.js +38 -38
- data/node_modules/readable-stream/lib/_stream_readable.js +1123 -1123
- data/node_modules/readable-stream/lib/_stream_transform.js +200 -200
- data/node_modules/readable-stream/lib/_stream_writable.js +696 -696
- data/node_modules/readable-stream/lib/internal/streams/async_iterator.js +206 -206
- data/node_modules/readable-stream/lib/internal/streams/buffer_list.js +209 -209
- data/node_modules/readable-stream/lib/internal/streams/destroy.js +104 -104
- data/node_modules/readable-stream/lib/internal/streams/end-of-stream.js +103 -103
- data/node_modules/readable-stream/lib/internal/streams/from-browser.js +3 -3
- data/node_modules/readable-stream/lib/internal/streams/from.js +63 -63
- data/node_modules/readable-stream/lib/internal/streams/pipeline.js +96 -96
- data/node_modules/readable-stream/lib/internal/streams/state.js +26 -26
- data/node_modules/readable-stream/lib/internal/streams/stream-browser.js +1 -1
- data/node_modules/readable-stream/lib/internal/streams/stream.js +1 -1
- data/node_modules/readable-stream/package.json +68 -68
- data/node_modules/readable-stream/readable-browser.js +9 -9
- data/node_modules/readable-stream/readable.js +16 -16
- data/node_modules/rimraf/CHANGELOG.md +65 -65
- data/node_modules/rimraf/LICENSE +15 -15
- data/node_modules/rimraf/README.md +101 -101
- data/node_modules/rimraf/bin.js +68 -68
- data/node_modules/rimraf/package.json +32 -32
- data/node_modules/rimraf/rimraf.js +360 -360
- data/node_modules/safe-buffer/LICENSE +21 -21
- data/node_modules/safe-buffer/README.md +584 -584
- data/node_modules/safe-buffer/index.d.ts +186 -186
- data/node_modules/safe-buffer/index.js +65 -65
- data/node_modules/safe-buffer/package.json +51 -51
- data/node_modules/string_decoder/LICENSE +48 -48
- data/node_modules/string_decoder/README.md +47 -47
- data/node_modules/string_decoder/lib/string_decoder.js +295 -295
- data/node_modules/string_decoder/package.json +34 -34
- data/node_modules/tar-fs/.travis.yml +6 -6
- data/node_modules/tar-fs/LICENSE +20 -20
- data/node_modules/tar-fs/README.md +165 -165
- data/node_modules/tar-fs/index.js +351 -351
- data/node_modules/tar-fs/package.json +41 -41
- data/node_modules/tar-fs/test/fixtures/a/hello.txt +1 -1
- data/node_modules/tar-fs/test/fixtures/b/a/test.txt +1 -1
- data/node_modules/tar-fs/test/index.js +346 -346
- data/node_modules/tar-stream/LICENSE +20 -20
- data/node_modules/tar-stream/README.md +168 -168
- data/node_modules/tar-stream/extract.js +257 -257
- data/node_modules/tar-stream/headers.js +295 -295
- data/node_modules/tar-stream/index.js +2 -2
- data/node_modules/tar-stream/pack.js +255 -255
- data/node_modules/tar-stream/package.json +58 -58
- data/node_modules/tar-stream/sandbox.js +11 -11
- data/node_modules/through/.travis.yml +5 -5
- data/node_modules/through/LICENSE.APACHE2 +15 -15
- data/node_modules/through/LICENSE.MIT +24 -24
- data/node_modules/through/index.js +108 -108
- data/node_modules/through/package.json +36 -36
- data/node_modules/through/readme.markdown +64 -64
- data/node_modules/through/test/async.js +28 -28
- data/node_modules/through/test/auto-destroy.js +30 -30
- data/node_modules/through/test/buffering.js +71 -71
- data/node_modules/through/test/end.js +45 -45
- data/node_modules/through/test/index.js +133 -133
- data/node_modules/tr46/.npmignore +4 -4
- data/node_modules/tr46/index.js +193 -193
- data/node_modules/tr46/package.json +31 -31
- data/node_modules/unbzip2-stream/LICENSE +24 -24
- data/node_modules/unbzip2-stream/README.md +59 -59
- data/node_modules/unbzip2-stream/dist/unbzip2-stream.min.js +1 -1
- data/node_modules/unbzip2-stream/index.js +93 -93
- data/node_modules/unbzip2-stream/lib/bit_iterator.js +39 -39
- data/node_modules/unbzip2-stream/lib/bzip2.js +365 -365
- data/node_modules/unbzip2-stream/package.json +51 -51
- data/node_modules/util-deprecate/History.md +16 -16
- data/node_modules/util-deprecate/LICENSE +24 -24
- data/node_modules/util-deprecate/README.md +53 -53
- data/node_modules/util-deprecate/browser.js +67 -67
- data/node_modules/util-deprecate/node.js +6 -6
- data/node_modules/util-deprecate/package.json +27 -27
- data/node_modules/webidl-conversions/LICENSE.md +12 -12
- data/node_modules/webidl-conversions/README.md +53 -53
- data/node_modules/webidl-conversions/lib/index.js +189 -189
- data/node_modules/webidl-conversions/package.json +23 -23
- data/node_modules/whatwg-url/LICENSE.txt +21 -21
- data/node_modules/whatwg-url/README.md +67 -67
- data/node_modules/whatwg-url/lib/URL-impl.js +200 -200
- data/node_modules/whatwg-url/lib/URL.js +196 -196
- data/node_modules/whatwg-url/lib/public-api.js +11 -11
- data/node_modules/whatwg-url/lib/utils.js +20 -20
- data/node_modules/whatwg-url/package.json +32 -32
- data/node_modules/wrappy/LICENSE +15 -15
- data/node_modules/wrappy/README.md +36 -36
- data/node_modules/wrappy/package.json +29 -29
- data/node_modules/wrappy/wrappy.js +33 -33
- data/node_modules/ws/LICENSE +19 -19
- data/node_modules/ws/README.md +493 -493
- data/node_modules/ws/browser.js +8 -8
- data/node_modules/ws/index.js +13 -13
- data/node_modules/ws/lib/buffer-util.js +126 -126
- data/node_modules/ws/lib/constants.js +12 -12
- data/node_modules/ws/lib/event-target.js +266 -266
- data/node_modules/ws/lib/extension.js +203 -203
- data/node_modules/ws/lib/limiter.js +55 -55
- data/node_modules/ws/lib/permessage-deflate.js +511 -511
- data/node_modules/ws/lib/receiver.js +612 -612
- data/node_modules/ws/lib/sender.js +422 -422
- data/node_modules/ws/lib/stream.js +180 -180
- data/node_modules/ws/lib/subprotocol.js +62 -62
- data/node_modules/ws/lib/validation.js +124 -124
- data/node_modules/ws/lib/websocket-server.js +485 -485
- data/node_modules/ws/lib/websocket.js +1149 -1149
- data/node_modules/ws/package.json +61 -61
- data/node_modules/ws/wrapper.mjs +8 -8
- data/node_modules/yauzl/LICENSE +21 -21
- data/node_modules/yauzl/README.md +658 -658
- data/node_modules/yauzl/index.js +796 -796
- data/node_modules/yauzl/package.json +40 -40
- data/package.json +1 -1
- metadata +23 -25
- data/node_modules/devtools-protocol/changelog.md +0 -10491
- data/node_modules/devtools-protocol/externs/protocol_externs.js +0 -9734
@@ -1,1043 +1,1043 @@
|
|
1
|
-
/**
|
2
|
-
* Copyright 2017 Google Inc. All rights reserved.
|
3
|
-
*
|
4
|
-
* Licensed under the Apache License, Version 2.0 (the "License");
|
5
|
-
* you may not use this file except in compliance with the License.
|
6
|
-
* You may obtain a copy of the License at
|
7
|
-
*
|
8
|
-
* http://www.apache.org/licenses/LICENSE-2.0
|
9
|
-
*
|
10
|
-
* Unless required by applicable law or agreed to in writing, software
|
11
|
-
* distributed under the License is distributed on an "AS IS" BASIS,
|
12
|
-
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
13
|
-
* See the License for the specific language governing permissions and
|
14
|
-
* limitations under the License.
|
15
|
-
*/
|
16
|
-
import { EventEmitter } from './EventEmitter.js';
|
17
|
-
import { assert } from './assert.js';
|
18
|
-
import { helper } from './helper.js';
|
19
|
-
import { ExecutionContext, EVALUATION_SCRIPT_URL } from './ExecutionContext.js';
|
20
|
-
import { LifecycleWatcher, } from './LifecycleWatcher.js';
|
21
|
-
import { DOMWorld } from './DOMWorld.js';
|
22
|
-
import { NetworkManager } from './NetworkManager.js';
|
23
|
-
import { Connection } from './Connection.js';
|
24
|
-
const UTILITY_WORLD_NAME = '__puppeteer_utility_world__';
|
25
|
-
const xPathPattern = /^\(\/\/[^\)]+\)|^\/\//;
|
26
|
-
/**
|
27
|
-
* We use symbols to prevent external parties listening to these events.
|
28
|
-
* They are internal to Puppeteer.
|
29
|
-
*
|
30
|
-
* @internal
|
31
|
-
*/
|
32
|
-
export const FrameManagerEmittedEvents = {
|
33
|
-
FrameAttached: Symbol('FrameManager.FrameAttached'),
|
34
|
-
FrameNavigated: Symbol('FrameManager.FrameNavigated'),
|
35
|
-
FrameDetached: Symbol('FrameManager.FrameDetached'),
|
36
|
-
LifecycleEvent: Symbol('FrameManager.LifecycleEvent'),
|
37
|
-
FrameNavigatedWithinDocument: Symbol('FrameManager.FrameNavigatedWithinDocument'),
|
38
|
-
ExecutionContextCreated: Symbol('FrameManager.ExecutionContextCreated'),
|
39
|
-
ExecutionContextDestroyed: Symbol('FrameManager.ExecutionContextDestroyed'),
|
40
|
-
};
|
41
|
-
/**
|
42
|
-
* @internal
|
43
|
-
*/
|
44
|
-
export class FrameManager extends EventEmitter {
|
45
|
-
constructor(client, page, ignoreHTTPSErrors, timeoutSettings) {
|
46
|
-
super();
|
47
|
-
this._frames = new Map();
|
48
|
-
this._contextIdToContext = new Map();
|
49
|
-
this._isolatedWorlds = new Set();
|
50
|
-
this._client = client;
|
51
|
-
this._page = page;
|
52
|
-
this._networkManager = new NetworkManager(client, ignoreHTTPSErrors, this);
|
53
|
-
this._timeoutSettings = timeoutSettings;
|
54
|
-
this.setupEventListeners(this._client);
|
55
|
-
}
|
56
|
-
setupEventListeners(session) {
|
57
|
-
session.on('Page.frameAttached', (event) => {
|
58
|
-
this._onFrameAttached(session, event.frameId, event.parentFrameId);
|
59
|
-
});
|
60
|
-
session.on('Page.frameNavigated', (event) => {
|
61
|
-
this._onFrameNavigated(event.frame);
|
62
|
-
});
|
63
|
-
session.on('Page.navigatedWithinDocument', (event) => {
|
64
|
-
this._onFrameNavigatedWithinDocument(event.frameId, event.url);
|
65
|
-
});
|
66
|
-
session.on('Page.frameDetached', (event) => {
|
67
|
-
this._onFrameDetached(event.frameId, event.reason);
|
68
|
-
});
|
69
|
-
session.on('Page.frameStoppedLoading', (event) => {
|
70
|
-
this._onFrameStoppedLoading(event.frameId);
|
71
|
-
});
|
72
|
-
session.on('Runtime.executionContextCreated', (event) => {
|
73
|
-
this._onExecutionContextCreated(event.context, session);
|
74
|
-
});
|
75
|
-
session.on('Runtime.executionContextDestroyed', (event) => {
|
76
|
-
this._onExecutionContextDestroyed(event.executionContextId, session);
|
77
|
-
});
|
78
|
-
session.on('Runtime.executionContextsCleared', () => {
|
79
|
-
this._onExecutionContextsCleared(session);
|
80
|
-
});
|
81
|
-
session.on('Page.lifecycleEvent', (event) => {
|
82
|
-
this._onLifecycleEvent(event);
|
83
|
-
});
|
84
|
-
session.on('Target.attachedToTarget', async (event) => {
|
85
|
-
this._onAttachedToTarget(event);
|
86
|
-
});
|
87
|
-
session.on('Target.detachedFromTarget', async (event) => {
|
88
|
-
this._onDetachedFromTarget(event);
|
89
|
-
});
|
90
|
-
}
|
91
|
-
async initialize(client = this._client) {
|
92
|
-
try {
|
93
|
-
const result = await Promise.all([
|
94
|
-
client.send('Page.enable'),
|
95
|
-
client.send('Page.getFrameTree'),
|
96
|
-
]);
|
97
|
-
const { frameTree } = result[1];
|
98
|
-
this._handleFrameTree(client, frameTree);
|
99
|
-
await Promise.all([
|
100
|
-
client.send('Page.setLifecycleEventsEnabled', { enabled: true }),
|
101
|
-
client
|
102
|
-
.send('Runtime.enable')
|
103
|
-
.then(() => this._ensureIsolatedWorld(client, UTILITY_WORLD_NAME)),
|
104
|
-
// TODO: Network manager is not aware of OOP iframes yet.
|
105
|
-
client === this._client
|
106
|
-
? this._networkManager.initialize()
|
107
|
-
: Promise.resolve(),
|
108
|
-
]);
|
109
|
-
}
|
110
|
-
catch (error) {
|
111
|
-
// The target might have been closed before the initialization finished.
|
112
|
-
if (error.message.includes('Target closed') ||
|
113
|
-
error.message.includes('Session closed')) {
|
114
|
-
return;
|
115
|
-
}
|
116
|
-
throw error;
|
117
|
-
}
|
118
|
-
}
|
119
|
-
networkManager() {
|
120
|
-
return this._networkManager;
|
121
|
-
}
|
122
|
-
async navigateFrame(frame, url, options = {}) {
|
123
|
-
assertNoLegacyNavigationOptions(options);
|
124
|
-
const { referer = this._networkManager.extraHTTPHeaders()['referer'], waitUntil = ['load'], timeout = this._timeoutSettings.navigationTimeout(), } = options;
|
125
|
-
const watcher = new LifecycleWatcher(this, frame, waitUntil, timeout);
|
126
|
-
let ensureNewDocumentNavigation = false;
|
127
|
-
let error = await Promise.race([
|
128
|
-
navigate(this._client, url, referer, frame._id),
|
129
|
-
watcher.timeoutOrTerminationPromise(),
|
130
|
-
]);
|
131
|
-
if (!error) {
|
132
|
-
error = await Promise.race([
|
133
|
-
watcher.timeoutOrTerminationPromise(),
|
134
|
-
ensureNewDocumentNavigation
|
135
|
-
? watcher.newDocumentNavigationPromise()
|
136
|
-
: watcher.sameDocumentNavigationPromise(),
|
137
|
-
]);
|
138
|
-
}
|
139
|
-
watcher.dispose();
|
140
|
-
if (error)
|
141
|
-
throw error;
|
142
|
-
return watcher.navigationResponse();
|
143
|
-
async function navigate(client, url, referrer, frameId) {
|
144
|
-
try {
|
145
|
-
const response = await client.send('Page.navigate', {
|
146
|
-
url,
|
147
|
-
referrer,
|
148
|
-
frameId,
|
149
|
-
});
|
150
|
-
ensureNewDocumentNavigation = !!response.loaderId;
|
151
|
-
return response.errorText
|
152
|
-
? new Error(`${response.errorText} at ${url}`)
|
153
|
-
: null;
|
154
|
-
}
|
155
|
-
catch (error) {
|
156
|
-
return error;
|
157
|
-
}
|
158
|
-
}
|
159
|
-
}
|
160
|
-
async waitForFrameNavigation(frame, options = {}) {
|
161
|
-
assertNoLegacyNavigationOptions(options);
|
162
|
-
const { waitUntil = ['load'], timeout = this._timeoutSettings.navigationTimeout(), } = options;
|
163
|
-
const watcher = new LifecycleWatcher(this, frame, waitUntil, timeout);
|
164
|
-
const error = await Promise.race([
|
165
|
-
watcher.timeoutOrTerminationPromise(),
|
166
|
-
watcher.sameDocumentNavigationPromise(),
|
167
|
-
watcher.newDocumentNavigationPromise(),
|
168
|
-
]);
|
169
|
-
watcher.dispose();
|
170
|
-
if (error)
|
171
|
-
throw error;
|
172
|
-
return watcher.navigationResponse();
|
173
|
-
}
|
174
|
-
async _onAttachedToTarget(event) {
|
175
|
-
if (event.targetInfo.type !== 'iframe') {
|
176
|
-
return;
|
177
|
-
}
|
178
|
-
const frame = this._frames.get(event.targetInfo.targetId);
|
179
|
-
const session = Connection.fromSession(this._client).session(event.sessionId);
|
180
|
-
frame._updateClient(session);
|
181
|
-
this.setupEventListeners(session);
|
182
|
-
await this.initialize(session);
|
183
|
-
}
|
184
|
-
async _onDetachedFromTarget(event) {
|
185
|
-
const frame = this._frames.get(event.targetId);
|
186
|
-
if (frame && frame.isOOPFrame()) {
|
187
|
-
// When an OOP iframe is removed from the page, it
|
188
|
-
// will only get a Target.detachedFromTarget event.
|
189
|
-
this._removeFramesRecursively(frame);
|
190
|
-
}
|
191
|
-
}
|
192
|
-
_onLifecycleEvent(event) {
|
193
|
-
const frame = this._frames.get(event.frameId);
|
194
|
-
if (!frame)
|
195
|
-
return;
|
196
|
-
frame._onLifecycleEvent(event.loaderId, event.name);
|
197
|
-
this.emit(FrameManagerEmittedEvents.LifecycleEvent, frame);
|
198
|
-
}
|
199
|
-
_onFrameStoppedLoading(frameId) {
|
200
|
-
const frame = this._frames.get(frameId);
|
201
|
-
if (!frame)
|
202
|
-
return;
|
203
|
-
frame._onLoadingStopped();
|
204
|
-
this.emit(FrameManagerEmittedEvents.LifecycleEvent, frame);
|
205
|
-
}
|
206
|
-
_handleFrameTree(session, frameTree) {
|
207
|
-
if (frameTree.frame.parentId) {
|
208
|
-
this._onFrameAttached(session, frameTree.frame.id, frameTree.frame.parentId);
|
209
|
-
}
|
210
|
-
this._onFrameNavigated(frameTree.frame);
|
211
|
-
if (!frameTree.childFrames)
|
212
|
-
return;
|
213
|
-
for (const child of frameTree.childFrames) {
|
214
|
-
this._handleFrameTree(session, child);
|
215
|
-
}
|
216
|
-
}
|
217
|
-
page() {
|
218
|
-
return this._page;
|
219
|
-
}
|
220
|
-
mainFrame() {
|
221
|
-
return this._mainFrame;
|
222
|
-
}
|
223
|
-
frames() {
|
224
|
-
return Array.from(this._frames.values());
|
225
|
-
}
|
226
|
-
frame(frameId) {
|
227
|
-
return this._frames.get(frameId) || null;
|
228
|
-
}
|
229
|
-
_onFrameAttached(session, frameId, parentFrameId) {
|
230
|
-
if (this._frames.has(frameId)) {
|
231
|
-
const frame = this._frames.get(frameId);
|
232
|
-
if (session && frame.isOOPFrame()) {
|
233
|
-
// If an OOP iframes becomes a normal iframe again
|
234
|
-
// it is first attached to the parent page before
|
235
|
-
// the target is removed.
|
236
|
-
frame._updateClient(session);
|
237
|
-
}
|
238
|
-
return;
|
239
|
-
}
|
240
|
-
assert(parentFrameId);
|
241
|
-
const parentFrame = this._frames.get(parentFrameId);
|
242
|
-
const frame = new Frame(this, parentFrame, frameId, session);
|
243
|
-
this._frames.set(frame._id, frame);
|
244
|
-
this.emit(FrameManagerEmittedEvents.FrameAttached, frame);
|
245
|
-
}
|
246
|
-
_onFrameNavigated(framePayload) {
|
247
|
-
const isMainFrame = !framePayload.parentId;
|
248
|
-
let frame = isMainFrame
|
249
|
-
? this._mainFrame
|
250
|
-
: this._frames.get(framePayload.id);
|
251
|
-
assert(isMainFrame || frame, 'We either navigate top level or have old version of the navigated frame');
|
252
|
-
// Detach all child frames first.
|
253
|
-
if (frame) {
|
254
|
-
for (const child of frame.childFrames())
|
255
|
-
this._removeFramesRecursively(child);
|
256
|
-
}
|
257
|
-
// Update or create main frame.
|
258
|
-
if (isMainFrame) {
|
259
|
-
if (frame) {
|
260
|
-
// Update frame id to retain frame identity on cross-process navigation.
|
261
|
-
this._frames.delete(frame._id);
|
262
|
-
frame._id = framePayload.id;
|
263
|
-
}
|
264
|
-
else {
|
265
|
-
// Initial main frame navigation.
|
266
|
-
frame = new Frame(this, null, framePayload.id, this._client);
|
267
|
-
}
|
268
|
-
this._frames.set(framePayload.id, frame);
|
269
|
-
this._mainFrame = frame;
|
270
|
-
}
|
271
|
-
// Update frame payload.
|
272
|
-
frame._navigated(framePayload);
|
273
|
-
this.emit(FrameManagerEmittedEvents.FrameNavigated, frame);
|
274
|
-
}
|
275
|
-
async _ensureIsolatedWorld(session, name) {
|
276
|
-
const key = `${session.id()}:${name}`;
|
277
|
-
if (this._isolatedWorlds.has(key))
|
278
|
-
return;
|
279
|
-
this._isolatedWorlds.add(key);
|
280
|
-
await session.send('Page.addScriptToEvaluateOnNewDocument', {
|
281
|
-
source: `//# sourceURL=${EVALUATION_SCRIPT_URL}`,
|
282
|
-
worldName: name,
|
283
|
-
});
|
284
|
-
// Frames might be removed before we send this.
|
285
|
-
await Promise.all(this.frames()
|
286
|
-
.filter((frame) => frame._client === session)
|
287
|
-
.map((frame) => session.send('Page.createIsolatedWorld', {
|
288
|
-
frameId: frame._id,
|
289
|
-
worldName: name,
|
290
|
-
grantUniveralAccess: true,
|
291
|
-
})));
|
292
|
-
}
|
293
|
-
_onFrameNavigatedWithinDocument(frameId, url) {
|
294
|
-
const frame = this._frames.get(frameId);
|
295
|
-
if (!frame)
|
296
|
-
return;
|
297
|
-
frame._navigatedWithinDocument(url);
|
298
|
-
this.emit(FrameManagerEmittedEvents.FrameNavigatedWithinDocument, frame);
|
299
|
-
this.emit(FrameManagerEmittedEvents.FrameNavigated, frame);
|
300
|
-
}
|
301
|
-
_onFrameDetached(frameId, reason) {
|
302
|
-
const frame = this._frames.get(frameId);
|
303
|
-
if (reason === 'remove') {
|
304
|
-
// Only remove the frame if the reason for the detached event is
|
305
|
-
// an actual removement of the frame.
|
306
|
-
// For frames that become OOP iframes, the reason would be 'swap'.
|
307
|
-
if (frame)
|
308
|
-
this._removeFramesRecursively(frame);
|
309
|
-
}
|
310
|
-
}
|
311
|
-
_onExecutionContextCreated(contextPayload, session) {
|
312
|
-
const auxData = contextPayload.auxData;
|
313
|
-
const frameId = auxData ? auxData.frameId : null;
|
314
|
-
const frame = this._frames.get(frameId) || null;
|
315
|
-
let world = null;
|
316
|
-
if (frame) {
|
317
|
-
// Only care about execution contexts created for the current session.
|
318
|
-
if (frame._client !== session)
|
319
|
-
return;
|
320
|
-
if (contextPayload.auxData && !!contextPayload.auxData['isDefault']) {
|
321
|
-
world = frame._mainWorld;
|
322
|
-
}
|
323
|
-
else if (contextPayload.name === UTILITY_WORLD_NAME &&
|
324
|
-
!frame._secondaryWorld._hasContext()) {
|
325
|
-
// In case of multiple sessions to the same target, there's a race between
|
326
|
-
// connections so we might end up creating multiple isolated worlds.
|
327
|
-
// We can use either.
|
328
|
-
world = frame._secondaryWorld;
|
329
|
-
}
|
330
|
-
}
|
331
|
-
const context = new ExecutionContext(frame._client || this._client, contextPayload, world);
|
332
|
-
if (world)
|
333
|
-
world._setContext(context);
|
334
|
-
const key = `${session.id()}:${contextPayload.id}`;
|
335
|
-
this._contextIdToContext.set(key, context);
|
336
|
-
}
|
337
|
-
_onExecutionContextDestroyed(executionContextId, session) {
|
338
|
-
const key = `${session.id()}:${executionContextId}`;
|
339
|
-
const context = this._contextIdToContext.get(key);
|
340
|
-
if (!context)
|
341
|
-
return;
|
342
|
-
this._contextIdToContext.delete(key);
|
343
|
-
if (context._world)
|
344
|
-
context._world._setContext(null);
|
345
|
-
}
|
346
|
-
_onExecutionContextsCleared(session) {
|
347
|
-
for (const [key, context] of this._contextIdToContext.entries()) {
|
348
|
-
// Make sure to only clear execution contexts that belong
|
349
|
-
// to the current session.
|
350
|
-
if (context._client !== session)
|
351
|
-
continue;
|
352
|
-
if (context._world)
|
353
|
-
context._world._setContext(null);
|
354
|
-
this._contextIdToContext.delete(key);
|
355
|
-
}
|
356
|
-
}
|
357
|
-
executionContextById(contextId, session = this._client) {
|
358
|
-
const key = `${session.id()}:${contextId}`;
|
359
|
-
const context = this._contextIdToContext.get(key);
|
360
|
-
assert(context, 'INTERNAL ERROR: missing context with id = ' + contextId);
|
361
|
-
return context;
|
362
|
-
}
|
363
|
-
_removeFramesRecursively(frame) {
|
364
|
-
for (const child of frame.childFrames())
|
365
|
-
this._removeFramesRecursively(child);
|
366
|
-
frame._detach();
|
367
|
-
this._frames.delete(frame._id);
|
368
|
-
this.emit(FrameManagerEmittedEvents.FrameDetached, frame);
|
369
|
-
}
|
370
|
-
}
|
371
|
-
/**
|
372
|
-
* At every point of time, page exposes its current frame tree via the
|
373
|
-
* {@link Page.mainFrame | page.mainFrame} and
|
374
|
-
* {@link Frame.childFrames | frame.childFrames} methods.
|
375
|
-
*
|
376
|
-
* @remarks
|
377
|
-
*
|
378
|
-
* `Frame` object lifecycles are controlled by three events that are all
|
379
|
-
* dispatched on the page object:
|
380
|
-
*
|
381
|
-
* - {@link PageEmittedEvents.FrameAttached}
|
382
|
-
*
|
383
|
-
* - {@link PageEmittedEvents.FrameNavigated}
|
384
|
-
*
|
385
|
-
* - {@link PageEmittedEvents.FrameDetached}
|
386
|
-
*
|
387
|
-
* @Example
|
388
|
-
* An example of dumping frame tree:
|
389
|
-
*
|
390
|
-
* ```js
|
391
|
-
* const puppeteer = require('puppeteer');
|
392
|
-
*
|
393
|
-
* (async () => {
|
394
|
-
* const browser = await puppeteer.launch();
|
395
|
-
* const page = await browser.newPage();
|
396
|
-
* await page.goto('https://www.google.com/chrome/browser/canary.html');
|
397
|
-
* dumpFrameTree(page.mainFrame(), '');
|
398
|
-
* await browser.close();
|
399
|
-
*
|
400
|
-
* function dumpFrameTree(frame, indent) {
|
401
|
-
* console.log(indent + frame.url());
|
402
|
-
* for (const child of frame.childFrames()) {
|
403
|
-
* dumpFrameTree(child, indent + ' ');
|
404
|
-
* }
|
405
|
-
* }
|
406
|
-
* })();
|
407
|
-
* ```
|
408
|
-
*
|
409
|
-
* @Example
|
410
|
-
* An example of getting text from an iframe element:
|
411
|
-
*
|
412
|
-
* ```js
|
413
|
-
* const frame = page.frames().find(frame => frame.name() === 'myframe');
|
414
|
-
* const text = await frame.$eval('.selector', element => element.textContent);
|
415
|
-
* console.log(text);
|
416
|
-
* ```
|
417
|
-
*
|
418
|
-
* @public
|
419
|
-
*/
|
420
|
-
export class Frame {
|
421
|
-
/**
|
422
|
-
* @internal
|
423
|
-
*/
|
424
|
-
constructor(frameManager, parentFrame, frameId, client) {
|
425
|
-
this._url = '';
|
426
|
-
this._detached = false;
|
427
|
-
/**
|
428
|
-
* @internal
|
429
|
-
*/
|
430
|
-
this._loaderId = '';
|
431
|
-
/**
|
432
|
-
* @internal
|
433
|
-
*/
|
434
|
-
this._lifecycleEvents = new Set();
|
435
|
-
this._frameManager = frameManager;
|
436
|
-
this._parentFrame = parentFrame;
|
437
|
-
this._url = '';
|
438
|
-
this._id = frameId;
|
439
|
-
this._detached = false;
|
440
|
-
this._loaderId = '';
|
441
|
-
this._childFrames = new Set();
|
442
|
-
if (this._parentFrame)
|
443
|
-
this._parentFrame._childFrames.add(this);
|
444
|
-
this._updateClient(client);
|
445
|
-
}
|
446
|
-
/**
|
447
|
-
* @internal
|
448
|
-
*/
|
449
|
-
_updateClient(client) {
|
450
|
-
this._client = client;
|
451
|
-
this._mainWorld = new DOMWorld(this._client, this._frameManager, this, this._frameManager._timeoutSettings);
|
452
|
-
this._secondaryWorld = new DOMWorld(this._client, this._frameManager, this, this._frameManager._timeoutSettings);
|
453
|
-
}
|
454
|
-
isOOPFrame() {
|
455
|
-
return this._client !== this._frameManager._client;
|
456
|
-
}
|
457
|
-
/**
|
458
|
-
* @remarks
|
459
|
-
*
|
460
|
-
* `frame.goto` will throw an error if:
|
461
|
-
* - there's an SSL error (e.g. in case of self-signed certificates).
|
462
|
-
*
|
463
|
-
* - target URL is invalid.
|
464
|
-
*
|
465
|
-
* - the `timeout` is exceeded during navigation.
|
466
|
-
*
|
467
|
-
* - the remote server does not respond or is unreachable.
|
468
|
-
*
|
469
|
-
* - the main resource failed to load.
|
470
|
-
*
|
471
|
-
* `frame.goto` will not throw an error when any valid HTTP status code is
|
472
|
-
* returned by the remote server, including 404 "Not Found" and 500 "Internal
|
473
|
-
* Server Error". The status code for such responses can be retrieved by
|
474
|
-
* calling {@link HTTPResponse.status}.
|
475
|
-
*
|
476
|
-
* NOTE: `frame.goto` either throws an error or returns a main resource
|
477
|
-
* response. The only exceptions are navigation to `about:blank` or
|
478
|
-
* navigation to the same URL with a different hash, which would succeed and
|
479
|
-
* return `null`.
|
480
|
-
*
|
481
|
-
* NOTE: Headless mode doesn't support navigation to a PDF document. See
|
482
|
-
* the {@link https://bugs.chromium.org/p/chromium/issues/detail?id=761295 | upstream
|
483
|
-
* issue}.
|
484
|
-
*
|
485
|
-
* @param url - the URL to navigate the frame to. This should include the
|
486
|
-
* scheme, e.g. `https://`.
|
487
|
-
* @param options - navigation options. `waitUntil` is useful to define when
|
488
|
-
* the navigation should be considered successful - see the docs for
|
489
|
-
* {@link PuppeteerLifeCycleEvent} for more details.
|
490
|
-
*
|
491
|
-
* @returns A promise which resolves to the main resource response. In case of
|
492
|
-
* multiple redirects, the navigation will resolve with the response of the
|
493
|
-
* last redirect.
|
494
|
-
*/
|
495
|
-
async goto(url, options = {}) {
|
496
|
-
return await this._frameManager.navigateFrame(this, url, options);
|
497
|
-
}
|
498
|
-
/**
|
499
|
-
* @remarks
|
500
|
-
*
|
501
|
-
* This resolves when the frame navigates to a new URL. It is useful for when
|
502
|
-
* you run code which will indirectly cause the frame to navigate. Consider
|
503
|
-
* this example:
|
504
|
-
*
|
505
|
-
* ```js
|
506
|
-
* const [response] = await Promise.all([
|
507
|
-
* // The navigation promise resolves after navigation has finished
|
508
|
-
* frame.waitForNavigation(),
|
509
|
-
* // Clicking the link will indirectly cause a navigation
|
510
|
-
* frame.click('a.my-link'),
|
511
|
-
* ]);
|
512
|
-
* ```
|
513
|
-
*
|
514
|
-
* Usage of the {@link https://developer.mozilla.org/en-US/docs/Web/API/History_API | History API} to change the URL is considered a navigation.
|
515
|
-
*
|
516
|
-
* @param options - options to configure when the navigation is consided finished.
|
517
|
-
* @returns a promise that resolves when the frame navigates to a new URL.
|
518
|
-
*/
|
519
|
-
async waitForNavigation(options = {}) {
|
520
|
-
return await this._frameManager.waitForFrameNavigation(this, options);
|
521
|
-
}
|
522
|
-
/**
|
523
|
-
* @returns a promise that resolves to the frame's default execution context.
|
524
|
-
*/
|
525
|
-
executionContext() {
|
526
|
-
return this._mainWorld.executionContext();
|
527
|
-
}
|
528
|
-
/**
|
529
|
-
* @remarks
|
530
|
-
*
|
531
|
-
* The only difference between {@link Frame.evaluate} and
|
532
|
-
* `frame.evaluateHandle` is that `evaluateHandle` will return the value
|
533
|
-
* wrapped in an in-page object.
|
534
|
-
*
|
535
|
-
* This method behaves identically to {@link Page.evaluateHandle} except it's
|
536
|
-
* run within the context of the `frame`, rather than the entire page.
|
537
|
-
*
|
538
|
-
* @param pageFunction - a function that is run within the frame
|
539
|
-
* @param args - arguments to be passed to the pageFunction
|
540
|
-
*/
|
541
|
-
async evaluateHandle(pageFunction, ...args) {
|
542
|
-
return this._mainWorld.evaluateHandle(pageFunction, ...args);
|
543
|
-
}
|
544
|
-
/**
|
545
|
-
* @remarks
|
546
|
-
*
|
547
|
-
* This method behaves identically to {@link Page.evaluate} except it's run
|
548
|
-
* within the context of the `frame`, rather than the entire page.
|
549
|
-
*
|
550
|
-
* @param pageFunction - a function that is run within the frame
|
551
|
-
* @param args - arguments to be passed to the pageFunction
|
552
|
-
*/
|
553
|
-
async evaluate(pageFunction, ...args) {
|
554
|
-
return this._mainWorld.evaluate(pageFunction, ...args);
|
555
|
-
}
|
556
|
-
/**
|
557
|
-
* This method queries the frame for the given selector.
|
558
|
-
*
|
559
|
-
* @param selector - a selector to query for.
|
560
|
-
* @returns A promise which resolves to an `ElementHandle` pointing at the
|
561
|
-
* element, or `null` if it was not found.
|
562
|
-
*/
|
563
|
-
async $(selector) {
|
564
|
-
return this._mainWorld.$(selector);
|
565
|
-
}
|
566
|
-
/**
|
567
|
-
* This method evaluates the given XPath expression and returns the results.
|
568
|
-
*
|
569
|
-
* @param expression - the XPath expression to evaluate.
|
570
|
-
*/
|
571
|
-
async $x(expression) {
|
572
|
-
return this._mainWorld.$x(expression);
|
573
|
-
}
|
574
|
-
/**
|
575
|
-
* @remarks
|
576
|
-
*
|
577
|
-
* This method runs `document.querySelector` within
|
578
|
-
* the frame and passes it as the first argument to `pageFunction`.
|
579
|
-
*
|
580
|
-
* If `pageFunction` returns a Promise, then `frame.$eval` would wait for
|
581
|
-
* the promise to resolve and return its value.
|
582
|
-
*
|
583
|
-
* @example
|
584
|
-
*
|
585
|
-
* ```js
|
586
|
-
* const searchValue = await frame.$eval('#search', el => el.value);
|
587
|
-
* ```
|
588
|
-
*
|
589
|
-
* @param selector - the selector to query for
|
590
|
-
* @param pageFunction - the function to be evaluated in the frame's context
|
591
|
-
* @param args - additional arguments to pass to `pageFuncton`
|
592
|
-
*/
|
593
|
-
async $eval(selector, pageFunction, ...args) {
|
594
|
-
return this._mainWorld.$eval(selector, pageFunction, ...args);
|
595
|
-
}
|
596
|
-
/**
|
597
|
-
* @remarks
|
598
|
-
*
|
599
|
-
* This method runs `Array.from(document.querySelectorAll(selector))` within
|
600
|
-
* the frame and passes it as the first argument to `pageFunction`.
|
601
|
-
*
|
602
|
-
* If `pageFunction` returns a Promise, then `frame.$$eval` would wait for
|
603
|
-
* the promise to resolve and return its value.
|
604
|
-
*
|
605
|
-
* @example
|
606
|
-
*
|
607
|
-
* ```js
|
608
|
-
* const divsCounts = await frame.$$eval('div', divs => divs.length);
|
609
|
-
* ```
|
610
|
-
*
|
611
|
-
* @param selector - the selector to query for
|
612
|
-
* @param pageFunction - the function to be evaluated in the frame's context
|
613
|
-
* @param args - additional arguments to pass to `pageFuncton`
|
614
|
-
*/
|
615
|
-
async $$eval(selector, pageFunction, ...args) {
|
616
|
-
return this._mainWorld.$$eval(selector, pageFunction, ...args);
|
617
|
-
}
|
618
|
-
/**
|
619
|
-
* This runs `document.querySelectorAll` in the frame and returns the result.
|
620
|
-
*
|
621
|
-
* @param selector - a selector to search for
|
622
|
-
* @returns An array of element handles pointing to the found frame elements.
|
623
|
-
*/
|
624
|
-
async $$(selector) {
|
625
|
-
return this._mainWorld.$$(selector);
|
626
|
-
}
|
627
|
-
/**
|
628
|
-
* @returns the full HTML contents of the frame, including the doctype.
|
629
|
-
*/
|
630
|
-
async content() {
|
631
|
-
return this._secondaryWorld.content();
|
632
|
-
}
|
633
|
-
/**
|
634
|
-
* Set the content of the frame.
|
635
|
-
*
|
636
|
-
* @param html - HTML markup to assign to the page.
|
637
|
-
* @param options - options to configure how long before timing out and at
|
638
|
-
* what point to consider the content setting successful.
|
639
|
-
*/
|
640
|
-
async setContent(html, options = {}) {
|
641
|
-
return this._secondaryWorld.setContent(html, options);
|
642
|
-
}
|
643
|
-
/**
|
644
|
-
* @remarks
|
645
|
-
*
|
646
|
-
* If the name is empty, it returns the `id` attribute instead.
|
647
|
-
*
|
648
|
-
* Note: This value is calculated once when the frame is created, and will not
|
649
|
-
* update if the attribute is changed later.
|
650
|
-
*
|
651
|
-
* @returns the frame's `name` attribute as specified in the tag.
|
652
|
-
*/
|
653
|
-
name() {
|
654
|
-
return this._name || '';
|
655
|
-
}
|
656
|
-
/**
|
657
|
-
* @returns the frame's URL.
|
658
|
-
*/
|
659
|
-
url() {
|
660
|
-
return this._url;
|
661
|
-
}
|
662
|
-
/**
|
663
|
-
* @returns the parent `Frame`, if any. Detached and main frames return `null`.
|
664
|
-
*/
|
665
|
-
parentFrame() {
|
666
|
-
return this._parentFrame;
|
667
|
-
}
|
668
|
-
/**
|
669
|
-
* @returns an array of child frames.
|
670
|
-
*/
|
671
|
-
childFrames() {
|
672
|
-
return Array.from(this._childFrames);
|
673
|
-
}
|
674
|
-
/**
|
675
|
-
* @returns `true` if the frame has been detached, or `false` otherwise.
|
676
|
-
*/
|
677
|
-
isDetached() {
|
678
|
-
return this._detached;
|
679
|
-
}
|
680
|
-
/**
|
681
|
-
* Adds a `<script>` tag into the page with the desired url or content.
|
682
|
-
*
|
683
|
-
* @param options - configure the script to add to the page.
|
684
|
-
*
|
685
|
-
* @returns a promise that resolves to the added tag when the script's
|
686
|
-
* `onload` event fires or when the script content was injected into the
|
687
|
-
* frame.
|
688
|
-
*/
|
689
|
-
async addScriptTag(options) {
|
690
|
-
return this._mainWorld.addScriptTag(options);
|
691
|
-
}
|
692
|
-
/**
|
693
|
-
* Adds a `<link rel="stylesheet">` tag into the page with the desired url or
|
694
|
-
* a `<style type="text/css">` tag with the content.
|
695
|
-
*
|
696
|
-
* @param options - configure the CSS to add to the page.
|
697
|
-
*
|
698
|
-
* @returns a promise that resolves to the added tag when the stylesheets's
|
699
|
-
* `onload` event fires or when the CSS content was injected into the
|
700
|
-
* frame.
|
701
|
-
*/
|
702
|
-
async addStyleTag(options) {
|
703
|
-
return this._mainWorld.addStyleTag(options);
|
704
|
-
}
|
705
|
-
/**
|
706
|
-
*
|
707
|
-
* This method clicks the first element found that matches `selector`.
|
708
|
-
*
|
709
|
-
* @remarks
|
710
|
-
*
|
711
|
-
* This method scrolls the element into view if needed, and then uses
|
712
|
-
* {@link Page.mouse} to click in the center of the element. If there's no
|
713
|
-
* element matching `selector`, the method throws an error.
|
714
|
-
*
|
715
|
-
* Bear in mind that if `click()` triggers a navigation event and there's a
|
716
|
-
* separate `page.waitForNavigation()` promise to be resolved, you may end up
|
717
|
-
* with a race condition that yields unexpected results. The correct pattern
|
718
|
-
* for click and wait for navigation is the following:
|
719
|
-
*
|
720
|
-
* ```javascript
|
721
|
-
* const [response] = await Promise.all([
|
722
|
-
* page.waitForNavigation(waitOptions),
|
723
|
-
* frame.click(selector, clickOptions),
|
724
|
-
* ]);
|
725
|
-
* ```
|
726
|
-
* @param selector - the selector to search for to click. If there are
|
727
|
-
* multiple elements, the first will be clicked.
|
728
|
-
*/
|
729
|
-
async click(selector, options = {}) {
|
730
|
-
return this._secondaryWorld.click(selector, options);
|
731
|
-
}
|
732
|
-
/**
|
733
|
-
* This method fetches an element with `selector` and focuses it.
|
734
|
-
*
|
735
|
-
* @remarks
|
736
|
-
* If there's no element matching `selector`, the method throws an error.
|
737
|
-
*
|
738
|
-
* @param selector - the selector for the element to focus. If there are
|
739
|
-
* multiple elements, the first will be focused.
|
740
|
-
*/
|
741
|
-
async focus(selector) {
|
742
|
-
return this._secondaryWorld.focus(selector);
|
743
|
-
}
|
744
|
-
/**
|
745
|
-
* This method fetches an element with `selector`, scrolls it into view if
|
746
|
-
* needed, and then uses {@link Page.mouse} to hover over the center of the
|
747
|
-
* element.
|
748
|
-
*
|
749
|
-
* @remarks
|
750
|
-
* If there's no element matching `selector`, the method throws an
|
751
|
-
*
|
752
|
-
* @param selector - the selector for the element to hover. If there are
|
753
|
-
* multiple elements, the first will be hovered.
|
754
|
-
*/
|
755
|
-
async hover(selector) {
|
756
|
-
return this._secondaryWorld.hover(selector);
|
757
|
-
}
|
758
|
-
/**
|
759
|
-
* Triggers a `change` and `input` event once all the provided options have
|
760
|
-
* been selected.
|
761
|
-
*
|
762
|
-
* @remarks
|
763
|
-
*
|
764
|
-
* If there's no `<select>` element matching `selector`, the
|
765
|
-
* method throws an error.
|
766
|
-
*
|
767
|
-
* @example
|
768
|
-
* ```js
|
769
|
-
* frame.select('select#colors', 'blue'); // single selection
|
770
|
-
* frame.select('select#colors', 'red', 'green', 'blue'); // multiple selections
|
771
|
-
* ```
|
772
|
-
*
|
773
|
-
* @param selector - a selector to query the frame for
|
774
|
-
* @param values - an array of values to select. If the `<select>` has the
|
775
|
-
* `multiple` attribute, all values are considered, otherwise only the first
|
776
|
-
* one is taken into account.
|
777
|
-
* @returns the list of values that were successfully selected.
|
778
|
-
*/
|
779
|
-
select(selector, ...values) {
|
780
|
-
return this._secondaryWorld.select(selector, ...values);
|
781
|
-
}
|
782
|
-
/**
|
783
|
-
* This method fetches an element with `selector`, scrolls it into view if
|
784
|
-
* needed, and then uses {@link Page.touchscreen} to tap in the center of the
|
785
|
-
* element.
|
786
|
-
*
|
787
|
-
* @remarks
|
788
|
-
*
|
789
|
-
* If there's no element matching `selector`, the method throws an error.
|
790
|
-
*
|
791
|
-
* @param selector - the selector to tap.
|
792
|
-
* @returns a promise that resolves when the element has been tapped.
|
793
|
-
*/
|
794
|
-
async tap(selector) {
|
795
|
-
return this._secondaryWorld.tap(selector);
|
796
|
-
}
|
797
|
-
/**
|
798
|
-
* Sends a `keydown`, `keypress`/`input`, and `keyup` event for each character
|
799
|
-
* in the text.
|
800
|
-
*
|
801
|
-
* @remarks
|
802
|
-
* To press a special key, like `Control` or `ArrowDown`, use
|
803
|
-
* {@link Keyboard.press}.
|
804
|
-
*
|
805
|
-
* @example
|
806
|
-
* ```js
|
807
|
-
* await frame.type('#mytextarea', 'Hello'); // Types instantly
|
808
|
-
* await frame.type('#mytextarea', 'World', {delay: 100}); // Types slower, like a user
|
809
|
-
* ```
|
810
|
-
*
|
811
|
-
* @param selector - the selector for the element to type into. If there are
|
812
|
-
* multiple the first will be used.
|
813
|
-
* @param text - text to type into the element
|
814
|
-
* @param options - takes one option, `delay`, which sets the time to wait
|
815
|
-
* between key presses in milliseconds. Defaults to `0`.
|
816
|
-
*
|
817
|
-
* @returns a promise that resolves when the typing is complete.
|
818
|
-
*/
|
819
|
-
async type(selector, text, options) {
|
820
|
-
return this._mainWorld.type(selector, text, options);
|
821
|
-
}
|
822
|
-
/**
|
823
|
-
* @remarks
|
824
|
-
*
|
825
|
-
* This method behaves differently depending on the first parameter. If it's a
|
826
|
-
* `string`, it will be treated as a `selector` or `xpath` (if the string
|
827
|
-
* starts with `//`). This method then is a shortcut for
|
828
|
-
* {@link Frame.waitForSelector} or {@link Frame.waitForXPath}.
|
829
|
-
*
|
830
|
-
* If the first argument is a function this method is a shortcut for
|
831
|
-
* {@link Frame.waitForFunction}.
|
832
|
-
*
|
833
|
-
* If the first argument is a `number`, it's treated as a timeout in
|
834
|
-
* milliseconds and the method returns a promise which resolves after the
|
835
|
-
* timeout.
|
836
|
-
*
|
837
|
-
* @param selectorOrFunctionOrTimeout - a selector, predicate or timeout to
|
838
|
-
* wait for.
|
839
|
-
* @param options - optional waiting parameters.
|
840
|
-
* @param args - arguments to pass to `pageFunction`.
|
841
|
-
*
|
842
|
-
* @deprecated Don't use this method directly. Instead use the more explicit
|
843
|
-
* methods available: {@link Frame.waitForSelector},
|
844
|
-
* {@link Frame.waitForXPath}, {@link Frame.waitForFunction} or
|
845
|
-
* {@link Frame.waitForTimeout}.
|
846
|
-
*/
|
847
|
-
waitFor(selectorOrFunctionOrTimeout, options = {}, ...args) {
|
848
|
-
console.warn('waitFor is deprecated and will be removed in a future release. See https://github.com/puppeteer/puppeteer/issues/6214 for details and how to migrate your code.');
|
849
|
-
if (helper.isString(selectorOrFunctionOrTimeout)) {
|
850
|
-
const string = selectorOrFunctionOrTimeout;
|
851
|
-
if (xPathPattern.test(string))
|
852
|
-
return this.waitForXPath(string, options);
|
853
|
-
return this.waitForSelector(string, options);
|
854
|
-
}
|
855
|
-
if (helper.isNumber(selectorOrFunctionOrTimeout))
|
856
|
-
return new Promise((fulfill) => setTimeout(fulfill, selectorOrFunctionOrTimeout));
|
857
|
-
if (typeof selectorOrFunctionOrTimeout === 'function')
|
858
|
-
return this.waitForFunction(selectorOrFunctionOrTimeout, options, ...args);
|
859
|
-
return Promise.reject(new Error('Unsupported target type: ' + typeof selectorOrFunctionOrTimeout));
|
860
|
-
}
|
861
|
-
/**
|
862
|
-
* Causes your script to wait for the given number of milliseconds.
|
863
|
-
*
|
864
|
-
* @remarks
|
865
|
-
* It's generally recommended to not wait for a number of seconds, but instead
|
866
|
-
* use {@link Frame.waitForSelector}, {@link Frame.waitForXPath} or
|
867
|
-
* {@link Frame.waitForFunction} to wait for exactly the conditions you want.
|
868
|
-
*
|
869
|
-
* @example
|
870
|
-
*
|
871
|
-
* Wait for 1 second:
|
872
|
-
*
|
873
|
-
* ```
|
874
|
-
* await frame.waitForTimeout(1000);
|
875
|
-
* ```
|
876
|
-
*
|
877
|
-
* @param milliseconds - the number of milliseconds to wait.
|
878
|
-
*/
|
879
|
-
waitForTimeout(milliseconds) {
|
880
|
-
return new Promise((resolve) => {
|
881
|
-
setTimeout(resolve, milliseconds);
|
882
|
-
});
|
883
|
-
}
|
884
|
-
/**
|
885
|
-
* @remarks
|
886
|
-
*
|
887
|
-
*
|
888
|
-
* Wait for the `selector` to appear in page. If at the moment of calling the
|
889
|
-
* method the `selector` already exists, the method will return immediately.
|
890
|
-
* If the selector doesn't appear after the `timeout` milliseconds of waiting,
|
891
|
-
* the function will throw.
|
892
|
-
*
|
893
|
-
* This method works across navigations.
|
894
|
-
*
|
895
|
-
* @example
|
896
|
-
* ```js
|
897
|
-
* const puppeteer = require('puppeteer');
|
898
|
-
*
|
899
|
-
* (async () => {
|
900
|
-
* const browser = await puppeteer.launch();
|
901
|
-
* const page = await browser.newPage();
|
902
|
-
* let currentURL;
|
903
|
-
* page.mainFrame()
|
904
|
-
* .waitForSelector('img')
|
905
|
-
* .then(() => console.log('First URL with image: ' + currentURL));
|
906
|
-
*
|
907
|
-
* for (currentURL of ['https://example.com', 'https://google.com', 'https://bbc.com']) {
|
908
|
-
* await page.goto(currentURL);
|
909
|
-
* }
|
910
|
-
* await browser.close();
|
911
|
-
* })();
|
912
|
-
* ```
|
913
|
-
* @param selector - the selector to wait for.
|
914
|
-
* @param options - options to define if the element should be visible and how
|
915
|
-
* long to wait before timing out.
|
916
|
-
* @returns a promise which resolves when an element matching the selector
|
917
|
-
* string is added to the DOM.
|
918
|
-
*/
|
919
|
-
async waitForSelector(selector, options = {}) {
|
920
|
-
const handle = await this._secondaryWorld.waitForSelector(selector, options);
|
921
|
-
if (!handle)
|
922
|
-
return null;
|
923
|
-
const mainExecutionContext = await this._mainWorld.executionContext();
|
924
|
-
const result = await mainExecutionContext._adoptElementHandle(handle);
|
925
|
-
await handle.dispose();
|
926
|
-
return result;
|
927
|
-
}
|
928
|
-
/**
|
929
|
-
* @remarks
|
930
|
-
* Wait for the `xpath` to appear in page. If at the moment of calling the
|
931
|
-
* method the `xpath` already exists, the method will return immediately. If
|
932
|
-
* the xpath doesn't appear after the `timeout` milliseconds of waiting, the
|
933
|
-
* function will throw.
|
934
|
-
*
|
935
|
-
* For a code example, see the example for {@link Frame.waitForSelector}. That
|
936
|
-
* function behaves identically other than taking a CSS selector rather than
|
937
|
-
* an XPath.
|
938
|
-
*
|
939
|
-
* @param xpath - the XPath expression to wait for.
|
940
|
-
* @param options - options to configure the visiblity of the element and how
|
941
|
-
* long to wait before timing out.
|
942
|
-
*/
|
943
|
-
async waitForXPath(xpath, options = {}) {
|
944
|
-
const handle = await this._secondaryWorld.waitForXPath(xpath, options);
|
945
|
-
if (!handle)
|
946
|
-
return null;
|
947
|
-
const mainExecutionContext = await this._mainWorld.executionContext();
|
948
|
-
const result = await mainExecutionContext._adoptElementHandle(handle);
|
949
|
-
await handle.dispose();
|
950
|
-
return result;
|
951
|
-
}
|
952
|
-
/**
|
953
|
-
* @remarks
|
954
|
-
*
|
955
|
-
* @example
|
956
|
-
*
|
957
|
-
* The `waitForFunction` can be used to observe viewport size change:
|
958
|
-
* ```js
|
959
|
-
* const puppeteer = require('puppeteer');
|
960
|
-
*
|
961
|
-
* (async () => {
|
962
|
-
* . const browser = await puppeteer.launch();
|
963
|
-
* . const page = await browser.newPage();
|
964
|
-
* . const watchDog = page.mainFrame().waitForFunction('window.innerWidth < 100');
|
965
|
-
* . page.setViewport({width: 50, height: 50});
|
966
|
-
* . await watchDog;
|
967
|
-
* . await browser.close();
|
968
|
-
* })();
|
969
|
-
* ```
|
970
|
-
*
|
971
|
-
* To pass arguments from Node.js to the predicate of `page.waitForFunction` function:
|
972
|
-
*
|
973
|
-
* ```js
|
974
|
-
* const selector = '.foo';
|
975
|
-
* await frame.waitForFunction(
|
976
|
-
* selector => !!document.querySelector(selector),
|
977
|
-
* {}, // empty options object
|
978
|
-
* selector
|
979
|
-
*);
|
980
|
-
* ```
|
981
|
-
*
|
982
|
-
* @param pageFunction - the function to evaluate in the frame context.
|
983
|
-
* @param options - options to configure the polling method and timeout.
|
984
|
-
* @param args - arguments to pass to the `pageFunction`.
|
985
|
-
* @returns the promise which resolve when the `pageFunction` returns a truthy value.
|
986
|
-
*/
|
987
|
-
waitForFunction(pageFunction, options = {}, ...args) {
|
988
|
-
return this._mainWorld.waitForFunction(pageFunction, options, ...args);
|
989
|
-
}
|
990
|
-
/**
|
991
|
-
* @returns the frame's title.
|
992
|
-
*/
|
993
|
-
async title() {
|
994
|
-
return this._secondaryWorld.title();
|
995
|
-
}
|
996
|
-
/**
|
997
|
-
* @internal
|
998
|
-
*/
|
999
|
-
_navigated(framePayload) {
|
1000
|
-
this._name = framePayload.name;
|
1001
|
-
this._url = `${framePayload.url}${framePayload.urlFragment || ''}`;
|
1002
|
-
}
|
1003
|
-
/**
|
1004
|
-
* @internal
|
1005
|
-
*/
|
1006
|
-
_navigatedWithinDocument(url) {
|
1007
|
-
this._url = url;
|
1008
|
-
}
|
1009
|
-
/**
|
1010
|
-
* @internal
|
1011
|
-
*/
|
1012
|
-
_onLifecycleEvent(loaderId, name) {
|
1013
|
-
if (name === 'init') {
|
1014
|
-
this._loaderId = loaderId;
|
1015
|
-
this._lifecycleEvents.clear();
|
1016
|
-
}
|
1017
|
-
this._lifecycleEvents.add(name);
|
1018
|
-
}
|
1019
|
-
/**
|
1020
|
-
* @internal
|
1021
|
-
*/
|
1022
|
-
_onLoadingStopped() {
|
1023
|
-
this._lifecycleEvents.add('DOMContentLoaded');
|
1024
|
-
this._lifecycleEvents.add('load');
|
1025
|
-
}
|
1026
|
-
/**
|
1027
|
-
* @internal
|
1028
|
-
*/
|
1029
|
-
_detach() {
|
1030
|
-
this._detached = true;
|
1031
|
-
this._mainWorld._detach();
|
1032
|
-
this._secondaryWorld._detach();
|
1033
|
-
if (this._parentFrame)
|
1034
|
-
this._parentFrame._childFrames.delete(this);
|
1035
|
-
this._parentFrame = null;
|
1036
|
-
}
|
1037
|
-
}
|
1038
|
-
function assertNoLegacyNavigationOptions(options) {
|
1039
|
-
assert(options['networkIdleTimeout'] === undefined, 'ERROR: networkIdleTimeout option is no longer supported.');
|
1040
|
-
assert(options['networkIdleInflight'] === undefined, 'ERROR: networkIdleInflight option is no longer supported.');
|
1041
|
-
assert(options.waitUntil !== 'networkidle', 'ERROR: "networkidle" option is no longer supported. Use "networkidle2" instead');
|
1042
|
-
}
|
1
|
+
/**
|
2
|
+
* Copyright 2017 Google Inc. All rights reserved.
|
3
|
+
*
|
4
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
5
|
+
* you may not use this file except in compliance with the License.
|
6
|
+
* You may obtain a copy of the License at
|
7
|
+
*
|
8
|
+
* http://www.apache.org/licenses/LICENSE-2.0
|
9
|
+
*
|
10
|
+
* Unless required by applicable law or agreed to in writing, software
|
11
|
+
* distributed under the License is distributed on an "AS IS" BASIS,
|
12
|
+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
13
|
+
* See the License for the specific language governing permissions and
|
14
|
+
* limitations under the License.
|
15
|
+
*/
|
16
|
+
import { EventEmitter } from './EventEmitter.js';
|
17
|
+
import { assert } from './assert.js';
|
18
|
+
import { helper } from './helper.js';
|
19
|
+
import { ExecutionContext, EVALUATION_SCRIPT_URL } from './ExecutionContext.js';
|
20
|
+
import { LifecycleWatcher, } from './LifecycleWatcher.js';
|
21
|
+
import { DOMWorld } from './DOMWorld.js';
|
22
|
+
import { NetworkManager } from './NetworkManager.js';
|
23
|
+
import { Connection } from './Connection.js';
|
24
|
+
const UTILITY_WORLD_NAME = '__puppeteer_utility_world__';
|
25
|
+
const xPathPattern = /^\(\/\/[^\)]+\)|^\/\//;
|
26
|
+
/**
|
27
|
+
* We use symbols to prevent external parties listening to these events.
|
28
|
+
* They are internal to Puppeteer.
|
29
|
+
*
|
30
|
+
* @internal
|
31
|
+
*/
|
32
|
+
export const FrameManagerEmittedEvents = {
|
33
|
+
FrameAttached: Symbol('FrameManager.FrameAttached'),
|
34
|
+
FrameNavigated: Symbol('FrameManager.FrameNavigated'),
|
35
|
+
FrameDetached: Symbol('FrameManager.FrameDetached'),
|
36
|
+
LifecycleEvent: Symbol('FrameManager.LifecycleEvent'),
|
37
|
+
FrameNavigatedWithinDocument: Symbol('FrameManager.FrameNavigatedWithinDocument'),
|
38
|
+
ExecutionContextCreated: Symbol('FrameManager.ExecutionContextCreated'),
|
39
|
+
ExecutionContextDestroyed: Symbol('FrameManager.ExecutionContextDestroyed'),
|
40
|
+
};
|
41
|
+
/**
|
42
|
+
* @internal
|
43
|
+
*/
|
44
|
+
export class FrameManager extends EventEmitter {
|
45
|
+
constructor(client, page, ignoreHTTPSErrors, timeoutSettings) {
|
46
|
+
super();
|
47
|
+
this._frames = new Map();
|
48
|
+
this._contextIdToContext = new Map();
|
49
|
+
this._isolatedWorlds = new Set();
|
50
|
+
this._client = client;
|
51
|
+
this._page = page;
|
52
|
+
this._networkManager = new NetworkManager(client, ignoreHTTPSErrors, this);
|
53
|
+
this._timeoutSettings = timeoutSettings;
|
54
|
+
this.setupEventListeners(this._client);
|
55
|
+
}
|
56
|
+
setupEventListeners(session) {
|
57
|
+
session.on('Page.frameAttached', (event) => {
|
58
|
+
this._onFrameAttached(session, event.frameId, event.parentFrameId);
|
59
|
+
});
|
60
|
+
session.on('Page.frameNavigated', (event) => {
|
61
|
+
this._onFrameNavigated(event.frame);
|
62
|
+
});
|
63
|
+
session.on('Page.navigatedWithinDocument', (event) => {
|
64
|
+
this._onFrameNavigatedWithinDocument(event.frameId, event.url);
|
65
|
+
});
|
66
|
+
session.on('Page.frameDetached', (event) => {
|
67
|
+
this._onFrameDetached(event.frameId, event.reason);
|
68
|
+
});
|
69
|
+
session.on('Page.frameStoppedLoading', (event) => {
|
70
|
+
this._onFrameStoppedLoading(event.frameId);
|
71
|
+
});
|
72
|
+
session.on('Runtime.executionContextCreated', (event) => {
|
73
|
+
this._onExecutionContextCreated(event.context, session);
|
74
|
+
});
|
75
|
+
session.on('Runtime.executionContextDestroyed', (event) => {
|
76
|
+
this._onExecutionContextDestroyed(event.executionContextId, session);
|
77
|
+
});
|
78
|
+
session.on('Runtime.executionContextsCleared', () => {
|
79
|
+
this._onExecutionContextsCleared(session);
|
80
|
+
});
|
81
|
+
session.on('Page.lifecycleEvent', (event) => {
|
82
|
+
this._onLifecycleEvent(event);
|
83
|
+
});
|
84
|
+
session.on('Target.attachedToTarget', async (event) => {
|
85
|
+
this._onAttachedToTarget(event);
|
86
|
+
});
|
87
|
+
session.on('Target.detachedFromTarget', async (event) => {
|
88
|
+
this._onDetachedFromTarget(event);
|
89
|
+
});
|
90
|
+
}
|
91
|
+
async initialize(client = this._client) {
|
92
|
+
try {
|
93
|
+
const result = await Promise.all([
|
94
|
+
client.send('Page.enable'),
|
95
|
+
client.send('Page.getFrameTree'),
|
96
|
+
]);
|
97
|
+
const { frameTree } = result[1];
|
98
|
+
this._handleFrameTree(client, frameTree);
|
99
|
+
await Promise.all([
|
100
|
+
client.send('Page.setLifecycleEventsEnabled', { enabled: true }),
|
101
|
+
client
|
102
|
+
.send('Runtime.enable')
|
103
|
+
.then(() => this._ensureIsolatedWorld(client, UTILITY_WORLD_NAME)),
|
104
|
+
// TODO: Network manager is not aware of OOP iframes yet.
|
105
|
+
client === this._client
|
106
|
+
? this._networkManager.initialize()
|
107
|
+
: Promise.resolve(),
|
108
|
+
]);
|
109
|
+
}
|
110
|
+
catch (error) {
|
111
|
+
// The target might have been closed before the initialization finished.
|
112
|
+
if (error.message.includes('Target closed') ||
|
113
|
+
error.message.includes('Session closed')) {
|
114
|
+
return;
|
115
|
+
}
|
116
|
+
throw error;
|
117
|
+
}
|
118
|
+
}
|
119
|
+
networkManager() {
|
120
|
+
return this._networkManager;
|
121
|
+
}
|
122
|
+
async navigateFrame(frame, url, options = {}) {
|
123
|
+
assertNoLegacyNavigationOptions(options);
|
124
|
+
const { referer = this._networkManager.extraHTTPHeaders()['referer'], waitUntil = ['load'], timeout = this._timeoutSettings.navigationTimeout(), } = options;
|
125
|
+
const watcher = new LifecycleWatcher(this, frame, waitUntil, timeout);
|
126
|
+
let ensureNewDocumentNavigation = false;
|
127
|
+
let error = await Promise.race([
|
128
|
+
navigate(this._client, url, referer, frame._id),
|
129
|
+
watcher.timeoutOrTerminationPromise(),
|
130
|
+
]);
|
131
|
+
if (!error) {
|
132
|
+
error = await Promise.race([
|
133
|
+
watcher.timeoutOrTerminationPromise(),
|
134
|
+
ensureNewDocumentNavigation
|
135
|
+
? watcher.newDocumentNavigationPromise()
|
136
|
+
: watcher.sameDocumentNavigationPromise(),
|
137
|
+
]);
|
138
|
+
}
|
139
|
+
watcher.dispose();
|
140
|
+
if (error)
|
141
|
+
throw error;
|
142
|
+
return await watcher.navigationResponse();
|
143
|
+
async function navigate(client, url, referrer, frameId) {
|
144
|
+
try {
|
145
|
+
const response = await client.send('Page.navigate', {
|
146
|
+
url,
|
147
|
+
referrer,
|
148
|
+
frameId,
|
149
|
+
});
|
150
|
+
ensureNewDocumentNavigation = !!response.loaderId;
|
151
|
+
return response.errorText
|
152
|
+
? new Error(`${response.errorText} at ${url}`)
|
153
|
+
: null;
|
154
|
+
}
|
155
|
+
catch (error) {
|
156
|
+
return error;
|
157
|
+
}
|
158
|
+
}
|
159
|
+
}
|
160
|
+
async waitForFrameNavigation(frame, options = {}) {
|
161
|
+
assertNoLegacyNavigationOptions(options);
|
162
|
+
const { waitUntil = ['load'], timeout = this._timeoutSettings.navigationTimeout(), } = options;
|
163
|
+
const watcher = new LifecycleWatcher(this, frame, waitUntil, timeout);
|
164
|
+
const error = await Promise.race([
|
165
|
+
watcher.timeoutOrTerminationPromise(),
|
166
|
+
watcher.sameDocumentNavigationPromise(),
|
167
|
+
watcher.newDocumentNavigationPromise(),
|
168
|
+
]);
|
169
|
+
watcher.dispose();
|
170
|
+
if (error)
|
171
|
+
throw error;
|
172
|
+
return await watcher.navigationResponse();
|
173
|
+
}
|
174
|
+
async _onAttachedToTarget(event) {
|
175
|
+
if (event.targetInfo.type !== 'iframe') {
|
176
|
+
return;
|
177
|
+
}
|
178
|
+
const frame = this._frames.get(event.targetInfo.targetId);
|
179
|
+
const session = Connection.fromSession(this._client).session(event.sessionId);
|
180
|
+
frame._updateClient(session);
|
181
|
+
this.setupEventListeners(session);
|
182
|
+
await this.initialize(session);
|
183
|
+
}
|
184
|
+
async _onDetachedFromTarget(event) {
|
185
|
+
const frame = this._frames.get(event.targetId);
|
186
|
+
if (frame && frame.isOOPFrame()) {
|
187
|
+
// When an OOP iframe is removed from the page, it
|
188
|
+
// will only get a Target.detachedFromTarget event.
|
189
|
+
this._removeFramesRecursively(frame);
|
190
|
+
}
|
191
|
+
}
|
192
|
+
_onLifecycleEvent(event) {
|
193
|
+
const frame = this._frames.get(event.frameId);
|
194
|
+
if (!frame)
|
195
|
+
return;
|
196
|
+
frame._onLifecycleEvent(event.loaderId, event.name);
|
197
|
+
this.emit(FrameManagerEmittedEvents.LifecycleEvent, frame);
|
198
|
+
}
|
199
|
+
_onFrameStoppedLoading(frameId) {
|
200
|
+
const frame = this._frames.get(frameId);
|
201
|
+
if (!frame)
|
202
|
+
return;
|
203
|
+
frame._onLoadingStopped();
|
204
|
+
this.emit(FrameManagerEmittedEvents.LifecycleEvent, frame);
|
205
|
+
}
|
206
|
+
_handleFrameTree(session, frameTree) {
|
207
|
+
if (frameTree.frame.parentId) {
|
208
|
+
this._onFrameAttached(session, frameTree.frame.id, frameTree.frame.parentId);
|
209
|
+
}
|
210
|
+
this._onFrameNavigated(frameTree.frame);
|
211
|
+
if (!frameTree.childFrames)
|
212
|
+
return;
|
213
|
+
for (const child of frameTree.childFrames) {
|
214
|
+
this._handleFrameTree(session, child);
|
215
|
+
}
|
216
|
+
}
|
217
|
+
page() {
|
218
|
+
return this._page;
|
219
|
+
}
|
220
|
+
mainFrame() {
|
221
|
+
return this._mainFrame;
|
222
|
+
}
|
223
|
+
frames() {
|
224
|
+
return Array.from(this._frames.values());
|
225
|
+
}
|
226
|
+
frame(frameId) {
|
227
|
+
return this._frames.get(frameId) || null;
|
228
|
+
}
|
229
|
+
_onFrameAttached(session, frameId, parentFrameId) {
|
230
|
+
if (this._frames.has(frameId)) {
|
231
|
+
const frame = this._frames.get(frameId);
|
232
|
+
if (session && frame.isOOPFrame()) {
|
233
|
+
// If an OOP iframes becomes a normal iframe again
|
234
|
+
// it is first attached to the parent page before
|
235
|
+
// the target is removed.
|
236
|
+
frame._updateClient(session);
|
237
|
+
}
|
238
|
+
return;
|
239
|
+
}
|
240
|
+
assert(parentFrameId);
|
241
|
+
const parentFrame = this._frames.get(parentFrameId);
|
242
|
+
const frame = new Frame(this, parentFrame, frameId, session);
|
243
|
+
this._frames.set(frame._id, frame);
|
244
|
+
this.emit(FrameManagerEmittedEvents.FrameAttached, frame);
|
245
|
+
}
|
246
|
+
_onFrameNavigated(framePayload) {
|
247
|
+
const isMainFrame = !framePayload.parentId;
|
248
|
+
let frame = isMainFrame
|
249
|
+
? this._mainFrame
|
250
|
+
: this._frames.get(framePayload.id);
|
251
|
+
assert(isMainFrame || frame, 'We either navigate top level or have old version of the navigated frame');
|
252
|
+
// Detach all child frames first.
|
253
|
+
if (frame) {
|
254
|
+
for (const child of frame.childFrames())
|
255
|
+
this._removeFramesRecursively(child);
|
256
|
+
}
|
257
|
+
// Update or create main frame.
|
258
|
+
if (isMainFrame) {
|
259
|
+
if (frame) {
|
260
|
+
// Update frame id to retain frame identity on cross-process navigation.
|
261
|
+
this._frames.delete(frame._id);
|
262
|
+
frame._id = framePayload.id;
|
263
|
+
}
|
264
|
+
else {
|
265
|
+
// Initial main frame navigation.
|
266
|
+
frame = new Frame(this, null, framePayload.id, this._client);
|
267
|
+
}
|
268
|
+
this._frames.set(framePayload.id, frame);
|
269
|
+
this._mainFrame = frame;
|
270
|
+
}
|
271
|
+
// Update frame payload.
|
272
|
+
frame._navigated(framePayload);
|
273
|
+
this.emit(FrameManagerEmittedEvents.FrameNavigated, frame);
|
274
|
+
}
|
275
|
+
async _ensureIsolatedWorld(session, name) {
|
276
|
+
const key = `${session.id()}:${name}`;
|
277
|
+
if (this._isolatedWorlds.has(key))
|
278
|
+
return;
|
279
|
+
this._isolatedWorlds.add(key);
|
280
|
+
await session.send('Page.addScriptToEvaluateOnNewDocument', {
|
281
|
+
source: `//# sourceURL=${EVALUATION_SCRIPT_URL}`,
|
282
|
+
worldName: name,
|
283
|
+
});
|
284
|
+
// Frames might be removed before we send this.
|
285
|
+
await Promise.all(this.frames()
|
286
|
+
.filter((frame) => frame._client === session)
|
287
|
+
.map((frame) => session.send('Page.createIsolatedWorld', {
|
288
|
+
frameId: frame._id,
|
289
|
+
worldName: name,
|
290
|
+
grantUniveralAccess: true,
|
291
|
+
})));
|
292
|
+
}
|
293
|
+
_onFrameNavigatedWithinDocument(frameId, url) {
|
294
|
+
const frame = this._frames.get(frameId);
|
295
|
+
if (!frame)
|
296
|
+
return;
|
297
|
+
frame._navigatedWithinDocument(url);
|
298
|
+
this.emit(FrameManagerEmittedEvents.FrameNavigatedWithinDocument, frame);
|
299
|
+
this.emit(FrameManagerEmittedEvents.FrameNavigated, frame);
|
300
|
+
}
|
301
|
+
_onFrameDetached(frameId, reason) {
|
302
|
+
const frame = this._frames.get(frameId);
|
303
|
+
if (reason === 'remove') {
|
304
|
+
// Only remove the frame if the reason for the detached event is
|
305
|
+
// an actual removement of the frame.
|
306
|
+
// For frames that become OOP iframes, the reason would be 'swap'.
|
307
|
+
if (frame)
|
308
|
+
this._removeFramesRecursively(frame);
|
309
|
+
}
|
310
|
+
}
|
311
|
+
_onExecutionContextCreated(contextPayload, session) {
|
312
|
+
const auxData = contextPayload.auxData;
|
313
|
+
const frameId = auxData ? auxData.frameId : null;
|
314
|
+
const frame = this._frames.get(frameId) || null;
|
315
|
+
let world = null;
|
316
|
+
if (frame) {
|
317
|
+
// Only care about execution contexts created for the current session.
|
318
|
+
if (frame._client !== session)
|
319
|
+
return;
|
320
|
+
if (contextPayload.auxData && !!contextPayload.auxData['isDefault']) {
|
321
|
+
world = frame._mainWorld;
|
322
|
+
}
|
323
|
+
else if (contextPayload.name === UTILITY_WORLD_NAME &&
|
324
|
+
!frame._secondaryWorld._hasContext()) {
|
325
|
+
// In case of multiple sessions to the same target, there's a race between
|
326
|
+
// connections so we might end up creating multiple isolated worlds.
|
327
|
+
// We can use either.
|
328
|
+
world = frame._secondaryWorld;
|
329
|
+
}
|
330
|
+
}
|
331
|
+
const context = new ExecutionContext((frame === null || frame === void 0 ? void 0 : frame._client) || this._client, contextPayload, world);
|
332
|
+
if (world)
|
333
|
+
world._setContext(context);
|
334
|
+
const key = `${session.id()}:${contextPayload.id}`;
|
335
|
+
this._contextIdToContext.set(key, context);
|
336
|
+
}
|
337
|
+
_onExecutionContextDestroyed(executionContextId, session) {
|
338
|
+
const key = `${session.id()}:${executionContextId}`;
|
339
|
+
const context = this._contextIdToContext.get(key);
|
340
|
+
if (!context)
|
341
|
+
return;
|
342
|
+
this._contextIdToContext.delete(key);
|
343
|
+
if (context._world)
|
344
|
+
context._world._setContext(null);
|
345
|
+
}
|
346
|
+
_onExecutionContextsCleared(session) {
|
347
|
+
for (const [key, context] of this._contextIdToContext.entries()) {
|
348
|
+
// Make sure to only clear execution contexts that belong
|
349
|
+
// to the current session.
|
350
|
+
if (context._client !== session)
|
351
|
+
continue;
|
352
|
+
if (context._world)
|
353
|
+
context._world._setContext(null);
|
354
|
+
this._contextIdToContext.delete(key);
|
355
|
+
}
|
356
|
+
}
|
357
|
+
executionContextById(contextId, session = this._client) {
|
358
|
+
const key = `${session.id()}:${contextId}`;
|
359
|
+
const context = this._contextIdToContext.get(key);
|
360
|
+
assert(context, 'INTERNAL ERROR: missing context with id = ' + contextId);
|
361
|
+
return context;
|
362
|
+
}
|
363
|
+
_removeFramesRecursively(frame) {
|
364
|
+
for (const child of frame.childFrames())
|
365
|
+
this._removeFramesRecursively(child);
|
366
|
+
frame._detach();
|
367
|
+
this._frames.delete(frame._id);
|
368
|
+
this.emit(FrameManagerEmittedEvents.FrameDetached, frame);
|
369
|
+
}
|
370
|
+
}
|
371
|
+
/**
|
372
|
+
* At every point of time, page exposes its current frame tree via the
|
373
|
+
* {@link Page.mainFrame | page.mainFrame} and
|
374
|
+
* {@link Frame.childFrames | frame.childFrames} methods.
|
375
|
+
*
|
376
|
+
* @remarks
|
377
|
+
*
|
378
|
+
* `Frame` object lifecycles are controlled by three events that are all
|
379
|
+
* dispatched on the page object:
|
380
|
+
*
|
381
|
+
* - {@link PageEmittedEvents.FrameAttached}
|
382
|
+
*
|
383
|
+
* - {@link PageEmittedEvents.FrameNavigated}
|
384
|
+
*
|
385
|
+
* - {@link PageEmittedEvents.FrameDetached}
|
386
|
+
*
|
387
|
+
* @Example
|
388
|
+
* An example of dumping frame tree:
|
389
|
+
*
|
390
|
+
* ```js
|
391
|
+
* const puppeteer = require('puppeteer');
|
392
|
+
*
|
393
|
+
* (async () => {
|
394
|
+
* const browser = await puppeteer.launch();
|
395
|
+
* const page = await browser.newPage();
|
396
|
+
* await page.goto('https://www.google.com/chrome/browser/canary.html');
|
397
|
+
* dumpFrameTree(page.mainFrame(), '');
|
398
|
+
* await browser.close();
|
399
|
+
*
|
400
|
+
* function dumpFrameTree(frame, indent) {
|
401
|
+
* console.log(indent + frame.url());
|
402
|
+
* for (const child of frame.childFrames()) {
|
403
|
+
* dumpFrameTree(child, indent + ' ');
|
404
|
+
* }
|
405
|
+
* }
|
406
|
+
* })();
|
407
|
+
* ```
|
408
|
+
*
|
409
|
+
* @Example
|
410
|
+
* An example of getting text from an iframe element:
|
411
|
+
*
|
412
|
+
* ```js
|
413
|
+
* const frame = page.frames().find(frame => frame.name() === 'myframe');
|
414
|
+
* const text = await frame.$eval('.selector', element => element.textContent);
|
415
|
+
* console.log(text);
|
416
|
+
* ```
|
417
|
+
*
|
418
|
+
* @public
|
419
|
+
*/
|
420
|
+
export class Frame {
|
421
|
+
/**
|
422
|
+
* @internal
|
423
|
+
*/
|
424
|
+
constructor(frameManager, parentFrame, frameId, client) {
|
425
|
+
this._url = '';
|
426
|
+
this._detached = false;
|
427
|
+
/**
|
428
|
+
* @internal
|
429
|
+
*/
|
430
|
+
this._loaderId = '';
|
431
|
+
/**
|
432
|
+
* @internal
|
433
|
+
*/
|
434
|
+
this._lifecycleEvents = new Set();
|
435
|
+
this._frameManager = frameManager;
|
436
|
+
this._parentFrame = parentFrame;
|
437
|
+
this._url = '';
|
438
|
+
this._id = frameId;
|
439
|
+
this._detached = false;
|
440
|
+
this._loaderId = '';
|
441
|
+
this._childFrames = new Set();
|
442
|
+
if (this._parentFrame)
|
443
|
+
this._parentFrame._childFrames.add(this);
|
444
|
+
this._updateClient(client);
|
445
|
+
}
|
446
|
+
/**
|
447
|
+
* @internal
|
448
|
+
*/
|
449
|
+
_updateClient(client) {
|
450
|
+
this._client = client;
|
451
|
+
this._mainWorld = new DOMWorld(this._client, this._frameManager, this, this._frameManager._timeoutSettings);
|
452
|
+
this._secondaryWorld = new DOMWorld(this._client, this._frameManager, this, this._frameManager._timeoutSettings);
|
453
|
+
}
|
454
|
+
isOOPFrame() {
|
455
|
+
return this._client !== this._frameManager._client;
|
456
|
+
}
|
457
|
+
/**
|
458
|
+
* @remarks
|
459
|
+
*
|
460
|
+
* `frame.goto` will throw an error if:
|
461
|
+
* - there's an SSL error (e.g. in case of self-signed certificates).
|
462
|
+
*
|
463
|
+
* - target URL is invalid.
|
464
|
+
*
|
465
|
+
* - the `timeout` is exceeded during navigation.
|
466
|
+
*
|
467
|
+
* - the remote server does not respond or is unreachable.
|
468
|
+
*
|
469
|
+
* - the main resource failed to load.
|
470
|
+
*
|
471
|
+
* `frame.goto` will not throw an error when any valid HTTP status code is
|
472
|
+
* returned by the remote server, including 404 "Not Found" and 500 "Internal
|
473
|
+
* Server Error". The status code for such responses can be retrieved by
|
474
|
+
* calling {@link HTTPResponse.status}.
|
475
|
+
*
|
476
|
+
* NOTE: `frame.goto` either throws an error or returns a main resource
|
477
|
+
* response. The only exceptions are navigation to `about:blank` or
|
478
|
+
* navigation to the same URL with a different hash, which would succeed and
|
479
|
+
* return `null`.
|
480
|
+
*
|
481
|
+
* NOTE: Headless mode doesn't support navigation to a PDF document. See
|
482
|
+
* the {@link https://bugs.chromium.org/p/chromium/issues/detail?id=761295 | upstream
|
483
|
+
* issue}.
|
484
|
+
*
|
485
|
+
* @param url - the URL to navigate the frame to. This should include the
|
486
|
+
* scheme, e.g. `https://`.
|
487
|
+
* @param options - navigation options. `waitUntil` is useful to define when
|
488
|
+
* the navigation should be considered successful - see the docs for
|
489
|
+
* {@link PuppeteerLifeCycleEvent} for more details.
|
490
|
+
*
|
491
|
+
* @returns A promise which resolves to the main resource response. In case of
|
492
|
+
* multiple redirects, the navigation will resolve with the response of the
|
493
|
+
* last redirect.
|
494
|
+
*/
|
495
|
+
async goto(url, options = {}) {
|
496
|
+
return await this._frameManager.navigateFrame(this, url, options);
|
497
|
+
}
|
498
|
+
/**
|
499
|
+
* @remarks
|
500
|
+
*
|
501
|
+
* This resolves when the frame navigates to a new URL. It is useful for when
|
502
|
+
* you run code which will indirectly cause the frame to navigate. Consider
|
503
|
+
* this example:
|
504
|
+
*
|
505
|
+
* ```js
|
506
|
+
* const [response] = await Promise.all([
|
507
|
+
* // The navigation promise resolves after navigation has finished
|
508
|
+
* frame.waitForNavigation(),
|
509
|
+
* // Clicking the link will indirectly cause a navigation
|
510
|
+
* frame.click('a.my-link'),
|
511
|
+
* ]);
|
512
|
+
* ```
|
513
|
+
*
|
514
|
+
* Usage of the {@link https://developer.mozilla.org/en-US/docs/Web/API/History_API | History API} to change the URL is considered a navigation.
|
515
|
+
*
|
516
|
+
* @param options - options to configure when the navigation is consided finished.
|
517
|
+
* @returns a promise that resolves when the frame navigates to a new URL.
|
518
|
+
*/
|
519
|
+
async waitForNavigation(options = {}) {
|
520
|
+
return await this._frameManager.waitForFrameNavigation(this, options);
|
521
|
+
}
|
522
|
+
/**
|
523
|
+
* @returns a promise that resolves to the frame's default execution context.
|
524
|
+
*/
|
525
|
+
executionContext() {
|
526
|
+
return this._mainWorld.executionContext();
|
527
|
+
}
|
528
|
+
/**
|
529
|
+
* @remarks
|
530
|
+
*
|
531
|
+
* The only difference between {@link Frame.evaluate} and
|
532
|
+
* `frame.evaluateHandle` is that `evaluateHandle` will return the value
|
533
|
+
* wrapped in an in-page object.
|
534
|
+
*
|
535
|
+
* This method behaves identically to {@link Page.evaluateHandle} except it's
|
536
|
+
* run within the context of the `frame`, rather than the entire page.
|
537
|
+
*
|
538
|
+
* @param pageFunction - a function that is run within the frame
|
539
|
+
* @param args - arguments to be passed to the pageFunction
|
540
|
+
*/
|
541
|
+
async evaluateHandle(pageFunction, ...args) {
|
542
|
+
return this._mainWorld.evaluateHandle(pageFunction, ...args);
|
543
|
+
}
|
544
|
+
/**
|
545
|
+
* @remarks
|
546
|
+
*
|
547
|
+
* This method behaves identically to {@link Page.evaluate} except it's run
|
548
|
+
* within the context of the `frame`, rather than the entire page.
|
549
|
+
*
|
550
|
+
* @param pageFunction - a function that is run within the frame
|
551
|
+
* @param args - arguments to be passed to the pageFunction
|
552
|
+
*/
|
553
|
+
async evaluate(pageFunction, ...args) {
|
554
|
+
return this._mainWorld.evaluate(pageFunction, ...args);
|
555
|
+
}
|
556
|
+
/**
|
557
|
+
* This method queries the frame for the given selector.
|
558
|
+
*
|
559
|
+
* @param selector - a selector to query for.
|
560
|
+
* @returns A promise which resolves to an `ElementHandle` pointing at the
|
561
|
+
* element, or `null` if it was not found.
|
562
|
+
*/
|
563
|
+
async $(selector) {
|
564
|
+
return this._mainWorld.$(selector);
|
565
|
+
}
|
566
|
+
/**
|
567
|
+
* This method evaluates the given XPath expression and returns the results.
|
568
|
+
*
|
569
|
+
* @param expression - the XPath expression to evaluate.
|
570
|
+
*/
|
571
|
+
async $x(expression) {
|
572
|
+
return this._mainWorld.$x(expression);
|
573
|
+
}
|
574
|
+
/**
|
575
|
+
* @remarks
|
576
|
+
*
|
577
|
+
* This method runs `document.querySelector` within
|
578
|
+
* the frame and passes it as the first argument to `pageFunction`.
|
579
|
+
*
|
580
|
+
* If `pageFunction` returns a Promise, then `frame.$eval` would wait for
|
581
|
+
* the promise to resolve and return its value.
|
582
|
+
*
|
583
|
+
* @example
|
584
|
+
*
|
585
|
+
* ```js
|
586
|
+
* const searchValue = await frame.$eval('#search', el => el.value);
|
587
|
+
* ```
|
588
|
+
*
|
589
|
+
* @param selector - the selector to query for
|
590
|
+
* @param pageFunction - the function to be evaluated in the frame's context
|
591
|
+
* @param args - additional arguments to pass to `pageFuncton`
|
592
|
+
*/
|
593
|
+
async $eval(selector, pageFunction, ...args) {
|
594
|
+
return this._mainWorld.$eval(selector, pageFunction, ...args);
|
595
|
+
}
|
596
|
+
/**
|
597
|
+
* @remarks
|
598
|
+
*
|
599
|
+
* This method runs `Array.from(document.querySelectorAll(selector))` within
|
600
|
+
* the frame and passes it as the first argument to `pageFunction`.
|
601
|
+
*
|
602
|
+
* If `pageFunction` returns a Promise, then `frame.$$eval` would wait for
|
603
|
+
* the promise to resolve and return its value.
|
604
|
+
*
|
605
|
+
* @example
|
606
|
+
*
|
607
|
+
* ```js
|
608
|
+
* const divsCounts = await frame.$$eval('div', divs => divs.length);
|
609
|
+
* ```
|
610
|
+
*
|
611
|
+
* @param selector - the selector to query for
|
612
|
+
* @param pageFunction - the function to be evaluated in the frame's context
|
613
|
+
* @param args - additional arguments to pass to `pageFuncton`
|
614
|
+
*/
|
615
|
+
async $$eval(selector, pageFunction, ...args) {
|
616
|
+
return this._mainWorld.$$eval(selector, pageFunction, ...args);
|
617
|
+
}
|
618
|
+
/**
|
619
|
+
* This runs `document.querySelectorAll` in the frame and returns the result.
|
620
|
+
*
|
621
|
+
* @param selector - a selector to search for
|
622
|
+
* @returns An array of element handles pointing to the found frame elements.
|
623
|
+
*/
|
624
|
+
async $$(selector) {
|
625
|
+
return this._mainWorld.$$(selector);
|
626
|
+
}
|
627
|
+
/**
|
628
|
+
* @returns the full HTML contents of the frame, including the doctype.
|
629
|
+
*/
|
630
|
+
async content() {
|
631
|
+
return this._secondaryWorld.content();
|
632
|
+
}
|
633
|
+
/**
|
634
|
+
* Set the content of the frame.
|
635
|
+
*
|
636
|
+
* @param html - HTML markup to assign to the page.
|
637
|
+
* @param options - options to configure how long before timing out and at
|
638
|
+
* what point to consider the content setting successful.
|
639
|
+
*/
|
640
|
+
async setContent(html, options = {}) {
|
641
|
+
return this._secondaryWorld.setContent(html, options);
|
642
|
+
}
|
643
|
+
/**
|
644
|
+
* @remarks
|
645
|
+
*
|
646
|
+
* If the name is empty, it returns the `id` attribute instead.
|
647
|
+
*
|
648
|
+
* Note: This value is calculated once when the frame is created, and will not
|
649
|
+
* update if the attribute is changed later.
|
650
|
+
*
|
651
|
+
* @returns the frame's `name` attribute as specified in the tag.
|
652
|
+
*/
|
653
|
+
name() {
|
654
|
+
return this._name || '';
|
655
|
+
}
|
656
|
+
/**
|
657
|
+
* @returns the frame's URL.
|
658
|
+
*/
|
659
|
+
url() {
|
660
|
+
return this._url;
|
661
|
+
}
|
662
|
+
/**
|
663
|
+
* @returns the parent `Frame`, if any. Detached and main frames return `null`.
|
664
|
+
*/
|
665
|
+
parentFrame() {
|
666
|
+
return this._parentFrame;
|
667
|
+
}
|
668
|
+
/**
|
669
|
+
* @returns an array of child frames.
|
670
|
+
*/
|
671
|
+
childFrames() {
|
672
|
+
return Array.from(this._childFrames);
|
673
|
+
}
|
674
|
+
/**
|
675
|
+
* @returns `true` if the frame has been detached, or `false` otherwise.
|
676
|
+
*/
|
677
|
+
isDetached() {
|
678
|
+
return this._detached;
|
679
|
+
}
|
680
|
+
/**
|
681
|
+
* Adds a `<script>` tag into the page with the desired url or content.
|
682
|
+
*
|
683
|
+
* @param options - configure the script to add to the page.
|
684
|
+
*
|
685
|
+
* @returns a promise that resolves to the added tag when the script's
|
686
|
+
* `onload` event fires or when the script content was injected into the
|
687
|
+
* frame.
|
688
|
+
*/
|
689
|
+
async addScriptTag(options) {
|
690
|
+
return this._mainWorld.addScriptTag(options);
|
691
|
+
}
|
692
|
+
/**
|
693
|
+
* Adds a `<link rel="stylesheet">` tag into the page with the desired url or
|
694
|
+
* a `<style type="text/css">` tag with the content.
|
695
|
+
*
|
696
|
+
* @param options - configure the CSS to add to the page.
|
697
|
+
*
|
698
|
+
* @returns a promise that resolves to the added tag when the stylesheets's
|
699
|
+
* `onload` event fires or when the CSS content was injected into the
|
700
|
+
* frame.
|
701
|
+
*/
|
702
|
+
async addStyleTag(options) {
|
703
|
+
return this._mainWorld.addStyleTag(options);
|
704
|
+
}
|
705
|
+
/**
|
706
|
+
*
|
707
|
+
* This method clicks the first element found that matches `selector`.
|
708
|
+
*
|
709
|
+
* @remarks
|
710
|
+
*
|
711
|
+
* This method scrolls the element into view if needed, and then uses
|
712
|
+
* {@link Page.mouse} to click in the center of the element. If there's no
|
713
|
+
* element matching `selector`, the method throws an error.
|
714
|
+
*
|
715
|
+
* Bear in mind that if `click()` triggers a navigation event and there's a
|
716
|
+
* separate `page.waitForNavigation()` promise to be resolved, you may end up
|
717
|
+
* with a race condition that yields unexpected results. The correct pattern
|
718
|
+
* for click and wait for navigation is the following:
|
719
|
+
*
|
720
|
+
* ```javascript
|
721
|
+
* const [response] = await Promise.all([
|
722
|
+
* page.waitForNavigation(waitOptions),
|
723
|
+
* frame.click(selector, clickOptions),
|
724
|
+
* ]);
|
725
|
+
* ```
|
726
|
+
* @param selector - the selector to search for to click. If there are
|
727
|
+
* multiple elements, the first will be clicked.
|
728
|
+
*/
|
729
|
+
async click(selector, options = {}) {
|
730
|
+
return this._secondaryWorld.click(selector, options);
|
731
|
+
}
|
732
|
+
/**
|
733
|
+
* This method fetches an element with `selector` and focuses it.
|
734
|
+
*
|
735
|
+
* @remarks
|
736
|
+
* If there's no element matching `selector`, the method throws an error.
|
737
|
+
*
|
738
|
+
* @param selector - the selector for the element to focus. If there are
|
739
|
+
* multiple elements, the first will be focused.
|
740
|
+
*/
|
741
|
+
async focus(selector) {
|
742
|
+
return this._secondaryWorld.focus(selector);
|
743
|
+
}
|
744
|
+
/**
|
745
|
+
* This method fetches an element with `selector`, scrolls it into view if
|
746
|
+
* needed, and then uses {@link Page.mouse} to hover over the center of the
|
747
|
+
* element.
|
748
|
+
*
|
749
|
+
* @remarks
|
750
|
+
* If there's no element matching `selector`, the method throws an
|
751
|
+
*
|
752
|
+
* @param selector - the selector for the element to hover. If there are
|
753
|
+
* multiple elements, the first will be hovered.
|
754
|
+
*/
|
755
|
+
async hover(selector) {
|
756
|
+
return this._secondaryWorld.hover(selector);
|
757
|
+
}
|
758
|
+
/**
|
759
|
+
* Triggers a `change` and `input` event once all the provided options have
|
760
|
+
* been selected.
|
761
|
+
*
|
762
|
+
* @remarks
|
763
|
+
*
|
764
|
+
* If there's no `<select>` element matching `selector`, the
|
765
|
+
* method throws an error.
|
766
|
+
*
|
767
|
+
* @example
|
768
|
+
* ```js
|
769
|
+
* frame.select('select#colors', 'blue'); // single selection
|
770
|
+
* frame.select('select#colors', 'red', 'green', 'blue'); // multiple selections
|
771
|
+
* ```
|
772
|
+
*
|
773
|
+
* @param selector - a selector to query the frame for
|
774
|
+
* @param values - an array of values to select. If the `<select>` has the
|
775
|
+
* `multiple` attribute, all values are considered, otherwise only the first
|
776
|
+
* one is taken into account.
|
777
|
+
* @returns the list of values that were successfully selected.
|
778
|
+
*/
|
779
|
+
select(selector, ...values) {
|
780
|
+
return this._secondaryWorld.select(selector, ...values);
|
781
|
+
}
|
782
|
+
/**
|
783
|
+
* This method fetches an element with `selector`, scrolls it into view if
|
784
|
+
* needed, and then uses {@link Page.touchscreen} to tap in the center of the
|
785
|
+
* element.
|
786
|
+
*
|
787
|
+
* @remarks
|
788
|
+
*
|
789
|
+
* If there's no element matching `selector`, the method throws an error.
|
790
|
+
*
|
791
|
+
* @param selector - the selector to tap.
|
792
|
+
* @returns a promise that resolves when the element has been tapped.
|
793
|
+
*/
|
794
|
+
async tap(selector) {
|
795
|
+
return this._secondaryWorld.tap(selector);
|
796
|
+
}
|
797
|
+
/**
|
798
|
+
* Sends a `keydown`, `keypress`/`input`, and `keyup` event for each character
|
799
|
+
* in the text.
|
800
|
+
*
|
801
|
+
* @remarks
|
802
|
+
* To press a special key, like `Control` or `ArrowDown`, use
|
803
|
+
* {@link Keyboard.press}.
|
804
|
+
*
|
805
|
+
* @example
|
806
|
+
* ```js
|
807
|
+
* await frame.type('#mytextarea', 'Hello'); // Types instantly
|
808
|
+
* await frame.type('#mytextarea', 'World', {delay: 100}); // Types slower, like a user
|
809
|
+
* ```
|
810
|
+
*
|
811
|
+
* @param selector - the selector for the element to type into. If there are
|
812
|
+
* multiple the first will be used.
|
813
|
+
* @param text - text to type into the element
|
814
|
+
* @param options - takes one option, `delay`, which sets the time to wait
|
815
|
+
* between key presses in milliseconds. Defaults to `0`.
|
816
|
+
*
|
817
|
+
* @returns a promise that resolves when the typing is complete.
|
818
|
+
*/
|
819
|
+
async type(selector, text, options) {
|
820
|
+
return this._mainWorld.type(selector, text, options);
|
821
|
+
}
|
822
|
+
/**
|
823
|
+
* @remarks
|
824
|
+
*
|
825
|
+
* This method behaves differently depending on the first parameter. If it's a
|
826
|
+
* `string`, it will be treated as a `selector` or `xpath` (if the string
|
827
|
+
* starts with `//`). This method then is a shortcut for
|
828
|
+
* {@link Frame.waitForSelector} or {@link Frame.waitForXPath}.
|
829
|
+
*
|
830
|
+
* If the first argument is a function this method is a shortcut for
|
831
|
+
* {@link Frame.waitForFunction}.
|
832
|
+
*
|
833
|
+
* If the first argument is a `number`, it's treated as a timeout in
|
834
|
+
* milliseconds and the method returns a promise which resolves after the
|
835
|
+
* timeout.
|
836
|
+
*
|
837
|
+
* @param selectorOrFunctionOrTimeout - a selector, predicate or timeout to
|
838
|
+
* wait for.
|
839
|
+
* @param options - optional waiting parameters.
|
840
|
+
* @param args - arguments to pass to `pageFunction`.
|
841
|
+
*
|
842
|
+
* @deprecated Don't use this method directly. Instead use the more explicit
|
843
|
+
* methods available: {@link Frame.waitForSelector},
|
844
|
+
* {@link Frame.waitForXPath}, {@link Frame.waitForFunction} or
|
845
|
+
* {@link Frame.waitForTimeout}.
|
846
|
+
*/
|
847
|
+
waitFor(selectorOrFunctionOrTimeout, options = {}, ...args) {
|
848
|
+
console.warn('waitFor is deprecated and will be removed in a future release. See https://github.com/puppeteer/puppeteer/issues/6214 for details and how to migrate your code.');
|
849
|
+
if (helper.isString(selectorOrFunctionOrTimeout)) {
|
850
|
+
const string = selectorOrFunctionOrTimeout;
|
851
|
+
if (xPathPattern.test(string))
|
852
|
+
return this.waitForXPath(string, options);
|
853
|
+
return this.waitForSelector(string, options);
|
854
|
+
}
|
855
|
+
if (helper.isNumber(selectorOrFunctionOrTimeout))
|
856
|
+
return new Promise((fulfill) => setTimeout(fulfill, selectorOrFunctionOrTimeout));
|
857
|
+
if (typeof selectorOrFunctionOrTimeout === 'function')
|
858
|
+
return this.waitForFunction(selectorOrFunctionOrTimeout, options, ...args);
|
859
|
+
return Promise.reject(new Error('Unsupported target type: ' + typeof selectorOrFunctionOrTimeout));
|
860
|
+
}
|
861
|
+
/**
|
862
|
+
* Causes your script to wait for the given number of milliseconds.
|
863
|
+
*
|
864
|
+
* @remarks
|
865
|
+
* It's generally recommended to not wait for a number of seconds, but instead
|
866
|
+
* use {@link Frame.waitForSelector}, {@link Frame.waitForXPath} or
|
867
|
+
* {@link Frame.waitForFunction} to wait for exactly the conditions you want.
|
868
|
+
*
|
869
|
+
* @example
|
870
|
+
*
|
871
|
+
* Wait for 1 second:
|
872
|
+
*
|
873
|
+
* ```
|
874
|
+
* await frame.waitForTimeout(1000);
|
875
|
+
* ```
|
876
|
+
*
|
877
|
+
* @param milliseconds - the number of milliseconds to wait.
|
878
|
+
*/
|
879
|
+
waitForTimeout(milliseconds) {
|
880
|
+
return new Promise((resolve) => {
|
881
|
+
setTimeout(resolve, milliseconds);
|
882
|
+
});
|
883
|
+
}
|
884
|
+
/**
|
885
|
+
* @remarks
|
886
|
+
*
|
887
|
+
*
|
888
|
+
* Wait for the `selector` to appear in page. If at the moment of calling the
|
889
|
+
* method the `selector` already exists, the method will return immediately.
|
890
|
+
* If the selector doesn't appear after the `timeout` milliseconds of waiting,
|
891
|
+
* the function will throw.
|
892
|
+
*
|
893
|
+
* This method works across navigations.
|
894
|
+
*
|
895
|
+
* @example
|
896
|
+
* ```js
|
897
|
+
* const puppeteer = require('puppeteer');
|
898
|
+
*
|
899
|
+
* (async () => {
|
900
|
+
* const browser = await puppeteer.launch();
|
901
|
+
* const page = await browser.newPage();
|
902
|
+
* let currentURL;
|
903
|
+
* page.mainFrame()
|
904
|
+
* .waitForSelector('img')
|
905
|
+
* .then(() => console.log('First URL with image: ' + currentURL));
|
906
|
+
*
|
907
|
+
* for (currentURL of ['https://example.com', 'https://google.com', 'https://bbc.com']) {
|
908
|
+
* await page.goto(currentURL);
|
909
|
+
* }
|
910
|
+
* await browser.close();
|
911
|
+
* })();
|
912
|
+
* ```
|
913
|
+
* @param selector - the selector to wait for.
|
914
|
+
* @param options - options to define if the element should be visible and how
|
915
|
+
* long to wait before timing out.
|
916
|
+
* @returns a promise which resolves when an element matching the selector
|
917
|
+
* string is added to the DOM.
|
918
|
+
*/
|
919
|
+
async waitForSelector(selector, options = {}) {
|
920
|
+
const handle = await this._secondaryWorld.waitForSelector(selector, options);
|
921
|
+
if (!handle)
|
922
|
+
return null;
|
923
|
+
const mainExecutionContext = await this._mainWorld.executionContext();
|
924
|
+
const result = await mainExecutionContext._adoptElementHandle(handle);
|
925
|
+
await handle.dispose();
|
926
|
+
return result;
|
927
|
+
}
|
928
|
+
/**
|
929
|
+
* @remarks
|
930
|
+
* Wait for the `xpath` to appear in page. If at the moment of calling the
|
931
|
+
* method the `xpath` already exists, the method will return immediately. If
|
932
|
+
* the xpath doesn't appear after the `timeout` milliseconds of waiting, the
|
933
|
+
* function will throw.
|
934
|
+
*
|
935
|
+
* For a code example, see the example for {@link Frame.waitForSelector}. That
|
936
|
+
* function behaves identically other than taking a CSS selector rather than
|
937
|
+
* an XPath.
|
938
|
+
*
|
939
|
+
* @param xpath - the XPath expression to wait for.
|
940
|
+
* @param options - options to configure the visiblity of the element and how
|
941
|
+
* long to wait before timing out.
|
942
|
+
*/
|
943
|
+
async waitForXPath(xpath, options = {}) {
|
944
|
+
const handle = await this._secondaryWorld.waitForXPath(xpath, options);
|
945
|
+
if (!handle)
|
946
|
+
return null;
|
947
|
+
const mainExecutionContext = await this._mainWorld.executionContext();
|
948
|
+
const result = await mainExecutionContext._adoptElementHandle(handle);
|
949
|
+
await handle.dispose();
|
950
|
+
return result;
|
951
|
+
}
|
952
|
+
/**
|
953
|
+
* @remarks
|
954
|
+
*
|
955
|
+
* @example
|
956
|
+
*
|
957
|
+
* The `waitForFunction` can be used to observe viewport size change:
|
958
|
+
* ```js
|
959
|
+
* const puppeteer = require('puppeteer');
|
960
|
+
*
|
961
|
+
* (async () => {
|
962
|
+
* . const browser = await puppeteer.launch();
|
963
|
+
* . const page = await browser.newPage();
|
964
|
+
* . const watchDog = page.mainFrame().waitForFunction('window.innerWidth < 100');
|
965
|
+
* . page.setViewport({width: 50, height: 50});
|
966
|
+
* . await watchDog;
|
967
|
+
* . await browser.close();
|
968
|
+
* })();
|
969
|
+
* ```
|
970
|
+
*
|
971
|
+
* To pass arguments from Node.js to the predicate of `page.waitForFunction` function:
|
972
|
+
*
|
973
|
+
* ```js
|
974
|
+
* const selector = '.foo';
|
975
|
+
* await frame.waitForFunction(
|
976
|
+
* selector => !!document.querySelector(selector),
|
977
|
+
* {}, // empty options object
|
978
|
+
* selector
|
979
|
+
*);
|
980
|
+
* ```
|
981
|
+
*
|
982
|
+
* @param pageFunction - the function to evaluate in the frame context.
|
983
|
+
* @param options - options to configure the polling method and timeout.
|
984
|
+
* @param args - arguments to pass to the `pageFunction`.
|
985
|
+
* @returns the promise which resolve when the `pageFunction` returns a truthy value.
|
986
|
+
*/
|
987
|
+
waitForFunction(pageFunction, options = {}, ...args) {
|
988
|
+
return this._mainWorld.waitForFunction(pageFunction, options, ...args);
|
989
|
+
}
|
990
|
+
/**
|
991
|
+
* @returns the frame's title.
|
992
|
+
*/
|
993
|
+
async title() {
|
994
|
+
return this._secondaryWorld.title();
|
995
|
+
}
|
996
|
+
/**
|
997
|
+
* @internal
|
998
|
+
*/
|
999
|
+
_navigated(framePayload) {
|
1000
|
+
this._name = framePayload.name;
|
1001
|
+
this._url = `${framePayload.url}${framePayload.urlFragment || ''}`;
|
1002
|
+
}
|
1003
|
+
/**
|
1004
|
+
* @internal
|
1005
|
+
*/
|
1006
|
+
_navigatedWithinDocument(url) {
|
1007
|
+
this._url = url;
|
1008
|
+
}
|
1009
|
+
/**
|
1010
|
+
* @internal
|
1011
|
+
*/
|
1012
|
+
_onLifecycleEvent(loaderId, name) {
|
1013
|
+
if (name === 'init') {
|
1014
|
+
this._loaderId = loaderId;
|
1015
|
+
this._lifecycleEvents.clear();
|
1016
|
+
}
|
1017
|
+
this._lifecycleEvents.add(name);
|
1018
|
+
}
|
1019
|
+
/**
|
1020
|
+
* @internal
|
1021
|
+
*/
|
1022
|
+
_onLoadingStopped() {
|
1023
|
+
this._lifecycleEvents.add('DOMContentLoaded');
|
1024
|
+
this._lifecycleEvents.add('load');
|
1025
|
+
}
|
1026
|
+
/**
|
1027
|
+
* @internal
|
1028
|
+
*/
|
1029
|
+
_detach() {
|
1030
|
+
this._detached = true;
|
1031
|
+
this._mainWorld._detach();
|
1032
|
+
this._secondaryWorld._detach();
|
1033
|
+
if (this._parentFrame)
|
1034
|
+
this._parentFrame._childFrames.delete(this);
|
1035
|
+
this._parentFrame = null;
|
1036
|
+
}
|
1037
|
+
}
|
1038
|
+
function assertNoLegacyNavigationOptions(options) {
|
1039
|
+
assert(options['networkIdleTimeout'] === undefined, 'ERROR: networkIdleTimeout option is no longer supported.');
|
1040
|
+
assert(options['networkIdleInflight'] === undefined, 'ERROR: networkIdleInflight option is no longer supported.');
|
1041
|
+
assert(options.waitUntil !== 'networkidle', 'ERROR: "networkidle" option is no longer supported. Use "networkidle2" instead');
|
1042
|
+
}
|
1043
1043
|
//# sourceMappingURL=FrameManager.js.map
|