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,504 +1,504 @@
|
|
1
|
-
/**
|
2
|
-
* The `vm` module enables compiling and running code within V8 Virtual
|
3
|
-
* Machine contexts. **The `vm` module is not a security mechanism. Do**
|
4
|
-
* **not use it to run untrusted code.**
|
5
|
-
*
|
6
|
-
* JavaScript code can be compiled and run immediately or
|
7
|
-
* compiled, saved, and run later.
|
8
|
-
*
|
9
|
-
* A common use case is to run the code in a different V8 Context. This means
|
10
|
-
* invoked code has a different global object than the invoking code.
|
11
|
-
*
|
12
|
-
* One can provide the context by `contextifying` an
|
13
|
-
* object. The invoked code treats any property in the context like a
|
14
|
-
* global variable. Any changes to global variables caused by the invoked
|
15
|
-
* code are reflected in the context object.
|
16
|
-
*
|
17
|
-
* ```js
|
18
|
-
* const vm = require('vm');
|
19
|
-
*
|
20
|
-
* const x = 1;
|
21
|
-
*
|
22
|
-
* const context = { x: 2 };
|
23
|
-
* vm.createContext(context); // Contextify the object.
|
24
|
-
*
|
25
|
-
* const code = 'x += 40; var y = 17;';
|
26
|
-
* // `x` and `y` are global variables in the context.
|
27
|
-
* // Initially, x has the value 2 because that is the value of context.x.
|
28
|
-
* vm.runInContext(code, context);
|
29
|
-
*
|
30
|
-
* console.log(context.x); // 42
|
31
|
-
* console.log(context.y); // 17
|
32
|
-
*
|
33
|
-
* console.log(x); // 1; y is not defined.
|
34
|
-
* ```
|
35
|
-
* @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/vm.js)
|
36
|
-
*/
|
37
|
-
declare module 'vm' {
|
38
|
-
interface Context extends NodeJS.Dict<any> {}
|
39
|
-
interface BaseOptions {
|
40
|
-
/**
|
41
|
-
* Specifies the filename used in stack traces produced by this script.
|
42
|
-
* Default: `''`.
|
43
|
-
*/
|
44
|
-
filename?: string | undefined;
|
45
|
-
/**
|
46
|
-
* Specifies the line number offset that is displayed in stack traces produced by this script.
|
47
|
-
* Default: `0`.
|
48
|
-
*/
|
49
|
-
lineOffset?: number | undefined;
|
50
|
-
/**
|
51
|
-
* Specifies the column number offset that is displayed in stack traces produced by this script.
|
52
|
-
* @default 0
|
53
|
-
*/
|
54
|
-
columnOffset?: number | undefined;
|
55
|
-
}
|
56
|
-
interface ScriptOptions extends BaseOptions {
|
57
|
-
displayErrors?: boolean | undefined;
|
58
|
-
timeout?: number | undefined;
|
59
|
-
cachedData?: Buffer | undefined;
|
60
|
-
/** @deprecated in favor of `script.createCachedData()` */
|
61
|
-
produceCachedData?: boolean | undefined;
|
62
|
-
}
|
63
|
-
interface RunningScriptOptions extends BaseOptions {
|
64
|
-
/**
|
65
|
-
* When `true`, if an `Error` occurs while compiling the `code`, the line of code causing the error is attached to the stack trace.
|
66
|
-
* Default: `true`.
|
67
|
-
*/
|
68
|
-
displayErrors?: boolean | undefined;
|
69
|
-
/**
|
70
|
-
* Specifies the number of milliseconds to execute code before terminating execution.
|
71
|
-
* If execution is terminated, an `Error` will be thrown. This value must be a strictly positive integer.
|
72
|
-
*/
|
73
|
-
timeout?: number | undefined;
|
74
|
-
/**
|
75
|
-
* If `true`, the execution will be terminated when `SIGINT` (Ctrl+C) is received.
|
76
|
-
* Existing handlers for the event that have been attached via `process.on('SIGINT')` will be disabled during script execution, but will continue to work after that.
|
77
|
-
* If execution is terminated, an `Error` will be thrown.
|
78
|
-
* Default: `false`.
|
79
|
-
*/
|
80
|
-
breakOnSigint?: boolean | undefined;
|
81
|
-
/**
|
82
|
-
* If set to `afterEvaluate`, microtasks will be run immediately after the script has run.
|
83
|
-
*/
|
84
|
-
microtaskMode?: 'afterEvaluate' | undefined;
|
85
|
-
}
|
86
|
-
interface CompileFunctionOptions extends BaseOptions {
|
87
|
-
/**
|
88
|
-
* Provides an optional data with V8's code cache data for the supplied source.
|
89
|
-
*/
|
90
|
-
cachedData?: Buffer | undefined;
|
91
|
-
/**
|
92
|
-
* Specifies whether to produce new cache data.
|
93
|
-
* Default: `false`,
|
94
|
-
*/
|
95
|
-
produceCachedData?: boolean | undefined;
|
96
|
-
/**
|
97
|
-
* The sandbox/context in which the said function should be compiled in.
|
98
|
-
*/
|
99
|
-
parsingContext?: Context | undefined;
|
100
|
-
/**
|
101
|
-
* An array containing a collection of context extensions (objects wrapping the current scope) to be applied while compiling
|
102
|
-
*/
|
103
|
-
contextExtensions?: Object[] | undefined;
|
104
|
-
}
|
105
|
-
interface CreateContextOptions {
|
106
|
-
/**
|
107
|
-
* Human-readable name of the newly created context.
|
108
|
-
* @default 'VM Context i' Where i is an ascending numerical index of the created context.
|
109
|
-
*/
|
110
|
-
name?: string | undefined;
|
111
|
-
/**
|
112
|
-
* Corresponds to the newly created context for display purposes.
|
113
|
-
* The origin should be formatted like a `URL`, but with only the scheme, host, and port (if necessary),
|
114
|
-
* like the value of the `url.origin` property of a URL object.
|
115
|
-
* Most notably, this string should omit the trailing slash, as that denotes a path.
|
116
|
-
* @default ''
|
117
|
-
*/
|
118
|
-
origin?: string | undefined;
|
119
|
-
codeGeneration?:
|
120
|
-
| {
|
121
|
-
/**
|
122
|
-
* If set to false any calls to eval or function constructors (Function, GeneratorFunction, etc)
|
123
|
-
* will throw an EvalError.
|
124
|
-
* @default true
|
125
|
-
*/
|
126
|
-
strings?: boolean | undefined;
|
127
|
-
/**
|
128
|
-
* If set to false any attempt to compile a WebAssembly module will throw a WebAssembly.CompileError.
|
129
|
-
* @default true
|
130
|
-
*/
|
131
|
-
wasm?: boolean | undefined;
|
132
|
-
}
|
133
|
-
| undefined;
|
134
|
-
/**
|
135
|
-
* If set to `afterEvaluate`, microtasks will be run immediately after the script has run.
|
136
|
-
*/
|
137
|
-
microtaskMode?: 'afterEvaluate' | undefined;
|
138
|
-
}
|
139
|
-
type MeasureMemoryMode = 'summary' | 'detailed';
|
140
|
-
interface MeasureMemoryOptions {
|
141
|
-
/**
|
142
|
-
* @default 'summary'
|
143
|
-
*/
|
144
|
-
mode?: MeasureMemoryMode | undefined;
|
145
|
-
context?: Context | undefined;
|
146
|
-
}
|
147
|
-
interface MemoryMeasurement {
|
148
|
-
total: {
|
149
|
-
jsMemoryEstimate: number;
|
150
|
-
jsMemoryRange: [number, number];
|
151
|
-
};
|
152
|
-
}
|
153
|
-
/**
|
154
|
-
* Instances of the `vm.Script` class contain precompiled scripts that can be
|
155
|
-
* executed in specific contexts.
|
156
|
-
* @since v0.3.1
|
157
|
-
*/
|
158
|
-
class Script {
|
159
|
-
constructor(code: string, options?: ScriptOptions);
|
160
|
-
/**
|
161
|
-
* Runs the compiled code contained by the `vm.Script` object within the given`contextifiedObject` and returns the result. Running code does not have access
|
162
|
-
* to local scope.
|
163
|
-
*
|
164
|
-
* The following example compiles code that increments a global variable, sets
|
165
|
-
* the value of another global variable, then execute the code multiple times.
|
166
|
-
* The globals are contained in the `context` object.
|
167
|
-
*
|
168
|
-
* ```js
|
169
|
-
* const vm = require('vm');
|
170
|
-
*
|
171
|
-
* const context = {
|
172
|
-
* animal: 'cat',
|
173
|
-
* count: 2
|
174
|
-
* };
|
175
|
-
*
|
176
|
-
* const script = new vm.Script('count += 1; name = "kitty";');
|
177
|
-
*
|
178
|
-
* vm.createContext(context);
|
179
|
-
* for (let i = 0; i < 10; ++i) {
|
180
|
-
* script.runInContext(context);
|
181
|
-
* }
|
182
|
-
*
|
183
|
-
* console.log(context);
|
184
|
-
* // Prints: { animal: 'cat', count: 12, name: 'kitty' }
|
185
|
-
* ```
|
186
|
-
*
|
187
|
-
* Using the `timeout` or `breakOnSigint` options will result in new event loops
|
188
|
-
* and corresponding threads being started, which have a non-zero performance
|
189
|
-
* overhead.
|
190
|
-
* @since v0.3.1
|
191
|
-
* @param contextifiedObject A `contextified` object as returned by the `vm.createContext()` method.
|
192
|
-
* @return the result of the very last statement executed in the script.
|
193
|
-
*/
|
194
|
-
runInContext(contextifiedObject: Context, options?: RunningScriptOptions): any;
|
195
|
-
/**
|
196
|
-
* First contextifies the given `contextObject`, runs the compiled code contained
|
197
|
-
* by the `vm.Script` object within the created context, and returns the result.
|
198
|
-
* Running code does not have access to local scope.
|
199
|
-
*
|
200
|
-
* The following example compiles code that sets a global variable, then executes
|
201
|
-
* the code multiple times in different contexts. The globals are set on and
|
202
|
-
* contained within each individual `context`.
|
203
|
-
*
|
204
|
-
* ```js
|
205
|
-
* const vm = require('vm');
|
206
|
-
*
|
207
|
-
* const script = new vm.Script('globalVar = "set"');
|
208
|
-
*
|
209
|
-
* const contexts = [{}, {}, {}];
|
210
|
-
* contexts.forEach((context) => {
|
211
|
-
* script.runInNewContext(context);
|
212
|
-
* });
|
213
|
-
*
|
214
|
-
* console.log(contexts);
|
215
|
-
* // Prints: [{ globalVar: 'set' }, { globalVar: 'set' }, { globalVar: 'set' }]
|
216
|
-
* ```
|
217
|
-
* @since v0.3.1
|
218
|
-
* @param contextObject An object that will be `contextified`. If `undefined`, a new object will be created.
|
219
|
-
* @return the result of the very last statement executed in the script.
|
220
|
-
*/
|
221
|
-
runInNewContext(contextObject?: Context, options?: RunningScriptOptions): any;
|
222
|
-
/**
|
223
|
-
* Runs the compiled code contained by the `vm.Script` within the context of the
|
224
|
-
* current `global` object. Running code does not have access to local scope, but_does_ have access to the current `global` object.
|
225
|
-
*
|
226
|
-
* The following example compiles code that increments a `global` variable then
|
227
|
-
* executes that code multiple times:
|
228
|
-
*
|
229
|
-
* ```js
|
230
|
-
* const vm = require('vm');
|
231
|
-
*
|
232
|
-
* global.globalVar = 0;
|
233
|
-
*
|
234
|
-
* const script = new vm.Script('globalVar += 1', { filename: 'myfile.vm' });
|
235
|
-
*
|
236
|
-
* for (let i = 0; i < 1000; ++i) {
|
237
|
-
* script.runInThisContext();
|
238
|
-
* }
|
239
|
-
*
|
240
|
-
* console.log(globalVar);
|
241
|
-
*
|
242
|
-
* // 1000
|
243
|
-
* ```
|
244
|
-
* @since v0.3.1
|
245
|
-
* @return the result of the very last statement executed in the script.
|
246
|
-
*/
|
247
|
-
runInThisContext(options?: RunningScriptOptions): any;
|
248
|
-
/**
|
249
|
-
* Creates a code cache that can be used with the `Script` constructor's`cachedData` option. Returns a `Buffer`. This method may be called at any
|
250
|
-
* time and any number of times.
|
251
|
-
*
|
252
|
-
* ```js
|
253
|
-
* const script = new vm.Script(`
|
254
|
-
* function add(a, b) {
|
255
|
-
* return a + b;
|
256
|
-
* }
|
257
|
-
*
|
258
|
-
* const x = add(1, 2);
|
259
|
-
* `);
|
260
|
-
*
|
261
|
-
* const cacheWithoutX = script.createCachedData();
|
262
|
-
*
|
263
|
-
* script.runInThisContext();
|
264
|
-
*
|
265
|
-
* const cacheWithX = script.createCachedData();
|
266
|
-
* ```
|
267
|
-
* @since v10.6.0
|
268
|
-
*/
|
269
|
-
createCachedData(): Buffer;
|
270
|
-
cachedDataRejected?: boolean | undefined;
|
271
|
-
}
|
272
|
-
/**
|
273
|
-
* If given a `contextObject`, the `vm.createContext()` method will `prepare
|
274
|
-
* that object` so that it can be used in calls to {@link runInContext} or `script.runInContext()`. Inside such scripts,
|
275
|
-
* the `contextObject` will be the global object, retaining all of its existing
|
276
|
-
* properties but also having the built-in objects and functions any standard[global object](https://es5.github.io/#x15.1) has. Outside of scripts run by the vm module, global variables
|
277
|
-
* will remain unchanged.
|
278
|
-
*
|
279
|
-
* ```js
|
280
|
-
* const vm = require('vm');
|
281
|
-
*
|
282
|
-
* global.globalVar = 3;
|
283
|
-
*
|
284
|
-
* const context = { globalVar: 1 };
|
285
|
-
* vm.createContext(context);
|
286
|
-
*
|
287
|
-
* vm.runInContext('globalVar *= 2;', context);
|
288
|
-
*
|
289
|
-
* console.log(context);
|
290
|
-
* // Prints: { globalVar: 2 }
|
291
|
-
*
|
292
|
-
* console.log(global.globalVar);
|
293
|
-
* // Prints: 3
|
294
|
-
* ```
|
295
|
-
*
|
296
|
-
* If `contextObject` is omitted (or passed explicitly as `undefined`), a new,
|
297
|
-
* empty `contextified` object will be returned.
|
298
|
-
*
|
299
|
-
* The `vm.createContext()` method is primarily useful for creating a single
|
300
|
-
* context that can be used to run multiple scripts. For instance, if emulating a
|
301
|
-
* web browser, the method can be used to create a single context representing a
|
302
|
-
* window's global object, then run all `<script>` tags together within that
|
303
|
-
* context.
|
304
|
-
*
|
305
|
-
* The provided `name` and `origin` of the context are made visible through the
|
306
|
-
* Inspector API.
|
307
|
-
* @since v0.3.1
|
308
|
-
* @return contextified object.
|
309
|
-
*/
|
310
|
-
function createContext(sandbox?: Context, options?: CreateContextOptions): Context;
|
311
|
-
/**
|
312
|
-
* Returns `true` if the given `object` object has been `contextified` using {@link createContext}.
|
313
|
-
* @since v0.11.7
|
314
|
-
*/
|
315
|
-
function isContext(sandbox: Context): boolean;
|
316
|
-
/**
|
317
|
-
* The `vm.runInContext()` method compiles `code`, runs it within the context of
|
318
|
-
* the `contextifiedObject`, then returns the result. Running code does not have
|
319
|
-
* access to the local scope. The `contextifiedObject` object _must_ have been
|
320
|
-
* previously `contextified` using the {@link createContext} method.
|
321
|
-
*
|
322
|
-
* If `options` is a string, then it specifies the filename.
|
323
|
-
*
|
324
|
-
* The following example compiles and executes different scripts using a single `contextified` object:
|
325
|
-
*
|
326
|
-
* ```js
|
327
|
-
* const vm = require('vm');
|
328
|
-
*
|
329
|
-
* const contextObject = { globalVar: 1 };
|
330
|
-
* vm.createContext(contextObject);
|
331
|
-
*
|
332
|
-
* for (let i = 0; i < 10; ++i) {
|
333
|
-
* vm.runInContext('globalVar *= 2;', contextObject);
|
334
|
-
* }
|
335
|
-
* console.log(contextObject);
|
336
|
-
* // Prints: { globalVar: 1024 }
|
337
|
-
* ```
|
338
|
-
* @since v0.3.1
|
339
|
-
* @param code The JavaScript code to compile and run.
|
340
|
-
* @param contextifiedObject The `contextified` object that will be used as the `global` when the `code` is compiled and run.
|
341
|
-
* @return the result of the very last statement executed in the script.
|
342
|
-
*/
|
343
|
-
function runInContext(code: string, contextifiedObject: Context, options?: RunningScriptOptions | string): any;
|
344
|
-
/**
|
345
|
-
* The `vm.runInNewContext()` first contextifies the given `contextObject` (or
|
346
|
-
* creates a new `contextObject` if passed as `undefined`), compiles the `code`,
|
347
|
-
* runs it within the created context, then returns the result. Running code
|
348
|
-
* does not have access to the local scope.
|
349
|
-
*
|
350
|
-
* If `options` is a string, then it specifies the filename.
|
351
|
-
*
|
352
|
-
* The following example compiles and executes code that increments a global
|
353
|
-
* variable and sets a new one. These globals are contained in the `contextObject`.
|
354
|
-
*
|
355
|
-
* ```js
|
356
|
-
* const vm = require('vm');
|
357
|
-
*
|
358
|
-
* const contextObject = {
|
359
|
-
* animal: 'cat',
|
360
|
-
* count: 2
|
361
|
-
* };
|
362
|
-
*
|
363
|
-
* vm.runInNewContext('count += 1; name = "kitty"', contextObject);
|
364
|
-
* console.log(contextObject);
|
365
|
-
* // Prints: { animal: 'cat', count: 3, name: 'kitty' }
|
366
|
-
* ```
|
367
|
-
* @since v0.3.1
|
368
|
-
* @param code The JavaScript code to compile and run.
|
369
|
-
* @param contextObject An object that will be `contextified`. If `undefined`, a new object will be created.
|
370
|
-
* @return the result of the very last statement executed in the script.
|
371
|
-
*/
|
372
|
-
function runInNewContext(code: string, contextObject?: Context, options?: RunningScriptOptions | string): any;
|
373
|
-
/**
|
374
|
-
* `vm.runInThisContext()` compiles `code`, runs it within the context of the
|
375
|
-
* current `global` and returns the result. Running code does not have access to
|
376
|
-
* local scope, but does have access to the current `global` object.
|
377
|
-
*
|
378
|
-
* If `options` is a string, then it specifies the filename.
|
379
|
-
*
|
380
|
-
* The following example illustrates using both `vm.runInThisContext()` and
|
381
|
-
* the JavaScript [`eval()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/eval) function to run the same code:
|
382
|
-
*
|
383
|
-
* ```js
|
384
|
-
* const vm = require('vm');
|
385
|
-
* let localVar = 'initial value';
|
386
|
-
*
|
387
|
-
* const vmResult = vm.runInThisContext('localVar = "vm";');
|
388
|
-
* console.log(`vmResult: '${vmResult}', localVar: '${localVar}'`);
|
389
|
-
* // Prints: vmResult: 'vm', localVar: 'initial value'
|
390
|
-
*
|
391
|
-
* const evalResult = eval('localVar = "eval";');
|
392
|
-
* console.log(`evalResult: '${evalResult}', localVar: '${localVar}'`);
|
393
|
-
* // Prints: evalResult: 'eval', localVar: 'eval'
|
394
|
-
* ```
|
395
|
-
*
|
396
|
-
* Because `vm.runInThisContext()` does not have access to the local scope,`localVar` is unchanged. In contrast,
|
397
|
-
* [`eval()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/eval)_does_ have access to the
|
398
|
-
* local scope, so the value `localVar` is changed. In this way`vm.runInThisContext()` is much like an [indirect `eval()` call](https://es5.github.io/#x10.4.2), e.g.`(0,eval)('code')`.
|
399
|
-
*
|
400
|
-
* ## Example: Running an HTTP server within a VM
|
401
|
-
*
|
402
|
-
* When using either `script.runInThisContext()` or {@link runInThisContext}, the code is executed within the current V8 global
|
403
|
-
* context. The code passed to this VM context will have its own isolated scope.
|
404
|
-
*
|
405
|
-
* In order to run a simple web server using the `http` module the code passed to
|
406
|
-
* the context must either call `require('http')` on its own, or have a reference
|
407
|
-
* to the `http` module passed to it. For instance:
|
408
|
-
*
|
409
|
-
* ```js
|
410
|
-
* 'use strict';
|
411
|
-
* const vm = require('vm');
|
412
|
-
*
|
413
|
-
* const code = `
|
414
|
-
* ((require) => {
|
415
|
-
* const http = require('http');
|
416
|
-
*
|
417
|
-
* http.createServer((request, response) => {
|
418
|
-
* response.writeHead(200, { 'Content-Type': 'text/plain' });
|
419
|
-
* response.end('Hello World\\n');
|
420
|
-
* }).listen(8124);
|
421
|
-
*
|
422
|
-
* console.log('Server running at http://127.0.0.1:8124/');
|
423
|
-
* })`;
|
424
|
-
*
|
425
|
-
* vm.runInThisContext(code)(require);
|
426
|
-
* ```
|
427
|
-
*
|
428
|
-
* The `require()` in the above case shares the state with the context it is
|
429
|
-
* passed from. This may introduce risks when untrusted code is executed, e.g.
|
430
|
-
* altering objects in the context in unwanted ways.
|
431
|
-
* @since v0.3.1
|
432
|
-
* @param code The JavaScript code to compile and run.
|
433
|
-
* @return the result of the very last statement executed in the script.
|
434
|
-
*/
|
435
|
-
function runInThisContext(code: string, options?: RunningScriptOptions | string): any;
|
436
|
-
/**
|
437
|
-
* Compiles the given code into the provided context (if no context is
|
438
|
-
* supplied, the current context is used), and returns it wrapped inside a
|
439
|
-
* function with the given `params`.
|
440
|
-
* @since v10.10.0
|
441
|
-
* @param code The body of the function to compile.
|
442
|
-
* @param params An array of strings containing all parameters for the function.
|
443
|
-
*/
|
444
|
-
function compileFunction(code: string, params?: ReadonlyArray<string>, options?: CompileFunctionOptions): Function;
|
445
|
-
/**
|
446
|
-
* Measure the memory known to V8 and used by all contexts known to the
|
447
|
-
* current V8 isolate, or the main context.
|
448
|
-
*
|
449
|
-
* The format of the object that the returned Promise may resolve with is
|
450
|
-
* specific to the V8 engine and may change from one version of V8 to the next.
|
451
|
-
*
|
452
|
-
* The returned result is different from the statistics returned by`v8.getHeapSpaceStatistics()` in that `vm.measureMemory()` measure the
|
453
|
-
* memory reachable by each V8 specific contexts in the current instance of
|
454
|
-
* the V8 engine, while the result of `v8.getHeapSpaceStatistics()` measure
|
455
|
-
* the memory occupied by each heap space in the current V8 instance.
|
456
|
-
*
|
457
|
-
* ```js
|
458
|
-
* const vm = require('vm');
|
459
|
-
* // Measure the memory used by the main context.
|
460
|
-
* vm.measureMemory({ mode: 'summary' })
|
461
|
-
* // This is the same as vm.measureMemory()
|
462
|
-
* .then((result) => {
|
463
|
-
* // The current format is:
|
464
|
-
* // {
|
465
|
-
* // total: {
|
466
|
-
* // jsMemoryEstimate: 2418479, jsMemoryRange: [ 2418479, 2745799 ]
|
467
|
-
* // }
|
468
|
-
* // }
|
469
|
-
* console.log(result);
|
470
|
-
* });
|
471
|
-
*
|
472
|
-
* const context = vm.createContext({ a: 1 });
|
473
|
-
* vm.measureMemory({ mode: 'detailed', execution: 'eager' })
|
474
|
-
* .then((result) => {
|
475
|
-
* // Reference the context here so that it won't be GC'ed
|
476
|
-
* // until the measurement is complete.
|
477
|
-
* console.log(context.a);
|
478
|
-
* // {
|
479
|
-
* // total: {
|
480
|
-
* // jsMemoryEstimate: 2574732,
|
481
|
-
* // jsMemoryRange: [ 2574732, 2904372 ]
|
482
|
-
* // },
|
483
|
-
* // current: {
|
484
|
-
* // jsMemoryEstimate: 2438996,
|
485
|
-
* // jsMemoryRange: [ 2438996, 2768636 ]
|
486
|
-
* // },
|
487
|
-
* // other: [
|
488
|
-
* // {
|
489
|
-
* // jsMemoryEstimate: 135736,
|
490
|
-
* // jsMemoryRange: [ 135736, 465376 ]
|
491
|
-
* // }
|
492
|
-
* // ]
|
493
|
-
* // }
|
494
|
-
* console.log(result);
|
495
|
-
* });
|
496
|
-
* ```
|
497
|
-
* @since v13.10.0
|
498
|
-
* @experimental
|
499
|
-
*/
|
500
|
-
function measureMemory(options?: MeasureMemoryOptions): Promise<MemoryMeasurement>;
|
501
|
-
}
|
502
|
-
declare module 'node:vm' {
|
503
|
-
export * from 'vm';
|
504
|
-
}
|
1
|
+
/**
|
2
|
+
* The `vm` module enables compiling and running code within V8 Virtual
|
3
|
+
* Machine contexts. **The `vm` module is not a security mechanism. Do**
|
4
|
+
* **not use it to run untrusted code.**
|
5
|
+
*
|
6
|
+
* JavaScript code can be compiled and run immediately or
|
7
|
+
* compiled, saved, and run later.
|
8
|
+
*
|
9
|
+
* A common use case is to run the code in a different V8 Context. This means
|
10
|
+
* invoked code has a different global object than the invoking code.
|
11
|
+
*
|
12
|
+
* One can provide the context by `contextifying` an
|
13
|
+
* object. The invoked code treats any property in the context like a
|
14
|
+
* global variable. Any changes to global variables caused by the invoked
|
15
|
+
* code are reflected in the context object.
|
16
|
+
*
|
17
|
+
* ```js
|
18
|
+
* const vm = require('vm');
|
19
|
+
*
|
20
|
+
* const x = 1;
|
21
|
+
*
|
22
|
+
* const context = { x: 2 };
|
23
|
+
* vm.createContext(context); // Contextify the object.
|
24
|
+
*
|
25
|
+
* const code = 'x += 40; var y = 17;';
|
26
|
+
* // `x` and `y` are global variables in the context.
|
27
|
+
* // Initially, x has the value 2 because that is the value of context.x.
|
28
|
+
* vm.runInContext(code, context);
|
29
|
+
*
|
30
|
+
* console.log(context.x); // 42
|
31
|
+
* console.log(context.y); // 17
|
32
|
+
*
|
33
|
+
* console.log(x); // 1; y is not defined.
|
34
|
+
* ```
|
35
|
+
* @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/vm.js)
|
36
|
+
*/
|
37
|
+
declare module 'vm' {
|
38
|
+
interface Context extends NodeJS.Dict<any> {}
|
39
|
+
interface BaseOptions {
|
40
|
+
/**
|
41
|
+
* Specifies the filename used in stack traces produced by this script.
|
42
|
+
* Default: `''`.
|
43
|
+
*/
|
44
|
+
filename?: string | undefined;
|
45
|
+
/**
|
46
|
+
* Specifies the line number offset that is displayed in stack traces produced by this script.
|
47
|
+
* Default: `0`.
|
48
|
+
*/
|
49
|
+
lineOffset?: number | undefined;
|
50
|
+
/**
|
51
|
+
* Specifies the column number offset that is displayed in stack traces produced by this script.
|
52
|
+
* @default 0
|
53
|
+
*/
|
54
|
+
columnOffset?: number | undefined;
|
55
|
+
}
|
56
|
+
interface ScriptOptions extends BaseOptions {
|
57
|
+
displayErrors?: boolean | undefined;
|
58
|
+
timeout?: number | undefined;
|
59
|
+
cachedData?: Buffer | undefined;
|
60
|
+
/** @deprecated in favor of `script.createCachedData()` */
|
61
|
+
produceCachedData?: boolean | undefined;
|
62
|
+
}
|
63
|
+
interface RunningScriptOptions extends BaseOptions {
|
64
|
+
/**
|
65
|
+
* When `true`, if an `Error` occurs while compiling the `code`, the line of code causing the error is attached to the stack trace.
|
66
|
+
* Default: `true`.
|
67
|
+
*/
|
68
|
+
displayErrors?: boolean | undefined;
|
69
|
+
/**
|
70
|
+
* Specifies the number of milliseconds to execute code before terminating execution.
|
71
|
+
* If execution is terminated, an `Error` will be thrown. This value must be a strictly positive integer.
|
72
|
+
*/
|
73
|
+
timeout?: number | undefined;
|
74
|
+
/**
|
75
|
+
* If `true`, the execution will be terminated when `SIGINT` (Ctrl+C) is received.
|
76
|
+
* Existing handlers for the event that have been attached via `process.on('SIGINT')` will be disabled during script execution, but will continue to work after that.
|
77
|
+
* If execution is terminated, an `Error` will be thrown.
|
78
|
+
* Default: `false`.
|
79
|
+
*/
|
80
|
+
breakOnSigint?: boolean | undefined;
|
81
|
+
/**
|
82
|
+
* If set to `afterEvaluate`, microtasks will be run immediately after the script has run.
|
83
|
+
*/
|
84
|
+
microtaskMode?: 'afterEvaluate' | undefined;
|
85
|
+
}
|
86
|
+
interface CompileFunctionOptions extends BaseOptions {
|
87
|
+
/**
|
88
|
+
* Provides an optional data with V8's code cache data for the supplied source.
|
89
|
+
*/
|
90
|
+
cachedData?: Buffer | undefined;
|
91
|
+
/**
|
92
|
+
* Specifies whether to produce new cache data.
|
93
|
+
* Default: `false`,
|
94
|
+
*/
|
95
|
+
produceCachedData?: boolean | undefined;
|
96
|
+
/**
|
97
|
+
* The sandbox/context in which the said function should be compiled in.
|
98
|
+
*/
|
99
|
+
parsingContext?: Context | undefined;
|
100
|
+
/**
|
101
|
+
* An array containing a collection of context extensions (objects wrapping the current scope) to be applied while compiling
|
102
|
+
*/
|
103
|
+
contextExtensions?: Object[] | undefined;
|
104
|
+
}
|
105
|
+
interface CreateContextOptions {
|
106
|
+
/**
|
107
|
+
* Human-readable name of the newly created context.
|
108
|
+
* @default 'VM Context i' Where i is an ascending numerical index of the created context.
|
109
|
+
*/
|
110
|
+
name?: string | undefined;
|
111
|
+
/**
|
112
|
+
* Corresponds to the newly created context for display purposes.
|
113
|
+
* The origin should be formatted like a `URL`, but with only the scheme, host, and port (if necessary),
|
114
|
+
* like the value of the `url.origin` property of a URL object.
|
115
|
+
* Most notably, this string should omit the trailing slash, as that denotes a path.
|
116
|
+
* @default ''
|
117
|
+
*/
|
118
|
+
origin?: string | undefined;
|
119
|
+
codeGeneration?:
|
120
|
+
| {
|
121
|
+
/**
|
122
|
+
* If set to false any calls to eval or function constructors (Function, GeneratorFunction, etc)
|
123
|
+
* will throw an EvalError.
|
124
|
+
* @default true
|
125
|
+
*/
|
126
|
+
strings?: boolean | undefined;
|
127
|
+
/**
|
128
|
+
* If set to false any attempt to compile a WebAssembly module will throw a WebAssembly.CompileError.
|
129
|
+
* @default true
|
130
|
+
*/
|
131
|
+
wasm?: boolean | undefined;
|
132
|
+
}
|
133
|
+
| undefined;
|
134
|
+
/**
|
135
|
+
* If set to `afterEvaluate`, microtasks will be run immediately after the script has run.
|
136
|
+
*/
|
137
|
+
microtaskMode?: 'afterEvaluate' | undefined;
|
138
|
+
}
|
139
|
+
type MeasureMemoryMode = 'summary' | 'detailed';
|
140
|
+
interface MeasureMemoryOptions {
|
141
|
+
/**
|
142
|
+
* @default 'summary'
|
143
|
+
*/
|
144
|
+
mode?: MeasureMemoryMode | undefined;
|
145
|
+
context?: Context | undefined;
|
146
|
+
}
|
147
|
+
interface MemoryMeasurement {
|
148
|
+
total: {
|
149
|
+
jsMemoryEstimate: number;
|
150
|
+
jsMemoryRange: [number, number];
|
151
|
+
};
|
152
|
+
}
|
153
|
+
/**
|
154
|
+
* Instances of the `vm.Script` class contain precompiled scripts that can be
|
155
|
+
* executed in specific contexts.
|
156
|
+
* @since v0.3.1
|
157
|
+
*/
|
158
|
+
class Script {
|
159
|
+
constructor(code: string, options?: ScriptOptions);
|
160
|
+
/**
|
161
|
+
* Runs the compiled code contained by the `vm.Script` object within the given`contextifiedObject` and returns the result. Running code does not have access
|
162
|
+
* to local scope.
|
163
|
+
*
|
164
|
+
* The following example compiles code that increments a global variable, sets
|
165
|
+
* the value of another global variable, then execute the code multiple times.
|
166
|
+
* The globals are contained in the `context` object.
|
167
|
+
*
|
168
|
+
* ```js
|
169
|
+
* const vm = require('vm');
|
170
|
+
*
|
171
|
+
* const context = {
|
172
|
+
* animal: 'cat',
|
173
|
+
* count: 2
|
174
|
+
* };
|
175
|
+
*
|
176
|
+
* const script = new vm.Script('count += 1; name = "kitty";');
|
177
|
+
*
|
178
|
+
* vm.createContext(context);
|
179
|
+
* for (let i = 0; i < 10; ++i) {
|
180
|
+
* script.runInContext(context);
|
181
|
+
* }
|
182
|
+
*
|
183
|
+
* console.log(context);
|
184
|
+
* // Prints: { animal: 'cat', count: 12, name: 'kitty' }
|
185
|
+
* ```
|
186
|
+
*
|
187
|
+
* Using the `timeout` or `breakOnSigint` options will result in new event loops
|
188
|
+
* and corresponding threads being started, which have a non-zero performance
|
189
|
+
* overhead.
|
190
|
+
* @since v0.3.1
|
191
|
+
* @param contextifiedObject A `contextified` object as returned by the `vm.createContext()` method.
|
192
|
+
* @return the result of the very last statement executed in the script.
|
193
|
+
*/
|
194
|
+
runInContext(contextifiedObject: Context, options?: RunningScriptOptions): any;
|
195
|
+
/**
|
196
|
+
* First contextifies the given `contextObject`, runs the compiled code contained
|
197
|
+
* by the `vm.Script` object within the created context, and returns the result.
|
198
|
+
* Running code does not have access to local scope.
|
199
|
+
*
|
200
|
+
* The following example compiles code that sets a global variable, then executes
|
201
|
+
* the code multiple times in different contexts. The globals are set on and
|
202
|
+
* contained within each individual `context`.
|
203
|
+
*
|
204
|
+
* ```js
|
205
|
+
* const vm = require('vm');
|
206
|
+
*
|
207
|
+
* const script = new vm.Script('globalVar = "set"');
|
208
|
+
*
|
209
|
+
* const contexts = [{}, {}, {}];
|
210
|
+
* contexts.forEach((context) => {
|
211
|
+
* script.runInNewContext(context);
|
212
|
+
* });
|
213
|
+
*
|
214
|
+
* console.log(contexts);
|
215
|
+
* // Prints: [{ globalVar: 'set' }, { globalVar: 'set' }, { globalVar: 'set' }]
|
216
|
+
* ```
|
217
|
+
* @since v0.3.1
|
218
|
+
* @param contextObject An object that will be `contextified`. If `undefined`, a new object will be created.
|
219
|
+
* @return the result of the very last statement executed in the script.
|
220
|
+
*/
|
221
|
+
runInNewContext(contextObject?: Context, options?: RunningScriptOptions): any;
|
222
|
+
/**
|
223
|
+
* Runs the compiled code contained by the `vm.Script` within the context of the
|
224
|
+
* current `global` object. Running code does not have access to local scope, but_does_ have access to the current `global` object.
|
225
|
+
*
|
226
|
+
* The following example compiles code that increments a `global` variable then
|
227
|
+
* executes that code multiple times:
|
228
|
+
*
|
229
|
+
* ```js
|
230
|
+
* const vm = require('vm');
|
231
|
+
*
|
232
|
+
* global.globalVar = 0;
|
233
|
+
*
|
234
|
+
* const script = new vm.Script('globalVar += 1', { filename: 'myfile.vm' });
|
235
|
+
*
|
236
|
+
* for (let i = 0; i < 1000; ++i) {
|
237
|
+
* script.runInThisContext();
|
238
|
+
* }
|
239
|
+
*
|
240
|
+
* console.log(globalVar);
|
241
|
+
*
|
242
|
+
* // 1000
|
243
|
+
* ```
|
244
|
+
* @since v0.3.1
|
245
|
+
* @return the result of the very last statement executed in the script.
|
246
|
+
*/
|
247
|
+
runInThisContext(options?: RunningScriptOptions): any;
|
248
|
+
/**
|
249
|
+
* Creates a code cache that can be used with the `Script` constructor's`cachedData` option. Returns a `Buffer`. This method may be called at any
|
250
|
+
* time and any number of times.
|
251
|
+
*
|
252
|
+
* ```js
|
253
|
+
* const script = new vm.Script(`
|
254
|
+
* function add(a, b) {
|
255
|
+
* return a + b;
|
256
|
+
* }
|
257
|
+
*
|
258
|
+
* const x = add(1, 2);
|
259
|
+
* `);
|
260
|
+
*
|
261
|
+
* const cacheWithoutX = script.createCachedData();
|
262
|
+
*
|
263
|
+
* script.runInThisContext();
|
264
|
+
*
|
265
|
+
* const cacheWithX = script.createCachedData();
|
266
|
+
* ```
|
267
|
+
* @since v10.6.0
|
268
|
+
*/
|
269
|
+
createCachedData(): Buffer;
|
270
|
+
cachedDataRejected?: boolean | undefined;
|
271
|
+
}
|
272
|
+
/**
|
273
|
+
* If given a `contextObject`, the `vm.createContext()` method will `prepare
|
274
|
+
* that object` so that it can be used in calls to {@link runInContext} or `script.runInContext()`. Inside such scripts,
|
275
|
+
* the `contextObject` will be the global object, retaining all of its existing
|
276
|
+
* properties but also having the built-in objects and functions any standard[global object](https://es5.github.io/#x15.1) has. Outside of scripts run by the vm module, global variables
|
277
|
+
* will remain unchanged.
|
278
|
+
*
|
279
|
+
* ```js
|
280
|
+
* const vm = require('vm');
|
281
|
+
*
|
282
|
+
* global.globalVar = 3;
|
283
|
+
*
|
284
|
+
* const context = { globalVar: 1 };
|
285
|
+
* vm.createContext(context);
|
286
|
+
*
|
287
|
+
* vm.runInContext('globalVar *= 2;', context);
|
288
|
+
*
|
289
|
+
* console.log(context);
|
290
|
+
* // Prints: { globalVar: 2 }
|
291
|
+
*
|
292
|
+
* console.log(global.globalVar);
|
293
|
+
* // Prints: 3
|
294
|
+
* ```
|
295
|
+
*
|
296
|
+
* If `contextObject` is omitted (or passed explicitly as `undefined`), a new,
|
297
|
+
* empty `contextified` object will be returned.
|
298
|
+
*
|
299
|
+
* The `vm.createContext()` method is primarily useful for creating a single
|
300
|
+
* context that can be used to run multiple scripts. For instance, if emulating a
|
301
|
+
* web browser, the method can be used to create a single context representing a
|
302
|
+
* window's global object, then run all `<script>` tags together within that
|
303
|
+
* context.
|
304
|
+
*
|
305
|
+
* The provided `name` and `origin` of the context are made visible through the
|
306
|
+
* Inspector API.
|
307
|
+
* @since v0.3.1
|
308
|
+
* @return contextified object.
|
309
|
+
*/
|
310
|
+
function createContext(sandbox?: Context, options?: CreateContextOptions): Context;
|
311
|
+
/**
|
312
|
+
* Returns `true` if the given `object` object has been `contextified` using {@link createContext}.
|
313
|
+
* @since v0.11.7
|
314
|
+
*/
|
315
|
+
function isContext(sandbox: Context): boolean;
|
316
|
+
/**
|
317
|
+
* The `vm.runInContext()` method compiles `code`, runs it within the context of
|
318
|
+
* the `contextifiedObject`, then returns the result. Running code does not have
|
319
|
+
* access to the local scope. The `contextifiedObject` object _must_ have been
|
320
|
+
* previously `contextified` using the {@link createContext} method.
|
321
|
+
*
|
322
|
+
* If `options` is a string, then it specifies the filename.
|
323
|
+
*
|
324
|
+
* The following example compiles and executes different scripts using a single `contextified` object:
|
325
|
+
*
|
326
|
+
* ```js
|
327
|
+
* const vm = require('vm');
|
328
|
+
*
|
329
|
+
* const contextObject = { globalVar: 1 };
|
330
|
+
* vm.createContext(contextObject);
|
331
|
+
*
|
332
|
+
* for (let i = 0; i < 10; ++i) {
|
333
|
+
* vm.runInContext('globalVar *= 2;', contextObject);
|
334
|
+
* }
|
335
|
+
* console.log(contextObject);
|
336
|
+
* // Prints: { globalVar: 1024 }
|
337
|
+
* ```
|
338
|
+
* @since v0.3.1
|
339
|
+
* @param code The JavaScript code to compile and run.
|
340
|
+
* @param contextifiedObject The `contextified` object that will be used as the `global` when the `code` is compiled and run.
|
341
|
+
* @return the result of the very last statement executed in the script.
|
342
|
+
*/
|
343
|
+
function runInContext(code: string, contextifiedObject: Context, options?: RunningScriptOptions | string): any;
|
344
|
+
/**
|
345
|
+
* The `vm.runInNewContext()` first contextifies the given `contextObject` (or
|
346
|
+
* creates a new `contextObject` if passed as `undefined`), compiles the `code`,
|
347
|
+
* runs it within the created context, then returns the result. Running code
|
348
|
+
* does not have access to the local scope.
|
349
|
+
*
|
350
|
+
* If `options` is a string, then it specifies the filename.
|
351
|
+
*
|
352
|
+
* The following example compiles and executes code that increments a global
|
353
|
+
* variable and sets a new one. These globals are contained in the `contextObject`.
|
354
|
+
*
|
355
|
+
* ```js
|
356
|
+
* const vm = require('vm');
|
357
|
+
*
|
358
|
+
* const contextObject = {
|
359
|
+
* animal: 'cat',
|
360
|
+
* count: 2
|
361
|
+
* };
|
362
|
+
*
|
363
|
+
* vm.runInNewContext('count += 1; name = "kitty"', contextObject);
|
364
|
+
* console.log(contextObject);
|
365
|
+
* // Prints: { animal: 'cat', count: 3, name: 'kitty' }
|
366
|
+
* ```
|
367
|
+
* @since v0.3.1
|
368
|
+
* @param code The JavaScript code to compile and run.
|
369
|
+
* @param contextObject An object that will be `contextified`. If `undefined`, a new object will be created.
|
370
|
+
* @return the result of the very last statement executed in the script.
|
371
|
+
*/
|
372
|
+
function runInNewContext(code: string, contextObject?: Context, options?: RunningScriptOptions | string): any;
|
373
|
+
/**
|
374
|
+
* `vm.runInThisContext()` compiles `code`, runs it within the context of the
|
375
|
+
* current `global` and returns the result. Running code does not have access to
|
376
|
+
* local scope, but does have access to the current `global` object.
|
377
|
+
*
|
378
|
+
* If `options` is a string, then it specifies the filename.
|
379
|
+
*
|
380
|
+
* The following example illustrates using both `vm.runInThisContext()` and
|
381
|
+
* the JavaScript [`eval()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/eval) function to run the same code:
|
382
|
+
*
|
383
|
+
* ```js
|
384
|
+
* const vm = require('vm');
|
385
|
+
* let localVar = 'initial value';
|
386
|
+
*
|
387
|
+
* const vmResult = vm.runInThisContext('localVar = "vm";');
|
388
|
+
* console.log(`vmResult: '${vmResult}', localVar: '${localVar}'`);
|
389
|
+
* // Prints: vmResult: 'vm', localVar: 'initial value'
|
390
|
+
*
|
391
|
+
* const evalResult = eval('localVar = "eval";');
|
392
|
+
* console.log(`evalResult: '${evalResult}', localVar: '${localVar}'`);
|
393
|
+
* // Prints: evalResult: 'eval', localVar: 'eval'
|
394
|
+
* ```
|
395
|
+
*
|
396
|
+
* Because `vm.runInThisContext()` does not have access to the local scope,`localVar` is unchanged. In contrast,
|
397
|
+
* [`eval()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/eval)_does_ have access to the
|
398
|
+
* local scope, so the value `localVar` is changed. In this way`vm.runInThisContext()` is much like an [indirect `eval()` call](https://es5.github.io/#x10.4.2), e.g.`(0,eval)('code')`.
|
399
|
+
*
|
400
|
+
* ## Example: Running an HTTP server within a VM
|
401
|
+
*
|
402
|
+
* When using either `script.runInThisContext()` or {@link runInThisContext}, the code is executed within the current V8 global
|
403
|
+
* context. The code passed to this VM context will have its own isolated scope.
|
404
|
+
*
|
405
|
+
* In order to run a simple web server using the `http` module the code passed to
|
406
|
+
* the context must either call `require('http')` on its own, or have a reference
|
407
|
+
* to the `http` module passed to it. For instance:
|
408
|
+
*
|
409
|
+
* ```js
|
410
|
+
* 'use strict';
|
411
|
+
* const vm = require('vm');
|
412
|
+
*
|
413
|
+
* const code = `
|
414
|
+
* ((require) => {
|
415
|
+
* const http = require('http');
|
416
|
+
*
|
417
|
+
* http.createServer((request, response) => {
|
418
|
+
* response.writeHead(200, { 'Content-Type': 'text/plain' });
|
419
|
+
* response.end('Hello World\\n');
|
420
|
+
* }).listen(8124);
|
421
|
+
*
|
422
|
+
* console.log('Server running at http://127.0.0.1:8124/');
|
423
|
+
* })`;
|
424
|
+
*
|
425
|
+
* vm.runInThisContext(code)(require);
|
426
|
+
* ```
|
427
|
+
*
|
428
|
+
* The `require()` in the above case shares the state with the context it is
|
429
|
+
* passed from. This may introduce risks when untrusted code is executed, e.g.
|
430
|
+
* altering objects in the context in unwanted ways.
|
431
|
+
* @since v0.3.1
|
432
|
+
* @param code The JavaScript code to compile and run.
|
433
|
+
* @return the result of the very last statement executed in the script.
|
434
|
+
*/
|
435
|
+
function runInThisContext(code: string, options?: RunningScriptOptions | string): any;
|
436
|
+
/**
|
437
|
+
* Compiles the given code into the provided context (if no context is
|
438
|
+
* supplied, the current context is used), and returns it wrapped inside a
|
439
|
+
* function with the given `params`.
|
440
|
+
* @since v10.10.0
|
441
|
+
* @param code The body of the function to compile.
|
442
|
+
* @param params An array of strings containing all parameters for the function.
|
443
|
+
*/
|
444
|
+
function compileFunction(code: string, params?: ReadonlyArray<string>, options?: CompileFunctionOptions): Function;
|
445
|
+
/**
|
446
|
+
* Measure the memory known to V8 and used by all contexts known to the
|
447
|
+
* current V8 isolate, or the main context.
|
448
|
+
*
|
449
|
+
* The format of the object that the returned Promise may resolve with is
|
450
|
+
* specific to the V8 engine and may change from one version of V8 to the next.
|
451
|
+
*
|
452
|
+
* The returned result is different from the statistics returned by`v8.getHeapSpaceStatistics()` in that `vm.measureMemory()` measure the
|
453
|
+
* memory reachable by each V8 specific contexts in the current instance of
|
454
|
+
* the V8 engine, while the result of `v8.getHeapSpaceStatistics()` measure
|
455
|
+
* the memory occupied by each heap space in the current V8 instance.
|
456
|
+
*
|
457
|
+
* ```js
|
458
|
+
* const vm = require('vm');
|
459
|
+
* // Measure the memory used by the main context.
|
460
|
+
* vm.measureMemory({ mode: 'summary' })
|
461
|
+
* // This is the same as vm.measureMemory()
|
462
|
+
* .then((result) => {
|
463
|
+
* // The current format is:
|
464
|
+
* // {
|
465
|
+
* // total: {
|
466
|
+
* // jsMemoryEstimate: 2418479, jsMemoryRange: [ 2418479, 2745799 ]
|
467
|
+
* // }
|
468
|
+
* // }
|
469
|
+
* console.log(result);
|
470
|
+
* });
|
471
|
+
*
|
472
|
+
* const context = vm.createContext({ a: 1 });
|
473
|
+
* vm.measureMemory({ mode: 'detailed', execution: 'eager' })
|
474
|
+
* .then((result) => {
|
475
|
+
* // Reference the context here so that it won't be GC'ed
|
476
|
+
* // until the measurement is complete.
|
477
|
+
* console.log(context.a);
|
478
|
+
* // {
|
479
|
+
* // total: {
|
480
|
+
* // jsMemoryEstimate: 2574732,
|
481
|
+
* // jsMemoryRange: [ 2574732, 2904372 ]
|
482
|
+
* // },
|
483
|
+
* // current: {
|
484
|
+
* // jsMemoryEstimate: 2438996,
|
485
|
+
* // jsMemoryRange: [ 2438996, 2768636 ]
|
486
|
+
* // },
|
487
|
+
* // other: [
|
488
|
+
* // {
|
489
|
+
* // jsMemoryEstimate: 135736,
|
490
|
+
* // jsMemoryRange: [ 135736, 465376 ]
|
491
|
+
* // }
|
492
|
+
* // ]
|
493
|
+
* // }
|
494
|
+
* console.log(result);
|
495
|
+
* });
|
496
|
+
* ```
|
497
|
+
* @since v13.10.0
|
498
|
+
* @experimental
|
499
|
+
*/
|
500
|
+
function measureMemory(options?: MeasureMemoryOptions): Promise<MemoryMeasurement>;
|
501
|
+
}
|
502
|
+
declare module 'node:vm' {
|
503
|
+
export * from 'vm';
|
504
|
+
}
|