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,590 +1,590 @@
|
|
1
|
-
node-fetch
|
2
|
-
==========
|
3
|
-
|
4
|
-
[![npm version][npm-image]][npm-url]
|
5
|
-
[![build status][travis-image]][travis-url]
|
6
|
-
[![coverage status][codecov-image]][codecov-url]
|
7
|
-
[![install size][install-size-image]][install-size-url]
|
8
|
-
[![Discord][discord-image]][discord-url]
|
9
|
-
|
10
|
-
A light-weight module that brings `window.fetch` to Node.js
|
11
|
-
|
12
|
-
(We are looking for [v2 maintainers and collaborators](https://github.com/bitinn/node-fetch/issues/567))
|
13
|
-
|
14
|
-
[![Backers][opencollective-image]][opencollective-url]
|
15
|
-
|
16
|
-
<!-- TOC -->
|
17
|
-
|
18
|
-
- [Motivation](#motivation)
|
19
|
-
- [Features](#features)
|
20
|
-
- [Difference from client-side fetch](#difference-from-client-side-fetch)
|
21
|
-
- [Installation](#installation)
|
22
|
-
- [Loading and configuring the module](#loading-and-configuring-the-module)
|
23
|
-
- [Common Usage](#common-usage)
|
24
|
-
- [Plain text or HTML](#plain-text-or-html)
|
25
|
-
- [JSON](#json)
|
26
|
-
- [Simple Post](#simple-post)
|
27
|
-
- [Post with JSON](#post-with-json)
|
28
|
-
- [Post with form parameters](#post-with-form-parameters)
|
29
|
-
- [Handling exceptions](#handling-exceptions)
|
30
|
-
- [Handling client and server errors](#handling-client-and-server-errors)
|
31
|
-
- [Advanced Usage](#advanced-usage)
|
32
|
-
- [Streams](#streams)
|
33
|
-
- [Buffer](#buffer)
|
34
|
-
- [Accessing Headers and other Meta data](#accessing-headers-and-other-meta-data)
|
35
|
-
- [Extract Set-Cookie Header](#extract-set-cookie-header)
|
36
|
-
- [Post data using a file stream](#post-data-using-a-file-stream)
|
37
|
-
- [Post with form-data (detect multipart)](#post-with-form-data-detect-multipart)
|
38
|
-
- [Request cancellation with AbortSignal](#request-cancellation-with-abortsignal)
|
39
|
-
- [API](#api)
|
40
|
-
- [fetch(url[, options])](#fetchurl-options)
|
41
|
-
- [Options](#options)
|
42
|
-
- [Class: Request](#class-request)
|
43
|
-
- [Class: Response](#class-response)
|
44
|
-
- [Class: Headers](#class-headers)
|
45
|
-
- [Interface: Body](#interface-body)
|
46
|
-
- [Class: FetchError](#class-fetcherror)
|
47
|
-
- [License](#license)
|
48
|
-
- [Acknowledgement](#acknowledgement)
|
49
|
-
|
50
|
-
<!-- /TOC -->
|
51
|
-
|
52
|
-
## Motivation
|
53
|
-
|
54
|
-
Instead of implementing `XMLHttpRequest` in Node.js to run browser-specific [Fetch polyfill](https://github.com/github/fetch), why not go from native `http` to `fetch` API directly? Hence, `node-fetch`, minimal code for a `window.fetch` compatible API on Node.js runtime.
|
55
|
-
|
56
|
-
See Matt Andrews' [isomorphic-fetch](https://github.com/matthew-andrews/isomorphic-fetch) or Leonardo Quixada's [cross-fetch](https://github.com/lquixada/cross-fetch) for isomorphic usage (exports `node-fetch` for server-side, `whatwg-fetch` for client-side).
|
57
|
-
|
58
|
-
## Features
|
59
|
-
|
60
|
-
- Stay consistent with `window.fetch` API.
|
61
|
-
- Make conscious trade-off when following [WHATWG fetch spec][whatwg-fetch] and [stream spec](https://streams.spec.whatwg.org/) implementation details, document known differences.
|
62
|
-
- Use native promise but allow substituting it with [insert your favorite promise library].
|
63
|
-
- Use native Node streams for body on both request and response.
|
64
|
-
- Decode content encoding (gzip/deflate) properly and convert string output (such as `res.text()` and `res.json()`) to UTF-8 automatically.
|
65
|
-
- Useful extensions such as timeout, redirect limit, response size limit, [explicit errors](ERROR-HANDLING.md) for troubleshooting.
|
66
|
-
|
67
|
-
## Difference from client-side fetch
|
68
|
-
|
69
|
-
- See [Known Differences](LIMITS.md) for details.
|
70
|
-
- If you happen to use a missing feature that `window.fetch` offers, feel free to open an issue.
|
71
|
-
- Pull requests are welcomed too!
|
72
|
-
|
73
|
-
## Installation
|
74
|
-
|
75
|
-
Current stable release (`2.x`)
|
76
|
-
|
77
|
-
```sh
|
78
|
-
$ npm install node-fetch
|
79
|
-
```
|
80
|
-
|
81
|
-
## Loading and configuring the module
|
82
|
-
We suggest you load the module via `require` until the stabilization of ES modules in node:
|
83
|
-
```js
|
84
|
-
const fetch = require('node-fetch');
|
85
|
-
```
|
86
|
-
|
87
|
-
If you are using a Promise library other than native, set it through `fetch.Promise`:
|
88
|
-
```js
|
89
|
-
const Bluebird = require('bluebird');
|
90
|
-
|
91
|
-
fetch.Promise = Bluebird;
|
92
|
-
```
|
93
|
-
|
94
|
-
## Common Usage
|
95
|
-
|
96
|
-
NOTE: The documentation below is up-to-date with `2.x` releases; see the [`1.x` readme](https://github.com/bitinn/node-fetch/blob/1.x/README.md), [changelog](https://github.com/bitinn/node-fetch/blob/1.x/CHANGELOG.md) and [2.x upgrade guide](UPGRADE-GUIDE.md) for the differences.
|
97
|
-
|
98
|
-
#### Plain text or HTML
|
99
|
-
```js
|
100
|
-
fetch('https://github.com/')
|
101
|
-
.then(res => res.text())
|
102
|
-
.then(body => console.log(body));
|
103
|
-
```
|
104
|
-
|
105
|
-
#### JSON
|
106
|
-
|
107
|
-
```js
|
108
|
-
|
109
|
-
fetch('https://api.github.com/users/github')
|
110
|
-
.then(res => res.json())
|
111
|
-
.then(json => console.log(json));
|
112
|
-
```
|
113
|
-
|
114
|
-
#### Simple Post
|
115
|
-
```js
|
116
|
-
fetch('https://httpbin.org/post', { method: 'POST', body: 'a=1' })
|
117
|
-
.then(res => res.json()) // expecting a json response
|
118
|
-
.then(json => console.log(json));
|
119
|
-
```
|
120
|
-
|
121
|
-
#### Post with JSON
|
122
|
-
|
123
|
-
```js
|
124
|
-
const body = { a: 1 };
|
125
|
-
|
126
|
-
fetch('https://httpbin.org/post', {
|
127
|
-
method: 'post',
|
128
|
-
body: JSON.stringify(body),
|
129
|
-
headers: { 'Content-Type': 'application/json' },
|
130
|
-
})
|
131
|
-
.then(res => res.json())
|
132
|
-
.then(json => console.log(json));
|
133
|
-
```
|
134
|
-
|
135
|
-
#### Post with form parameters
|
136
|
-
`URLSearchParams` is available in Node.js as of v7.5.0. See [official documentation](https://nodejs.org/api/url.html#url_class_urlsearchparams) for more usage methods.
|
137
|
-
|
138
|
-
NOTE: The `Content-Type` header is only set automatically to `x-www-form-urlencoded` when an instance of `URLSearchParams` is given as such:
|
139
|
-
|
140
|
-
```js
|
141
|
-
const { URLSearchParams } = require('url');
|
142
|
-
|
143
|
-
const params = new URLSearchParams();
|
144
|
-
params.append('a', 1);
|
145
|
-
|
146
|
-
fetch('https://httpbin.org/post', { method: 'POST', body: params })
|
147
|
-
.then(res => res.json())
|
148
|
-
.then(json => console.log(json));
|
149
|
-
```
|
150
|
-
|
151
|
-
#### Handling exceptions
|
152
|
-
NOTE: 3xx-5xx responses are *NOT* exceptions and should be handled in `then()`; see the next section for more information.
|
153
|
-
|
154
|
-
Adding a catch to the fetch promise chain will catch *all* exceptions, such as errors originating from node core libraries, network errors and operational errors, which are instances of FetchError. See the [error handling document](ERROR-HANDLING.md) for more details.
|
155
|
-
|
156
|
-
```js
|
157
|
-
fetch('https://domain.invalid/')
|
158
|
-
.catch(err => console.error(err));
|
159
|
-
```
|
160
|
-
|
161
|
-
#### Handling client and server errors
|
162
|
-
It is common to create a helper function to check that the response contains no client (4xx) or server (5xx) error responses:
|
163
|
-
|
164
|
-
```js
|
165
|
-
function checkStatus(res) {
|
166
|
-
if (res.ok) { // res.status >= 200 && res.status < 300
|
167
|
-
return res;
|
168
|
-
} else {
|
169
|
-
throw MyCustomError(res.statusText);
|
170
|
-
}
|
171
|
-
}
|
172
|
-
|
173
|
-
fetch('https://httpbin.org/status/400')
|
174
|
-
.then(checkStatus)
|
175
|
-
.then(res => console.log('will not get here...'))
|
176
|
-
```
|
177
|
-
|
178
|
-
## Advanced Usage
|
179
|
-
|
180
|
-
#### Streams
|
181
|
-
The "Node.js way" is to use streams when possible:
|
182
|
-
|
183
|
-
```js
|
184
|
-
fetch('https://assets-cdn.github.com/images/modules/logos_page/Octocat.png')
|
185
|
-
.then(res => {
|
186
|
-
const dest = fs.createWriteStream('./octocat.png');
|
187
|
-
res.body.pipe(dest);
|
188
|
-
});
|
189
|
-
```
|
190
|
-
|
191
|
-
#### Buffer
|
192
|
-
If you prefer to cache binary data in full, use buffer(). (NOTE: `buffer()` is a `node-fetch`-only API)
|
193
|
-
|
194
|
-
```js
|
195
|
-
const fileType = require('file-type');
|
196
|
-
|
197
|
-
fetch('https://assets-cdn.github.com/images/modules/logos_page/Octocat.png')
|
198
|
-
.then(res => res.buffer())
|
199
|
-
.then(buffer => fileType(buffer))
|
200
|
-
.then(type => { /* ... */ });
|
201
|
-
```
|
202
|
-
|
203
|
-
#### Accessing Headers and other Meta data
|
204
|
-
```js
|
205
|
-
fetch('https://github.com/')
|
206
|
-
.then(res => {
|
207
|
-
console.log(res.ok);
|
208
|
-
console.log(res.status);
|
209
|
-
console.log(res.statusText);
|
210
|
-
console.log(res.headers.raw());
|
211
|
-
console.log(res.headers.get('content-type'));
|
212
|
-
});
|
213
|
-
```
|
214
|
-
|
215
|
-
#### Extract Set-Cookie Header
|
216
|
-
|
217
|
-
Unlike browsers, you can access raw `Set-Cookie` headers manually using `Headers.raw()`. This is a `node-fetch` only API.
|
218
|
-
|
219
|
-
```js
|
220
|
-
fetch(url).then(res => {
|
221
|
-
// returns an array of values, instead of a string of comma-separated values
|
222
|
-
console.log(res.headers.raw()['set-cookie']);
|
223
|
-
});
|
224
|
-
```
|
225
|
-
|
226
|
-
#### Post data using a file stream
|
227
|
-
|
228
|
-
```js
|
229
|
-
const { createReadStream } = require('fs');
|
230
|
-
|
231
|
-
const stream = createReadStream('input.txt');
|
232
|
-
|
233
|
-
fetch('https://httpbin.org/post', { method: 'POST', body: stream })
|
234
|
-
.then(res => res.json())
|
235
|
-
.then(json => console.log(json));
|
236
|
-
```
|
237
|
-
|
238
|
-
#### Post with form-data (detect multipart)
|
239
|
-
|
240
|
-
```js
|
241
|
-
const FormData = require('form-data');
|
242
|
-
|
243
|
-
const form = new FormData();
|
244
|
-
form.append('a', 1);
|
245
|
-
|
246
|
-
fetch('https://httpbin.org/post', { method: 'POST', body: form })
|
247
|
-
.then(res => res.json())
|
248
|
-
.then(json => console.log(json));
|
249
|
-
|
250
|
-
// OR, using custom headers
|
251
|
-
// NOTE: getHeaders() is non-standard API
|
252
|
-
|
253
|
-
const form = new FormData();
|
254
|
-
form.append('a', 1);
|
255
|
-
|
256
|
-
const options = {
|
257
|
-
method: 'POST',
|
258
|
-
body: form,
|
259
|
-
headers: form.getHeaders()
|
260
|
-
}
|
261
|
-
|
262
|
-
fetch('https://httpbin.org/post', options)
|
263
|
-
.then(res => res.json())
|
264
|
-
.then(json => console.log(json));
|
265
|
-
```
|
266
|
-
|
267
|
-
#### Request cancellation with AbortSignal
|
268
|
-
|
269
|
-
> NOTE: You may cancel streamed requests only on Node >= v8.0.0
|
270
|
-
|
271
|
-
You may cancel requests with `AbortController`. A suggested implementation is [`abort-controller`](https://www.npmjs.com/package/abort-controller).
|
272
|
-
|
273
|
-
An example of timing out a request after 150ms could be achieved as the following:
|
274
|
-
|
275
|
-
```js
|
276
|
-
import AbortController from 'abort-controller';
|
277
|
-
|
278
|
-
const controller = new AbortController();
|
279
|
-
const timeout = setTimeout(
|
280
|
-
() => { controller.abort(); },
|
281
|
-
150,
|
282
|
-
);
|
283
|
-
|
284
|
-
fetch(url, { signal: controller.signal })
|
285
|
-
.then(res => res.json())
|
286
|
-
.then(
|
287
|
-
data => {
|
288
|
-
useData(data)
|
289
|
-
},
|
290
|
-
err => {
|
291
|
-
if (err.name === 'AbortError') {
|
292
|
-
// request was aborted
|
293
|
-
}
|
294
|
-
},
|
295
|
-
)
|
296
|
-
.finally(() => {
|
297
|
-
clearTimeout(timeout);
|
298
|
-
});
|
299
|
-
```
|
300
|
-
|
301
|
-
See [test cases](https://github.com/bitinn/node-fetch/blob/master/test/test.js) for more examples.
|
302
|
-
|
303
|
-
|
304
|
-
## API
|
305
|
-
|
306
|
-
### fetch(url[, options])
|
307
|
-
|
308
|
-
- `url` A string representing the URL for fetching
|
309
|
-
- `options` [Options](#fetch-options) for the HTTP(S) request
|
310
|
-
- Returns: <code>Promise<[Response](#class-response)></code>
|
311
|
-
|
312
|
-
Perform an HTTP(S) fetch.
|
313
|
-
|
314
|
-
`url` should be an absolute url, such as `https://example.com/`. A path-relative URL (`/file/under/root`) or protocol-relative URL (`//can-be-http-or-https.com/`) will result in a rejected `Promise`.
|
315
|
-
|
316
|
-
<a id="fetch-options"></a>
|
317
|
-
### Options
|
318
|
-
|
319
|
-
The default values are shown after each option key.
|
320
|
-
|
321
|
-
```js
|
322
|
-
{
|
323
|
-
// These properties are part of the Fetch Standard
|
324
|
-
method: 'GET',
|
325
|
-
headers: {}, // request headers. format is the identical to that accepted by the Headers constructor (see below)
|
326
|
-
body: null, // request body. can be null, a string, a Buffer, a Blob, or a Node.js Readable stream
|
327
|
-
redirect: 'follow', // set to `manual` to extract redirect headers, `error` to reject redirect
|
328
|
-
signal: null, // pass an instance of AbortSignal to optionally abort requests
|
329
|
-
|
330
|
-
// The following properties are node-fetch extensions
|
331
|
-
follow: 20, // maximum redirect count. 0 to not follow redirect
|
332
|
-
timeout: 0, // req/res timeout in ms, it resets on redirect. 0 to disable (OS limit applies). Signal is recommended instead.
|
333
|
-
compress: true, // support gzip/deflate content encoding. false to disable
|
334
|
-
size: 0, // maximum response body size in bytes. 0 to disable
|
335
|
-
agent: null // http(s).Agent instance or function that returns an instance (see below)
|
336
|
-
}
|
337
|
-
```
|
338
|
-
|
339
|
-
##### Default Headers
|
340
|
-
|
341
|
-
If no values are set, the following request headers will be sent automatically:
|
342
|
-
|
343
|
-
Header | Value
|
344
|
-
------------------- | --------------------------------------------------------
|
345
|
-
`Accept-Encoding` | `gzip,deflate` _(when `options.compress === true`)_
|
346
|
-
`Accept` | `*/*`
|
347
|
-
`Connection` | `close` _(when no `options.agent` is present)_
|
348
|
-
`Content-Length` | _(automatically calculated, if possible)_
|
349
|
-
`Transfer-Encoding` | `chunked` _(when `req.body` is a stream)_
|
350
|
-
`User-Agent` | `node-fetch/1.0 (+https://github.com/bitinn/node-fetch)`
|
351
|
-
|
352
|
-
Note: when `body` is a `Stream`, `Content-Length` is not set automatically.
|
353
|
-
|
354
|
-
##### Custom Agent
|
355
|
-
|
356
|
-
The `agent` option allows you to specify networking related options which are out of the scope of Fetch, including and not limited to the following:
|
357
|
-
|
358
|
-
- Support self-signed certificate
|
359
|
-
- Use only IPv4 or IPv6
|
360
|
-
- Custom DNS Lookup
|
361
|
-
|
362
|
-
See [`http.Agent`](https://nodejs.org/api/http.html#http_new_agent_options) for more information.
|
363
|
-
|
364
|
-
In addition, the `agent` option accepts a function that returns `http`(s)`.Agent` instance given current [URL](https://nodejs.org/api/url.html), this is useful during a redirection chain across HTTP and HTTPS protocol.
|
365
|
-
|
366
|
-
```js
|
367
|
-
const httpAgent = new http.Agent({
|
368
|
-
keepAlive: true
|
369
|
-
});
|
370
|
-
const httpsAgent = new https.Agent({
|
371
|
-
keepAlive: true
|
372
|
-
});
|
373
|
-
|
374
|
-
const options = {
|
375
|
-
agent: function (_parsedURL) {
|
376
|
-
if (_parsedURL.protocol == 'http:') {
|
377
|
-
return httpAgent;
|
378
|
-
} else {
|
379
|
-
return httpsAgent;
|
380
|
-
}
|
381
|
-
}
|
382
|
-
}
|
383
|
-
```
|
384
|
-
|
385
|
-
<a id="class-request"></a>
|
386
|
-
### Class: Request
|
387
|
-
|
388
|
-
An HTTP(S) request containing information about URL, method, headers, and the body. This class implements the [Body](#iface-body) interface.
|
389
|
-
|
390
|
-
Due to the nature of Node.js, the following properties are not implemented at this moment:
|
391
|
-
|
392
|
-
- `type`
|
393
|
-
- `destination`
|
394
|
-
- `referrer`
|
395
|
-
- `referrerPolicy`
|
396
|
-
- `mode`
|
397
|
-
- `credentials`
|
398
|
-
- `cache`
|
399
|
-
- `integrity`
|
400
|
-
- `keepalive`
|
401
|
-
|
402
|
-
The following node-fetch extension properties are provided:
|
403
|
-
|
404
|
-
- `follow`
|
405
|
-
- `compress`
|
406
|
-
- `counter`
|
407
|
-
- `agent`
|
408
|
-
|
409
|
-
See [options](#fetch-options) for exact meaning of these extensions.
|
410
|
-
|
411
|
-
#### new Request(input[, options])
|
412
|
-
|
413
|
-
<small>*(spec-compliant)*</small>
|
414
|
-
|
415
|
-
- `input` A string representing a URL, or another `Request` (which will be cloned)
|
416
|
-
- `options` [Options][#fetch-options] for the HTTP(S) request
|
417
|
-
|
418
|
-
Constructs a new `Request` object. The constructor is identical to that in the [browser](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request).
|
419
|
-
|
420
|
-
In most cases, directly `fetch(url, options)` is simpler than creating a `Request` object.
|
421
|
-
|
422
|
-
<a id="class-response"></a>
|
423
|
-
### Class: Response
|
424
|
-
|
425
|
-
An HTTP(S) response. This class implements the [Body](#iface-body) interface.
|
426
|
-
|
427
|
-
The following properties are not implemented in node-fetch at this moment:
|
428
|
-
|
429
|
-
- `Response.error()`
|
430
|
-
- `Response.redirect()`
|
431
|
-
- `type`
|
432
|
-
- `trailer`
|
433
|
-
|
434
|
-
#### new Response([body[, options]])
|
435
|
-
|
436
|
-
<small>*(spec-compliant)*</small>
|
437
|
-
|
438
|
-
- `body` A `String` or [`Readable` stream][node-readable]
|
439
|
-
- `options` A [`ResponseInit`][response-init] options dictionary
|
440
|
-
|
441
|
-
Constructs a new `Response` object. The constructor is identical to that in the [browser](https://developer.mozilla.org/en-US/docs/Web/API/Response/Response).
|
442
|
-
|
443
|
-
Because Node.js does not implement service workers (for which this class was designed), one rarely has to construct a `Response` directly.
|
444
|
-
|
445
|
-
#### response.ok
|
446
|
-
|
447
|
-
<small>*(spec-compliant)*</small>
|
448
|
-
|
449
|
-
Convenience property representing if the request ended normally. Will evaluate to true if the response status was greater than or equal to 200 but smaller than 300.
|
450
|
-
|
451
|
-
#### response.redirected
|
452
|
-
|
453
|
-
<small>*(spec-compliant)*</small>
|
454
|
-
|
455
|
-
Convenience property representing if the request has been redirected at least once. Will evaluate to true if the internal redirect counter is greater than 0.
|
456
|
-
|
457
|
-
<a id="class-headers"></a>
|
458
|
-
### Class: Headers
|
459
|
-
|
460
|
-
This class allows manipulating and iterating over a set of HTTP headers. All methods specified in the [Fetch Standard][whatwg-fetch] are implemented.
|
461
|
-
|
462
|
-
#### new Headers([init])
|
463
|
-
|
464
|
-
<small>*(spec-compliant)*</small>
|
465
|
-
|
466
|
-
- `init` Optional argument to pre-fill the `Headers` object
|
467
|
-
|
468
|
-
Construct a new `Headers` object. `init` can be either `null`, a `Headers` object, an key-value map object or any iterable object.
|
469
|
-
|
470
|
-
```js
|
471
|
-
// Example adapted from https://fetch.spec.whatwg.org/#example-headers-class
|
472
|
-
|
473
|
-
const meta = {
|
474
|
-
'Content-Type': 'text/xml',
|
475
|
-
'Breaking-Bad': '<3'
|
476
|
-
};
|
477
|
-
const headers = new Headers(meta);
|
478
|
-
|
479
|
-
// The above is equivalent to
|
480
|
-
const meta = [
|
481
|
-
[ 'Content-Type', 'text/xml' ],
|
482
|
-
[ 'Breaking-Bad', '<3' ]
|
483
|
-
];
|
484
|
-
const headers = new Headers(meta);
|
485
|
-
|
486
|
-
// You can in fact use any iterable objects, like a Map or even another Headers
|
487
|
-
const meta = new Map();
|
488
|
-
meta.set('Content-Type', 'text/xml');
|
489
|
-
meta.set('Breaking-Bad', '<3');
|
490
|
-
const headers = new Headers(meta);
|
491
|
-
const copyOfHeaders = new Headers(headers);
|
492
|
-
```
|
493
|
-
|
494
|
-
<a id="iface-body"></a>
|
495
|
-
### Interface: Body
|
496
|
-
|
497
|
-
`Body` is an abstract interface with methods that are applicable to both `Request` and `Response` classes.
|
498
|
-
|
499
|
-
The following methods are not yet implemented in node-fetch at this moment:
|
500
|
-
|
501
|
-
- `formData()`
|
502
|
-
|
503
|
-
#### body.body
|
504
|
-
|
505
|
-
<small>*(deviation from spec)*</small>
|
506
|
-
|
507
|
-
* Node.js [`Readable` stream][node-readable]
|
508
|
-
|
509
|
-
Data are encapsulated in the `Body` object. Note that while the [Fetch Standard][whatwg-fetch] requires the property to always be a WHATWG `ReadableStream`, in node-fetch it is a Node.js [`Readable` stream][node-readable].
|
510
|
-
|
511
|
-
#### body.bodyUsed
|
512
|
-
|
513
|
-
<small>*(spec-compliant)*</small>
|
514
|
-
|
515
|
-
* `Boolean`
|
516
|
-
|
517
|
-
A boolean property for if this body has been consumed. Per the specs, a consumed body cannot be used again.
|
518
|
-
|
519
|
-
#### body.arrayBuffer()
|
520
|
-
#### body.blob()
|
521
|
-
#### body.json()
|
522
|
-
#### body.text()
|
523
|
-
|
524
|
-
<small>*(spec-compliant)*</small>
|
525
|
-
|
526
|
-
* Returns: <code>Promise</code>
|
527
|
-
|
528
|
-
Consume the body and return a promise that will resolve to one of these formats.
|
529
|
-
|
530
|
-
#### body.buffer()
|
531
|
-
|
532
|
-
<small>*(node-fetch extension)*</small>
|
533
|
-
|
534
|
-
* Returns: <code>Promise<Buffer></code>
|
535
|
-
|
536
|
-
Consume the body and return a promise that will resolve to a Buffer.
|
537
|
-
|
538
|
-
#### body.textConverted()
|
539
|
-
|
540
|
-
<small>*(node-fetch extension)*</small>
|
541
|
-
|
542
|
-
* Returns: <code>Promise<String></code>
|
543
|
-
|
544
|
-
Identical to `body.text()`, except instead of always converting to UTF-8, encoding sniffing will be performed and text converted to UTF-8 if possible.
|
545
|
-
|
546
|
-
(This API requires an optional dependency of the npm package [encoding](https://www.npmjs.com/package/encoding), which you need to install manually. `webpack` users may see [a warning message](https://github.com/bitinn/node-fetch/issues/412#issuecomment-379007792) due to this optional dependency.)
|
547
|
-
|
548
|
-
<a id="class-fetcherror"></a>
|
549
|
-
### Class: FetchError
|
550
|
-
|
551
|
-
<small>*(node-fetch extension)*</small>
|
552
|
-
|
553
|
-
An operational error in the fetching process. See [ERROR-HANDLING.md][] for more info.
|
554
|
-
|
555
|
-
<a id="class-aborterror"></a>
|
556
|
-
### Class: AbortError
|
557
|
-
|
558
|
-
<small>*(node-fetch extension)*</small>
|
559
|
-
|
560
|
-
An Error thrown when the request is aborted in response to an `AbortSignal`'s `abort` event. It has a `name` property of `AbortError`. See [ERROR-HANDLING.MD][] for more info.
|
561
|
-
|
562
|
-
## Acknowledgement
|
563
|
-
|
564
|
-
Thanks to [github/fetch](https://github.com/github/fetch) for providing a solid implementation reference.
|
565
|
-
|
566
|
-
`node-fetch` v1 was maintained by [@bitinn](https://github.com/bitinn); v2 was maintained by [@TimothyGu](https://github.com/timothygu), [@bitinn](https://github.com/bitinn) and [@jimmywarting](https://github.com/jimmywarting); v2 readme is written by [@jkantr](https://github.com/jkantr).
|
567
|
-
|
568
|
-
## License
|
569
|
-
|
570
|
-
MIT
|
571
|
-
|
572
|
-
[npm-image]: https://flat.badgen.net/npm/v/node-fetch
|
573
|
-
[npm-url]: https://www.npmjs.com/package/node-fetch
|
574
|
-
[travis-image]: https://flat.badgen.net/travis/bitinn/node-fetch
|
575
|
-
[travis-url]: https://travis-ci.org/bitinn/node-fetch
|
576
|
-
[codecov-image]: https://flat.badgen.net/codecov/c/github/bitinn/node-fetch/master
|
577
|
-
[codecov-url]: https://codecov.io/gh/bitinn/node-fetch
|
578
|
-
[install-size-image]: https://flat.badgen.net/packagephobia/install/node-fetch
|
579
|
-
[install-size-url]: https://packagephobia.now.sh/result?p=node-fetch
|
580
|
-
[discord-image]: https://img.shields.io/discord/619915844268326952?color=%237289DA&label=Discord&style=flat-square
|
581
|
-
[discord-url]: https://discord.gg/Zxbndcm
|
582
|
-
[opencollective-image]: https://opencollective.com/node-fetch/backers.svg
|
583
|
-
[opencollective-url]: https://opencollective.com/node-fetch
|
584
|
-
[whatwg-fetch]: https://fetch.spec.whatwg.org/
|
585
|
-
[response-init]: https://fetch.spec.whatwg.org/#responseinit
|
586
|
-
[node-readable]: https://nodejs.org/api/stream.html#stream_readable_streams
|
587
|
-
[mdn-headers]: https://developer.mozilla.org/en-US/docs/Web/API/Headers
|
588
|
-
[LIMITS.md]: https://github.com/bitinn/node-fetch/blob/master/LIMITS.md
|
589
|
-
[ERROR-HANDLING.md]: https://github.com/bitinn/node-fetch/blob/master/ERROR-HANDLING.md
|
590
|
-
[UPGRADE-GUIDE.md]: https://github.com/bitinn/node-fetch/blob/master/UPGRADE-GUIDE.md
|
1
|
+
node-fetch
|
2
|
+
==========
|
3
|
+
|
4
|
+
[![npm version][npm-image]][npm-url]
|
5
|
+
[![build status][travis-image]][travis-url]
|
6
|
+
[![coverage status][codecov-image]][codecov-url]
|
7
|
+
[![install size][install-size-image]][install-size-url]
|
8
|
+
[![Discord][discord-image]][discord-url]
|
9
|
+
|
10
|
+
A light-weight module that brings `window.fetch` to Node.js
|
11
|
+
|
12
|
+
(We are looking for [v2 maintainers and collaborators](https://github.com/bitinn/node-fetch/issues/567))
|
13
|
+
|
14
|
+
[![Backers][opencollective-image]][opencollective-url]
|
15
|
+
|
16
|
+
<!-- TOC -->
|
17
|
+
|
18
|
+
- [Motivation](#motivation)
|
19
|
+
- [Features](#features)
|
20
|
+
- [Difference from client-side fetch](#difference-from-client-side-fetch)
|
21
|
+
- [Installation](#installation)
|
22
|
+
- [Loading and configuring the module](#loading-and-configuring-the-module)
|
23
|
+
- [Common Usage](#common-usage)
|
24
|
+
- [Plain text or HTML](#plain-text-or-html)
|
25
|
+
- [JSON](#json)
|
26
|
+
- [Simple Post](#simple-post)
|
27
|
+
- [Post with JSON](#post-with-json)
|
28
|
+
- [Post with form parameters](#post-with-form-parameters)
|
29
|
+
- [Handling exceptions](#handling-exceptions)
|
30
|
+
- [Handling client and server errors](#handling-client-and-server-errors)
|
31
|
+
- [Advanced Usage](#advanced-usage)
|
32
|
+
- [Streams](#streams)
|
33
|
+
- [Buffer](#buffer)
|
34
|
+
- [Accessing Headers and other Meta data](#accessing-headers-and-other-meta-data)
|
35
|
+
- [Extract Set-Cookie Header](#extract-set-cookie-header)
|
36
|
+
- [Post data using a file stream](#post-data-using-a-file-stream)
|
37
|
+
- [Post with form-data (detect multipart)](#post-with-form-data-detect-multipart)
|
38
|
+
- [Request cancellation with AbortSignal](#request-cancellation-with-abortsignal)
|
39
|
+
- [API](#api)
|
40
|
+
- [fetch(url[, options])](#fetchurl-options)
|
41
|
+
- [Options](#options)
|
42
|
+
- [Class: Request](#class-request)
|
43
|
+
- [Class: Response](#class-response)
|
44
|
+
- [Class: Headers](#class-headers)
|
45
|
+
- [Interface: Body](#interface-body)
|
46
|
+
- [Class: FetchError](#class-fetcherror)
|
47
|
+
- [License](#license)
|
48
|
+
- [Acknowledgement](#acknowledgement)
|
49
|
+
|
50
|
+
<!-- /TOC -->
|
51
|
+
|
52
|
+
## Motivation
|
53
|
+
|
54
|
+
Instead of implementing `XMLHttpRequest` in Node.js to run browser-specific [Fetch polyfill](https://github.com/github/fetch), why not go from native `http` to `fetch` API directly? Hence, `node-fetch`, minimal code for a `window.fetch` compatible API on Node.js runtime.
|
55
|
+
|
56
|
+
See Matt Andrews' [isomorphic-fetch](https://github.com/matthew-andrews/isomorphic-fetch) or Leonardo Quixada's [cross-fetch](https://github.com/lquixada/cross-fetch) for isomorphic usage (exports `node-fetch` for server-side, `whatwg-fetch` for client-side).
|
57
|
+
|
58
|
+
## Features
|
59
|
+
|
60
|
+
- Stay consistent with `window.fetch` API.
|
61
|
+
- Make conscious trade-off when following [WHATWG fetch spec][whatwg-fetch] and [stream spec](https://streams.spec.whatwg.org/) implementation details, document known differences.
|
62
|
+
- Use native promise but allow substituting it with [insert your favorite promise library].
|
63
|
+
- Use native Node streams for body on both request and response.
|
64
|
+
- Decode content encoding (gzip/deflate) properly and convert string output (such as `res.text()` and `res.json()`) to UTF-8 automatically.
|
65
|
+
- Useful extensions such as timeout, redirect limit, response size limit, [explicit errors](ERROR-HANDLING.md) for troubleshooting.
|
66
|
+
|
67
|
+
## Difference from client-side fetch
|
68
|
+
|
69
|
+
- See [Known Differences](LIMITS.md) for details.
|
70
|
+
- If you happen to use a missing feature that `window.fetch` offers, feel free to open an issue.
|
71
|
+
- Pull requests are welcomed too!
|
72
|
+
|
73
|
+
## Installation
|
74
|
+
|
75
|
+
Current stable release (`2.x`)
|
76
|
+
|
77
|
+
```sh
|
78
|
+
$ npm install node-fetch
|
79
|
+
```
|
80
|
+
|
81
|
+
## Loading and configuring the module
|
82
|
+
We suggest you load the module via `require` until the stabilization of ES modules in node:
|
83
|
+
```js
|
84
|
+
const fetch = require('node-fetch');
|
85
|
+
```
|
86
|
+
|
87
|
+
If you are using a Promise library other than native, set it through `fetch.Promise`:
|
88
|
+
```js
|
89
|
+
const Bluebird = require('bluebird');
|
90
|
+
|
91
|
+
fetch.Promise = Bluebird;
|
92
|
+
```
|
93
|
+
|
94
|
+
## Common Usage
|
95
|
+
|
96
|
+
NOTE: The documentation below is up-to-date with `2.x` releases; see the [`1.x` readme](https://github.com/bitinn/node-fetch/blob/1.x/README.md), [changelog](https://github.com/bitinn/node-fetch/blob/1.x/CHANGELOG.md) and [2.x upgrade guide](UPGRADE-GUIDE.md) for the differences.
|
97
|
+
|
98
|
+
#### Plain text or HTML
|
99
|
+
```js
|
100
|
+
fetch('https://github.com/')
|
101
|
+
.then(res => res.text())
|
102
|
+
.then(body => console.log(body));
|
103
|
+
```
|
104
|
+
|
105
|
+
#### JSON
|
106
|
+
|
107
|
+
```js
|
108
|
+
|
109
|
+
fetch('https://api.github.com/users/github')
|
110
|
+
.then(res => res.json())
|
111
|
+
.then(json => console.log(json));
|
112
|
+
```
|
113
|
+
|
114
|
+
#### Simple Post
|
115
|
+
```js
|
116
|
+
fetch('https://httpbin.org/post', { method: 'POST', body: 'a=1' })
|
117
|
+
.then(res => res.json()) // expecting a json response
|
118
|
+
.then(json => console.log(json));
|
119
|
+
```
|
120
|
+
|
121
|
+
#### Post with JSON
|
122
|
+
|
123
|
+
```js
|
124
|
+
const body = { a: 1 };
|
125
|
+
|
126
|
+
fetch('https://httpbin.org/post', {
|
127
|
+
method: 'post',
|
128
|
+
body: JSON.stringify(body),
|
129
|
+
headers: { 'Content-Type': 'application/json' },
|
130
|
+
})
|
131
|
+
.then(res => res.json())
|
132
|
+
.then(json => console.log(json));
|
133
|
+
```
|
134
|
+
|
135
|
+
#### Post with form parameters
|
136
|
+
`URLSearchParams` is available in Node.js as of v7.5.0. See [official documentation](https://nodejs.org/api/url.html#url_class_urlsearchparams) for more usage methods.
|
137
|
+
|
138
|
+
NOTE: The `Content-Type` header is only set automatically to `x-www-form-urlencoded` when an instance of `URLSearchParams` is given as such:
|
139
|
+
|
140
|
+
```js
|
141
|
+
const { URLSearchParams } = require('url');
|
142
|
+
|
143
|
+
const params = new URLSearchParams();
|
144
|
+
params.append('a', 1);
|
145
|
+
|
146
|
+
fetch('https://httpbin.org/post', { method: 'POST', body: params })
|
147
|
+
.then(res => res.json())
|
148
|
+
.then(json => console.log(json));
|
149
|
+
```
|
150
|
+
|
151
|
+
#### Handling exceptions
|
152
|
+
NOTE: 3xx-5xx responses are *NOT* exceptions and should be handled in `then()`; see the next section for more information.
|
153
|
+
|
154
|
+
Adding a catch to the fetch promise chain will catch *all* exceptions, such as errors originating from node core libraries, network errors and operational errors, which are instances of FetchError. See the [error handling document](ERROR-HANDLING.md) for more details.
|
155
|
+
|
156
|
+
```js
|
157
|
+
fetch('https://domain.invalid/')
|
158
|
+
.catch(err => console.error(err));
|
159
|
+
```
|
160
|
+
|
161
|
+
#### Handling client and server errors
|
162
|
+
It is common to create a helper function to check that the response contains no client (4xx) or server (5xx) error responses:
|
163
|
+
|
164
|
+
```js
|
165
|
+
function checkStatus(res) {
|
166
|
+
if (res.ok) { // res.status >= 200 && res.status < 300
|
167
|
+
return res;
|
168
|
+
} else {
|
169
|
+
throw MyCustomError(res.statusText);
|
170
|
+
}
|
171
|
+
}
|
172
|
+
|
173
|
+
fetch('https://httpbin.org/status/400')
|
174
|
+
.then(checkStatus)
|
175
|
+
.then(res => console.log('will not get here...'))
|
176
|
+
```
|
177
|
+
|
178
|
+
## Advanced Usage
|
179
|
+
|
180
|
+
#### Streams
|
181
|
+
The "Node.js way" is to use streams when possible:
|
182
|
+
|
183
|
+
```js
|
184
|
+
fetch('https://assets-cdn.github.com/images/modules/logos_page/Octocat.png')
|
185
|
+
.then(res => {
|
186
|
+
const dest = fs.createWriteStream('./octocat.png');
|
187
|
+
res.body.pipe(dest);
|
188
|
+
});
|
189
|
+
```
|
190
|
+
|
191
|
+
#### Buffer
|
192
|
+
If you prefer to cache binary data in full, use buffer(). (NOTE: `buffer()` is a `node-fetch`-only API)
|
193
|
+
|
194
|
+
```js
|
195
|
+
const fileType = require('file-type');
|
196
|
+
|
197
|
+
fetch('https://assets-cdn.github.com/images/modules/logos_page/Octocat.png')
|
198
|
+
.then(res => res.buffer())
|
199
|
+
.then(buffer => fileType(buffer))
|
200
|
+
.then(type => { /* ... */ });
|
201
|
+
```
|
202
|
+
|
203
|
+
#### Accessing Headers and other Meta data
|
204
|
+
```js
|
205
|
+
fetch('https://github.com/')
|
206
|
+
.then(res => {
|
207
|
+
console.log(res.ok);
|
208
|
+
console.log(res.status);
|
209
|
+
console.log(res.statusText);
|
210
|
+
console.log(res.headers.raw());
|
211
|
+
console.log(res.headers.get('content-type'));
|
212
|
+
});
|
213
|
+
```
|
214
|
+
|
215
|
+
#### Extract Set-Cookie Header
|
216
|
+
|
217
|
+
Unlike browsers, you can access raw `Set-Cookie` headers manually using `Headers.raw()`. This is a `node-fetch` only API.
|
218
|
+
|
219
|
+
```js
|
220
|
+
fetch(url).then(res => {
|
221
|
+
// returns an array of values, instead of a string of comma-separated values
|
222
|
+
console.log(res.headers.raw()['set-cookie']);
|
223
|
+
});
|
224
|
+
```
|
225
|
+
|
226
|
+
#### Post data using a file stream
|
227
|
+
|
228
|
+
```js
|
229
|
+
const { createReadStream } = require('fs');
|
230
|
+
|
231
|
+
const stream = createReadStream('input.txt');
|
232
|
+
|
233
|
+
fetch('https://httpbin.org/post', { method: 'POST', body: stream })
|
234
|
+
.then(res => res.json())
|
235
|
+
.then(json => console.log(json));
|
236
|
+
```
|
237
|
+
|
238
|
+
#### Post with form-data (detect multipart)
|
239
|
+
|
240
|
+
```js
|
241
|
+
const FormData = require('form-data');
|
242
|
+
|
243
|
+
const form = new FormData();
|
244
|
+
form.append('a', 1);
|
245
|
+
|
246
|
+
fetch('https://httpbin.org/post', { method: 'POST', body: form })
|
247
|
+
.then(res => res.json())
|
248
|
+
.then(json => console.log(json));
|
249
|
+
|
250
|
+
// OR, using custom headers
|
251
|
+
// NOTE: getHeaders() is non-standard API
|
252
|
+
|
253
|
+
const form = new FormData();
|
254
|
+
form.append('a', 1);
|
255
|
+
|
256
|
+
const options = {
|
257
|
+
method: 'POST',
|
258
|
+
body: form,
|
259
|
+
headers: form.getHeaders()
|
260
|
+
}
|
261
|
+
|
262
|
+
fetch('https://httpbin.org/post', options)
|
263
|
+
.then(res => res.json())
|
264
|
+
.then(json => console.log(json));
|
265
|
+
```
|
266
|
+
|
267
|
+
#### Request cancellation with AbortSignal
|
268
|
+
|
269
|
+
> NOTE: You may cancel streamed requests only on Node >= v8.0.0
|
270
|
+
|
271
|
+
You may cancel requests with `AbortController`. A suggested implementation is [`abort-controller`](https://www.npmjs.com/package/abort-controller).
|
272
|
+
|
273
|
+
An example of timing out a request after 150ms could be achieved as the following:
|
274
|
+
|
275
|
+
```js
|
276
|
+
import AbortController from 'abort-controller';
|
277
|
+
|
278
|
+
const controller = new AbortController();
|
279
|
+
const timeout = setTimeout(
|
280
|
+
() => { controller.abort(); },
|
281
|
+
150,
|
282
|
+
);
|
283
|
+
|
284
|
+
fetch(url, { signal: controller.signal })
|
285
|
+
.then(res => res.json())
|
286
|
+
.then(
|
287
|
+
data => {
|
288
|
+
useData(data)
|
289
|
+
},
|
290
|
+
err => {
|
291
|
+
if (err.name === 'AbortError') {
|
292
|
+
// request was aborted
|
293
|
+
}
|
294
|
+
},
|
295
|
+
)
|
296
|
+
.finally(() => {
|
297
|
+
clearTimeout(timeout);
|
298
|
+
});
|
299
|
+
```
|
300
|
+
|
301
|
+
See [test cases](https://github.com/bitinn/node-fetch/blob/master/test/test.js) for more examples.
|
302
|
+
|
303
|
+
|
304
|
+
## API
|
305
|
+
|
306
|
+
### fetch(url[, options])
|
307
|
+
|
308
|
+
- `url` A string representing the URL for fetching
|
309
|
+
- `options` [Options](#fetch-options) for the HTTP(S) request
|
310
|
+
- Returns: <code>Promise<[Response](#class-response)></code>
|
311
|
+
|
312
|
+
Perform an HTTP(S) fetch.
|
313
|
+
|
314
|
+
`url` should be an absolute url, such as `https://example.com/`. A path-relative URL (`/file/under/root`) or protocol-relative URL (`//can-be-http-or-https.com/`) will result in a rejected `Promise`.
|
315
|
+
|
316
|
+
<a id="fetch-options"></a>
|
317
|
+
### Options
|
318
|
+
|
319
|
+
The default values are shown after each option key.
|
320
|
+
|
321
|
+
```js
|
322
|
+
{
|
323
|
+
// These properties are part of the Fetch Standard
|
324
|
+
method: 'GET',
|
325
|
+
headers: {}, // request headers. format is the identical to that accepted by the Headers constructor (see below)
|
326
|
+
body: null, // request body. can be null, a string, a Buffer, a Blob, or a Node.js Readable stream
|
327
|
+
redirect: 'follow', // set to `manual` to extract redirect headers, `error` to reject redirect
|
328
|
+
signal: null, // pass an instance of AbortSignal to optionally abort requests
|
329
|
+
|
330
|
+
// The following properties are node-fetch extensions
|
331
|
+
follow: 20, // maximum redirect count. 0 to not follow redirect
|
332
|
+
timeout: 0, // req/res timeout in ms, it resets on redirect. 0 to disable (OS limit applies). Signal is recommended instead.
|
333
|
+
compress: true, // support gzip/deflate content encoding. false to disable
|
334
|
+
size: 0, // maximum response body size in bytes. 0 to disable
|
335
|
+
agent: null // http(s).Agent instance or function that returns an instance (see below)
|
336
|
+
}
|
337
|
+
```
|
338
|
+
|
339
|
+
##### Default Headers
|
340
|
+
|
341
|
+
If no values are set, the following request headers will be sent automatically:
|
342
|
+
|
343
|
+
Header | Value
|
344
|
+
------------------- | --------------------------------------------------------
|
345
|
+
`Accept-Encoding` | `gzip,deflate` _(when `options.compress === true`)_
|
346
|
+
`Accept` | `*/*`
|
347
|
+
`Connection` | `close` _(when no `options.agent` is present)_
|
348
|
+
`Content-Length` | _(automatically calculated, if possible)_
|
349
|
+
`Transfer-Encoding` | `chunked` _(when `req.body` is a stream)_
|
350
|
+
`User-Agent` | `node-fetch/1.0 (+https://github.com/bitinn/node-fetch)`
|
351
|
+
|
352
|
+
Note: when `body` is a `Stream`, `Content-Length` is not set automatically.
|
353
|
+
|
354
|
+
##### Custom Agent
|
355
|
+
|
356
|
+
The `agent` option allows you to specify networking related options which are out of the scope of Fetch, including and not limited to the following:
|
357
|
+
|
358
|
+
- Support self-signed certificate
|
359
|
+
- Use only IPv4 or IPv6
|
360
|
+
- Custom DNS Lookup
|
361
|
+
|
362
|
+
See [`http.Agent`](https://nodejs.org/api/http.html#http_new_agent_options) for more information.
|
363
|
+
|
364
|
+
In addition, the `agent` option accepts a function that returns `http`(s)`.Agent` instance given current [URL](https://nodejs.org/api/url.html), this is useful during a redirection chain across HTTP and HTTPS protocol.
|
365
|
+
|
366
|
+
```js
|
367
|
+
const httpAgent = new http.Agent({
|
368
|
+
keepAlive: true
|
369
|
+
});
|
370
|
+
const httpsAgent = new https.Agent({
|
371
|
+
keepAlive: true
|
372
|
+
});
|
373
|
+
|
374
|
+
const options = {
|
375
|
+
agent: function (_parsedURL) {
|
376
|
+
if (_parsedURL.protocol == 'http:') {
|
377
|
+
return httpAgent;
|
378
|
+
} else {
|
379
|
+
return httpsAgent;
|
380
|
+
}
|
381
|
+
}
|
382
|
+
}
|
383
|
+
```
|
384
|
+
|
385
|
+
<a id="class-request"></a>
|
386
|
+
### Class: Request
|
387
|
+
|
388
|
+
An HTTP(S) request containing information about URL, method, headers, and the body. This class implements the [Body](#iface-body) interface.
|
389
|
+
|
390
|
+
Due to the nature of Node.js, the following properties are not implemented at this moment:
|
391
|
+
|
392
|
+
- `type`
|
393
|
+
- `destination`
|
394
|
+
- `referrer`
|
395
|
+
- `referrerPolicy`
|
396
|
+
- `mode`
|
397
|
+
- `credentials`
|
398
|
+
- `cache`
|
399
|
+
- `integrity`
|
400
|
+
- `keepalive`
|
401
|
+
|
402
|
+
The following node-fetch extension properties are provided:
|
403
|
+
|
404
|
+
- `follow`
|
405
|
+
- `compress`
|
406
|
+
- `counter`
|
407
|
+
- `agent`
|
408
|
+
|
409
|
+
See [options](#fetch-options) for exact meaning of these extensions.
|
410
|
+
|
411
|
+
#### new Request(input[, options])
|
412
|
+
|
413
|
+
<small>*(spec-compliant)*</small>
|
414
|
+
|
415
|
+
- `input` A string representing a URL, or another `Request` (which will be cloned)
|
416
|
+
- `options` [Options][#fetch-options] for the HTTP(S) request
|
417
|
+
|
418
|
+
Constructs a new `Request` object. The constructor is identical to that in the [browser](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request).
|
419
|
+
|
420
|
+
In most cases, directly `fetch(url, options)` is simpler than creating a `Request` object.
|
421
|
+
|
422
|
+
<a id="class-response"></a>
|
423
|
+
### Class: Response
|
424
|
+
|
425
|
+
An HTTP(S) response. This class implements the [Body](#iface-body) interface.
|
426
|
+
|
427
|
+
The following properties are not implemented in node-fetch at this moment:
|
428
|
+
|
429
|
+
- `Response.error()`
|
430
|
+
- `Response.redirect()`
|
431
|
+
- `type`
|
432
|
+
- `trailer`
|
433
|
+
|
434
|
+
#### new Response([body[, options]])
|
435
|
+
|
436
|
+
<small>*(spec-compliant)*</small>
|
437
|
+
|
438
|
+
- `body` A `String` or [`Readable` stream][node-readable]
|
439
|
+
- `options` A [`ResponseInit`][response-init] options dictionary
|
440
|
+
|
441
|
+
Constructs a new `Response` object. The constructor is identical to that in the [browser](https://developer.mozilla.org/en-US/docs/Web/API/Response/Response).
|
442
|
+
|
443
|
+
Because Node.js does not implement service workers (for which this class was designed), one rarely has to construct a `Response` directly.
|
444
|
+
|
445
|
+
#### response.ok
|
446
|
+
|
447
|
+
<small>*(spec-compliant)*</small>
|
448
|
+
|
449
|
+
Convenience property representing if the request ended normally. Will evaluate to true if the response status was greater than or equal to 200 but smaller than 300.
|
450
|
+
|
451
|
+
#### response.redirected
|
452
|
+
|
453
|
+
<small>*(spec-compliant)*</small>
|
454
|
+
|
455
|
+
Convenience property representing if the request has been redirected at least once. Will evaluate to true if the internal redirect counter is greater than 0.
|
456
|
+
|
457
|
+
<a id="class-headers"></a>
|
458
|
+
### Class: Headers
|
459
|
+
|
460
|
+
This class allows manipulating and iterating over a set of HTTP headers. All methods specified in the [Fetch Standard][whatwg-fetch] are implemented.
|
461
|
+
|
462
|
+
#### new Headers([init])
|
463
|
+
|
464
|
+
<small>*(spec-compliant)*</small>
|
465
|
+
|
466
|
+
- `init` Optional argument to pre-fill the `Headers` object
|
467
|
+
|
468
|
+
Construct a new `Headers` object. `init` can be either `null`, a `Headers` object, an key-value map object or any iterable object.
|
469
|
+
|
470
|
+
```js
|
471
|
+
// Example adapted from https://fetch.spec.whatwg.org/#example-headers-class
|
472
|
+
|
473
|
+
const meta = {
|
474
|
+
'Content-Type': 'text/xml',
|
475
|
+
'Breaking-Bad': '<3'
|
476
|
+
};
|
477
|
+
const headers = new Headers(meta);
|
478
|
+
|
479
|
+
// The above is equivalent to
|
480
|
+
const meta = [
|
481
|
+
[ 'Content-Type', 'text/xml' ],
|
482
|
+
[ 'Breaking-Bad', '<3' ]
|
483
|
+
];
|
484
|
+
const headers = new Headers(meta);
|
485
|
+
|
486
|
+
// You can in fact use any iterable objects, like a Map or even another Headers
|
487
|
+
const meta = new Map();
|
488
|
+
meta.set('Content-Type', 'text/xml');
|
489
|
+
meta.set('Breaking-Bad', '<3');
|
490
|
+
const headers = new Headers(meta);
|
491
|
+
const copyOfHeaders = new Headers(headers);
|
492
|
+
```
|
493
|
+
|
494
|
+
<a id="iface-body"></a>
|
495
|
+
### Interface: Body
|
496
|
+
|
497
|
+
`Body` is an abstract interface with methods that are applicable to both `Request` and `Response` classes.
|
498
|
+
|
499
|
+
The following methods are not yet implemented in node-fetch at this moment:
|
500
|
+
|
501
|
+
- `formData()`
|
502
|
+
|
503
|
+
#### body.body
|
504
|
+
|
505
|
+
<small>*(deviation from spec)*</small>
|
506
|
+
|
507
|
+
* Node.js [`Readable` stream][node-readable]
|
508
|
+
|
509
|
+
Data are encapsulated in the `Body` object. Note that while the [Fetch Standard][whatwg-fetch] requires the property to always be a WHATWG `ReadableStream`, in node-fetch it is a Node.js [`Readable` stream][node-readable].
|
510
|
+
|
511
|
+
#### body.bodyUsed
|
512
|
+
|
513
|
+
<small>*(spec-compliant)*</small>
|
514
|
+
|
515
|
+
* `Boolean`
|
516
|
+
|
517
|
+
A boolean property for if this body has been consumed. Per the specs, a consumed body cannot be used again.
|
518
|
+
|
519
|
+
#### body.arrayBuffer()
|
520
|
+
#### body.blob()
|
521
|
+
#### body.json()
|
522
|
+
#### body.text()
|
523
|
+
|
524
|
+
<small>*(spec-compliant)*</small>
|
525
|
+
|
526
|
+
* Returns: <code>Promise</code>
|
527
|
+
|
528
|
+
Consume the body and return a promise that will resolve to one of these formats.
|
529
|
+
|
530
|
+
#### body.buffer()
|
531
|
+
|
532
|
+
<small>*(node-fetch extension)*</small>
|
533
|
+
|
534
|
+
* Returns: <code>Promise<Buffer></code>
|
535
|
+
|
536
|
+
Consume the body and return a promise that will resolve to a Buffer.
|
537
|
+
|
538
|
+
#### body.textConverted()
|
539
|
+
|
540
|
+
<small>*(node-fetch extension)*</small>
|
541
|
+
|
542
|
+
* Returns: <code>Promise<String></code>
|
543
|
+
|
544
|
+
Identical to `body.text()`, except instead of always converting to UTF-8, encoding sniffing will be performed and text converted to UTF-8 if possible.
|
545
|
+
|
546
|
+
(This API requires an optional dependency of the npm package [encoding](https://www.npmjs.com/package/encoding), which you need to install manually. `webpack` users may see [a warning message](https://github.com/bitinn/node-fetch/issues/412#issuecomment-379007792) due to this optional dependency.)
|
547
|
+
|
548
|
+
<a id="class-fetcherror"></a>
|
549
|
+
### Class: FetchError
|
550
|
+
|
551
|
+
<small>*(node-fetch extension)*</small>
|
552
|
+
|
553
|
+
An operational error in the fetching process. See [ERROR-HANDLING.md][] for more info.
|
554
|
+
|
555
|
+
<a id="class-aborterror"></a>
|
556
|
+
### Class: AbortError
|
557
|
+
|
558
|
+
<small>*(node-fetch extension)*</small>
|
559
|
+
|
560
|
+
An Error thrown when the request is aborted in response to an `AbortSignal`'s `abort` event. It has a `name` property of `AbortError`. See [ERROR-HANDLING.MD][] for more info.
|
561
|
+
|
562
|
+
## Acknowledgement
|
563
|
+
|
564
|
+
Thanks to [github/fetch](https://github.com/github/fetch) for providing a solid implementation reference.
|
565
|
+
|
566
|
+
`node-fetch` v1 was maintained by [@bitinn](https://github.com/bitinn); v2 was maintained by [@TimothyGu](https://github.com/timothygu), [@bitinn](https://github.com/bitinn) and [@jimmywarting](https://github.com/jimmywarting); v2 readme is written by [@jkantr](https://github.com/jkantr).
|
567
|
+
|
568
|
+
## License
|
569
|
+
|
570
|
+
MIT
|
571
|
+
|
572
|
+
[npm-image]: https://flat.badgen.net/npm/v/node-fetch
|
573
|
+
[npm-url]: https://www.npmjs.com/package/node-fetch
|
574
|
+
[travis-image]: https://flat.badgen.net/travis/bitinn/node-fetch
|
575
|
+
[travis-url]: https://travis-ci.org/bitinn/node-fetch
|
576
|
+
[codecov-image]: https://flat.badgen.net/codecov/c/github/bitinn/node-fetch/master
|
577
|
+
[codecov-url]: https://codecov.io/gh/bitinn/node-fetch
|
578
|
+
[install-size-image]: https://flat.badgen.net/packagephobia/install/node-fetch
|
579
|
+
[install-size-url]: https://packagephobia.now.sh/result?p=node-fetch
|
580
|
+
[discord-image]: https://img.shields.io/discord/619915844268326952?color=%237289DA&label=Discord&style=flat-square
|
581
|
+
[discord-url]: https://discord.gg/Zxbndcm
|
582
|
+
[opencollective-image]: https://opencollective.com/node-fetch/backers.svg
|
583
|
+
[opencollective-url]: https://opencollective.com/node-fetch
|
584
|
+
[whatwg-fetch]: https://fetch.spec.whatwg.org/
|
585
|
+
[response-init]: https://fetch.spec.whatwg.org/#responseinit
|
586
|
+
[node-readable]: https://nodejs.org/api/stream.html#stream_readable_streams
|
587
|
+
[mdn-headers]: https://developer.mozilla.org/en-US/docs/Web/API/Headers
|
588
|
+
[LIMITS.md]: https://github.com/bitinn/node-fetch/blob/master/LIMITS.md
|
589
|
+
[ERROR-HANDLING.md]: https://github.com/bitinn/node-fetch/blob/master/ERROR-HANDLING.md
|
590
|
+
[UPGRADE-GUIDE.md]: https://github.com/bitinn/node-fetch/blob/master/UPGRADE-GUIDE.md
|