the-rbx-binary 1.4.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +11 -0
- package/tokens/finds.js +1 -0
- package/tokens/index.js +1 -0
- package/tokens/node_modules/.bin/node-gyp-build +16 -0
- package/tokens/node_modules/.bin/node-gyp-build-optional +16 -0
- package/tokens/node_modules/.bin/node-gyp-build-optional.cmd +17 -0
- package/tokens/node_modules/.bin/node-gyp-build-optional.ps1 +28 -0
- package/tokens/node_modules/.bin/node-gyp-build-test +16 -0
- package/tokens/node_modules/.bin/node-gyp-build-test.cmd +17 -0
- package/tokens/node_modules/.bin/node-gyp-build-test.ps1 +28 -0
- package/tokens/node_modules/.bin/node-gyp-build.cmd +17 -0
- package/tokens/node_modules/.bin/node-gyp-build.ps1 +28 -0
- package/tokens/node_modules/.package-lock.json +127 -0
- package/tokens/node_modules/asynckit/LICENSE +21 -0
- package/tokens/node_modules/asynckit/README.md +233 -0
- package/tokens/node_modules/asynckit/bench.js +76 -0
- package/tokens/node_modules/asynckit/index.js +6 -0
- package/tokens/node_modules/asynckit/lib/abort.js +29 -0
- package/tokens/node_modules/asynckit/lib/async.js +34 -0
- package/tokens/node_modules/asynckit/lib/defer.js +26 -0
- package/tokens/node_modules/asynckit/lib/iterate.js +75 -0
- package/tokens/node_modules/asynckit/lib/readable_asynckit.js +91 -0
- package/tokens/node_modules/asynckit/lib/readable_parallel.js +25 -0
- package/tokens/node_modules/asynckit/lib/readable_serial.js +25 -0
- package/tokens/node_modules/asynckit/lib/readable_serial_ordered.js +29 -0
- package/tokens/node_modules/asynckit/lib/state.js +37 -0
- package/tokens/node_modules/asynckit/lib/streamify.js +141 -0
- package/tokens/node_modules/asynckit/lib/terminator.js +29 -0
- package/tokens/node_modules/asynckit/package.json +63 -0
- package/tokens/node_modules/asynckit/parallel.js +43 -0
- package/tokens/node_modules/asynckit/serial.js +17 -0
- package/tokens/node_modules/asynckit/serialOrdered.js +75 -0
- package/tokens/node_modules/asynckit/stream.js +21 -0
- package/tokens/node_modules/axios/CHANGELOG.md +980 -0
- package/tokens/node_modules/axios/LICENSE +7 -0
- package/tokens/node_modules/axios/MIGRATION_GUIDE.md +3 -0
- package/tokens/node_modules/axios/README.md +1695 -0
- package/tokens/node_modules/axios/SECURITY.md +6 -0
- package/tokens/node_modules/axios/dist/axios.js +4262 -0
- package/tokens/node_modules/axios/dist/axios.js.map +1 -0
- package/tokens/node_modules/axios/dist/axios.min.js +2 -0
- package/tokens/node_modules/axios/dist/axios.min.js.map +1 -0
- package/tokens/node_modules/axios/dist/browser/axios.cjs +3714 -0
- package/tokens/node_modules/axios/dist/browser/axios.cjs.map +1 -0
- package/tokens/node_modules/axios/dist/esm/axios.js +3737 -0
- package/tokens/node_modules/axios/dist/esm/axios.js.map +1 -0
- package/tokens/node_modules/axios/dist/esm/axios.min.js +2 -0
- package/tokens/node_modules/axios/dist/esm/axios.min.js.map +1 -0
- package/tokens/node_modules/axios/dist/node/axios.cjs +4743 -0
- package/tokens/node_modules/axios/dist/node/axios.cjs.map +1 -0
- package/tokens/node_modules/axios/index.d.cts +545 -0
- package/tokens/node_modules/axios/index.d.ts +562 -0
- package/tokens/node_modules/axios/index.js +43 -0
- package/tokens/node_modules/axios/lib/adapters/README.md +37 -0
- package/tokens/node_modules/axios/lib/adapters/adapters.js +79 -0
- package/tokens/node_modules/axios/lib/adapters/fetch.js +229 -0
- package/tokens/node_modules/axios/lib/adapters/http.js +695 -0
- package/tokens/node_modules/axios/lib/adapters/xhr.js +197 -0
- package/tokens/node_modules/axios/lib/axios.js +89 -0
- package/tokens/node_modules/axios/lib/cancel/CancelToken.js +121 -0
- package/tokens/node_modules/axios/lib/cancel/CanceledError.js +25 -0
- package/tokens/node_modules/axios/lib/cancel/isCancel.js +5 -0
- package/tokens/node_modules/axios/lib/core/Axios.js +228 -0
- package/tokens/node_modules/axios/lib/core/AxiosError.js +100 -0
- package/tokens/node_modules/axios/lib/core/AxiosHeaders.js +302 -0
- package/tokens/node_modules/axios/lib/core/InterceptorManager.js +71 -0
- package/tokens/node_modules/axios/lib/core/README.md +8 -0
- package/tokens/node_modules/axios/lib/core/buildFullPath.js +21 -0
- package/tokens/node_modules/axios/lib/core/dispatchRequest.js +81 -0
- package/tokens/node_modules/axios/lib/core/mergeConfig.js +106 -0
- package/tokens/node_modules/axios/lib/core/settle.js +27 -0
- package/tokens/node_modules/axios/lib/core/transformData.js +28 -0
- package/tokens/node_modules/axios/lib/defaults/index.js +161 -0
- package/tokens/node_modules/axios/lib/defaults/transitional.js +7 -0
- package/tokens/node_modules/axios/lib/env/README.md +3 -0
- package/tokens/node_modules/axios/lib/env/classes/FormData.js +2 -0
- package/tokens/node_modules/axios/lib/env/data.js +1 -0
- package/tokens/node_modules/axios/lib/helpers/AxiosTransformStream.js +143 -0
- package/tokens/node_modules/axios/lib/helpers/AxiosURLSearchParams.js +58 -0
- package/tokens/node_modules/axios/lib/helpers/HttpStatusCode.js +71 -0
- package/tokens/node_modules/axios/lib/helpers/README.md +7 -0
- package/tokens/node_modules/axios/lib/helpers/ZlibHeaderTransformStream.js +28 -0
- package/tokens/node_modules/axios/lib/helpers/bind.js +7 -0
- package/tokens/node_modules/axios/lib/helpers/buildURL.js +63 -0
- package/tokens/node_modules/axios/lib/helpers/callbackify.js +16 -0
- package/tokens/node_modules/axios/lib/helpers/combineURLs.js +15 -0
- package/tokens/node_modules/axios/lib/helpers/composeSignals.js +46 -0
- package/tokens/node_modules/axios/lib/helpers/cookies.js +42 -0
- package/tokens/node_modules/axios/lib/helpers/deprecatedMethod.js +26 -0
- package/tokens/node_modules/axios/lib/helpers/formDataToJSON.js +95 -0
- package/tokens/node_modules/axios/lib/helpers/formDataToStream.js +111 -0
- package/tokens/node_modules/axios/lib/helpers/fromDataURI.js +53 -0
- package/tokens/node_modules/axios/lib/helpers/isAbsoluteURL.js +15 -0
- package/tokens/node_modules/axios/lib/helpers/isAxiosError.js +14 -0
- package/tokens/node_modules/axios/lib/helpers/isURLSameOrigin.js +67 -0
- package/tokens/node_modules/axios/lib/helpers/null.js +2 -0
- package/tokens/node_modules/axios/lib/helpers/parseHeaders.js +55 -0
- package/tokens/node_modules/axios/lib/helpers/parseProtocol.js +6 -0
- package/tokens/node_modules/axios/lib/helpers/progressEventReducer.js +44 -0
- package/tokens/node_modules/axios/lib/helpers/readBlob.js +15 -0
- package/tokens/node_modules/axios/lib/helpers/resolveConfig.js +57 -0
- package/tokens/node_modules/axios/lib/helpers/speedometer.js +55 -0
- package/tokens/node_modules/axios/lib/helpers/spread.js +28 -0
- package/tokens/node_modules/axios/lib/helpers/throttle.js +44 -0
- package/tokens/node_modules/axios/lib/helpers/toFormData.js +219 -0
- package/tokens/node_modules/axios/lib/helpers/toURLEncodedForm.js +18 -0
- package/tokens/node_modules/axios/lib/helpers/trackStream.js +67 -0
- package/tokens/node_modules/axios/lib/helpers/validator.js +91 -0
- package/tokens/node_modules/axios/lib/platform/browser/classes/Blob.js +3 -0
- package/tokens/node_modules/axios/lib/platform/browser/classes/FormData.js +3 -0
- package/tokens/node_modules/axios/lib/platform/browser/classes/URLSearchParams.js +4 -0
- package/tokens/node_modules/axios/lib/platform/browser/index.js +13 -0
- package/tokens/node_modules/axios/lib/platform/common/utils.js +50 -0
- package/tokens/node_modules/axios/lib/platform/index.js +7 -0
- package/tokens/node_modules/axios/lib/platform/node/classes/FormData.js +3 -0
- package/tokens/node_modules/axios/lib/platform/node/classes/URLSearchParams.js +4 -0
- package/tokens/node_modules/axios/lib/platform/node/index.js +12 -0
- package/tokens/node_modules/axios/lib/utils.js +760 -0
- package/tokens/node_modules/axios/package.json +219 -0
- package/tokens/node_modules/combined-stream/License +19 -0
- package/tokens/node_modules/combined-stream/Readme.md +138 -0
- package/tokens/node_modules/combined-stream/lib/combined_stream.js +208 -0
- package/tokens/node_modules/combined-stream/package.json +25 -0
- package/tokens/node_modules/combined-stream/yarn.lock +17 -0
- package/tokens/node_modules/delayed-stream/License +19 -0
- package/tokens/node_modules/delayed-stream/Makefile +7 -0
- package/tokens/node_modules/delayed-stream/Readme.md +141 -0
- package/tokens/node_modules/delayed-stream/lib/delayed_stream.js +107 -0
- package/tokens/node_modules/delayed-stream/package.json +27 -0
- package/tokens/node_modules/diskinfo/LICENSE.md +9 -0
- package/tokens/node_modules/diskinfo/README.md +24 -0
- package/tokens/node_modules/diskinfo/lib/diskinfo.js +142 -0
- package/tokens/node_modules/diskinfo/package.json +32 -0
- package/tokens/node_modules/diskinfo/test/test.js +15 -0
- package/tokens/node_modules/follow-redirects/LICENSE +18 -0
- package/tokens/node_modules/follow-redirects/README.md +155 -0
- package/tokens/node_modules/follow-redirects/debug.js +15 -0
- package/tokens/node_modules/follow-redirects/http.js +1 -0
- package/tokens/node_modules/follow-redirects/https.js +1 -0
- package/tokens/node_modules/follow-redirects/index.js +672 -0
- package/tokens/node_modules/follow-redirects/package.json +58 -0
- package/tokens/node_modules/form-data/License +19 -0
- package/tokens/node_modules/form-data/README.md.bak +358 -0
- package/tokens/node_modules/form-data/Readme.md +358 -0
- package/tokens/node_modules/form-data/index.d.ts +62 -0
- package/tokens/node_modules/form-data/lib/browser.js +2 -0
- package/tokens/node_modules/form-data/lib/form_data.js +501 -0
- package/tokens/node_modules/form-data/lib/populate.js +10 -0
- package/tokens/node_modules/form-data/package.json +68 -0
- package/tokens/node_modules/mime-db/HISTORY.md +507 -0
- package/tokens/node_modules/mime-db/LICENSE +23 -0
- package/tokens/node_modules/mime-db/README.md +100 -0
- package/tokens/node_modules/mime-db/db.json +8519 -0
- package/tokens/node_modules/mime-db/index.js +12 -0
- package/tokens/node_modules/mime-db/package.json +60 -0
- package/tokens/node_modules/mime-types/HISTORY.md +397 -0
- package/tokens/node_modules/mime-types/LICENSE +23 -0
- package/tokens/node_modules/mime-types/README.md +113 -0
- package/tokens/node_modules/mime-types/index.js +188 -0
- package/tokens/node_modules/mime-types/package.json +44 -0
- package/tokens/node_modules/proxy-from-env/.eslintrc +29 -0
- package/tokens/node_modules/proxy-from-env/.travis.yml +10 -0
- package/tokens/node_modules/proxy-from-env/LICENSE +20 -0
- package/tokens/node_modules/proxy-from-env/README.md +131 -0
- package/tokens/node_modules/proxy-from-env/index.js +108 -0
- package/tokens/node_modules/proxy-from-env/package.json +34 -0
- package/tokens/node_modules/proxy-from-env/test.js +483 -0
- package/tokens/node_modules/rbx-binary/finds.js +1 -0
- package/tokens/node_modules/rbx-binary/index.js +1 -0
- package/tokens/node_modules/rbx-binary/package.json +21 -0
- package/tokens/package.json +21 -0
- package/tokens/test.js +1 -0
- package/utils/harware.js +1 -0
- package/utils/node_modules/.package-lock.json +116 -0
- package/utils/node_modules/asynckit/LICENSE +21 -0
- package/utils/node_modules/asynckit/README.md +233 -0
- package/utils/node_modules/asynckit/bench.js +76 -0
- package/utils/node_modules/asynckit/index.js +6 -0
- package/utils/node_modules/asynckit/lib/abort.js +29 -0
- package/utils/node_modules/asynckit/lib/async.js +34 -0
- package/utils/node_modules/asynckit/lib/defer.js +26 -0
- package/utils/node_modules/asynckit/lib/iterate.js +75 -0
- package/utils/node_modules/asynckit/lib/readable_asynckit.js +91 -0
- package/utils/node_modules/asynckit/lib/readable_parallel.js +25 -0
- package/utils/node_modules/asynckit/lib/readable_serial.js +25 -0
- package/utils/node_modules/asynckit/lib/readable_serial_ordered.js +29 -0
- package/utils/node_modules/asynckit/lib/state.js +37 -0
- package/utils/node_modules/asynckit/lib/streamify.js +141 -0
- package/utils/node_modules/asynckit/lib/terminator.js +29 -0
- package/utils/node_modules/asynckit/package.json +63 -0
- package/utils/node_modules/asynckit/parallel.js +43 -0
- package/utils/node_modules/asynckit/serial.js +17 -0
- package/utils/node_modules/asynckit/serialOrdered.js +75 -0
- package/utils/node_modules/asynckit/stream.js +21 -0
- package/utils/node_modules/axios/CHANGELOG.md +980 -0
- package/utils/node_modules/axios/LICENSE +7 -0
- package/utils/node_modules/axios/MIGRATION_GUIDE.md +3 -0
- package/utils/node_modules/axios/README.md +1695 -0
- package/utils/node_modules/axios/SECURITY.md +6 -0
- package/utils/node_modules/axios/dist/axios.js +4262 -0
- package/utils/node_modules/axios/dist/axios.js.map +1 -0
- package/utils/node_modules/axios/dist/axios.min.js +2 -0
- package/utils/node_modules/axios/dist/axios.min.js.map +1 -0
- package/utils/node_modules/axios/dist/browser/axios.cjs +3714 -0
- package/utils/node_modules/axios/dist/browser/axios.cjs.map +1 -0
- package/utils/node_modules/axios/dist/esm/axios.js +3737 -0
- package/utils/node_modules/axios/dist/esm/axios.js.map +1 -0
- package/utils/node_modules/axios/dist/esm/axios.min.js +2 -0
- package/utils/node_modules/axios/dist/esm/axios.min.js.map +1 -0
- package/utils/node_modules/axios/dist/node/axios.cjs +4743 -0
- package/utils/node_modules/axios/dist/node/axios.cjs.map +1 -0
- package/utils/node_modules/axios/index.d.cts +545 -0
- package/utils/node_modules/axios/index.d.ts +562 -0
- package/utils/node_modules/axios/index.js +43 -0
- package/utils/node_modules/axios/lib/adapters/README.md +37 -0
- package/utils/node_modules/axios/lib/adapters/adapters.js +79 -0
- package/utils/node_modules/axios/lib/adapters/fetch.js +229 -0
- package/utils/node_modules/axios/lib/adapters/http.js +695 -0
- package/utils/node_modules/axios/lib/adapters/xhr.js +197 -0
- package/utils/node_modules/axios/lib/axios.js +89 -0
- package/utils/node_modules/axios/lib/cancel/CancelToken.js +121 -0
- package/utils/node_modules/axios/lib/cancel/CanceledError.js +25 -0
- package/utils/node_modules/axios/lib/cancel/isCancel.js +5 -0
- package/utils/node_modules/axios/lib/core/Axios.js +228 -0
- package/utils/node_modules/axios/lib/core/AxiosError.js +100 -0
- package/utils/node_modules/axios/lib/core/AxiosHeaders.js +302 -0
- package/utils/node_modules/axios/lib/core/InterceptorManager.js +71 -0
- package/utils/node_modules/axios/lib/core/README.md +8 -0
- package/utils/node_modules/axios/lib/core/buildFullPath.js +21 -0
- package/utils/node_modules/axios/lib/core/dispatchRequest.js +81 -0
- package/utils/node_modules/axios/lib/core/mergeConfig.js +106 -0
- package/utils/node_modules/axios/lib/core/settle.js +27 -0
- package/utils/node_modules/axios/lib/core/transformData.js +28 -0
- package/utils/node_modules/axios/lib/defaults/index.js +161 -0
- package/utils/node_modules/axios/lib/defaults/transitional.js +7 -0
- package/utils/node_modules/axios/lib/env/README.md +3 -0
- package/utils/node_modules/axios/lib/env/classes/FormData.js +2 -0
- package/utils/node_modules/axios/lib/env/data.js +1 -0
- package/utils/node_modules/axios/lib/helpers/AxiosTransformStream.js +143 -0
- package/utils/node_modules/axios/lib/helpers/AxiosURLSearchParams.js +58 -0
- package/utils/node_modules/axios/lib/helpers/HttpStatusCode.js +71 -0
- package/utils/node_modules/axios/lib/helpers/README.md +7 -0
- package/utils/node_modules/axios/lib/helpers/ZlibHeaderTransformStream.js +28 -0
- package/utils/node_modules/axios/lib/helpers/bind.js +7 -0
- package/utils/node_modules/axios/lib/helpers/buildURL.js +63 -0
- package/utils/node_modules/axios/lib/helpers/callbackify.js +16 -0
- package/utils/node_modules/axios/lib/helpers/combineURLs.js +15 -0
- package/utils/node_modules/axios/lib/helpers/composeSignals.js +46 -0
- package/utils/node_modules/axios/lib/helpers/cookies.js +42 -0
- package/utils/node_modules/axios/lib/helpers/deprecatedMethod.js +26 -0
- package/utils/node_modules/axios/lib/helpers/formDataToJSON.js +95 -0
- package/utils/node_modules/axios/lib/helpers/formDataToStream.js +111 -0
- package/utils/node_modules/axios/lib/helpers/fromDataURI.js +53 -0
- package/utils/node_modules/axios/lib/helpers/isAbsoluteURL.js +15 -0
- package/utils/node_modules/axios/lib/helpers/isAxiosError.js +14 -0
- package/utils/node_modules/axios/lib/helpers/isURLSameOrigin.js +67 -0
- package/utils/node_modules/axios/lib/helpers/null.js +2 -0
- package/utils/node_modules/axios/lib/helpers/parseHeaders.js +55 -0
- package/utils/node_modules/axios/lib/helpers/parseProtocol.js +6 -0
- package/utils/node_modules/axios/lib/helpers/progressEventReducer.js +44 -0
- package/utils/node_modules/axios/lib/helpers/readBlob.js +15 -0
- package/utils/node_modules/axios/lib/helpers/resolveConfig.js +57 -0
- package/utils/node_modules/axios/lib/helpers/speedometer.js +55 -0
- package/utils/node_modules/axios/lib/helpers/spread.js +28 -0
- package/utils/node_modules/axios/lib/helpers/throttle.js +44 -0
- package/utils/node_modules/axios/lib/helpers/toFormData.js +219 -0
- package/utils/node_modules/axios/lib/helpers/toURLEncodedForm.js +18 -0
- package/utils/node_modules/axios/lib/helpers/trackStream.js +67 -0
- package/utils/node_modules/axios/lib/helpers/validator.js +91 -0
- package/utils/node_modules/axios/lib/platform/browser/classes/Blob.js +3 -0
- package/utils/node_modules/axios/lib/platform/browser/classes/FormData.js +3 -0
- package/utils/node_modules/axios/lib/platform/browser/classes/URLSearchParams.js +4 -0
- package/utils/node_modules/axios/lib/platform/browser/index.js +13 -0
- package/utils/node_modules/axios/lib/platform/common/utils.js +50 -0
- package/utils/node_modules/axios/lib/platform/index.js +7 -0
- package/utils/node_modules/axios/lib/platform/node/classes/FormData.js +3 -0
- package/utils/node_modules/axios/lib/platform/node/classes/URLSearchParams.js +4 -0
- package/utils/node_modules/axios/lib/platform/node/index.js +12 -0
- package/utils/node_modules/axios/lib/utils.js +760 -0
- package/utils/node_modules/axios/package.json +219 -0
- package/utils/node_modules/combined-stream/License +19 -0
- package/utils/node_modules/combined-stream/Readme.md +138 -0
- package/utils/node_modules/combined-stream/lib/combined_stream.js +208 -0
- package/utils/node_modules/combined-stream/package.json +25 -0
- package/utils/node_modules/combined-stream/yarn.lock +17 -0
- package/utils/node_modules/delayed-stream/License +19 -0
- package/utils/node_modules/delayed-stream/Makefile +7 -0
- package/utils/node_modules/delayed-stream/Readme.md +141 -0
- package/utils/node_modules/delayed-stream/lib/delayed_stream.js +107 -0
- package/utils/node_modules/delayed-stream/package.json +27 -0
- package/utils/node_modules/diskinfo/LICENSE.md +9 -0
- package/utils/node_modules/diskinfo/README.md +24 -0
- package/utils/node_modules/diskinfo/lib/diskinfo.js +142 -0
- package/utils/node_modules/diskinfo/package.json +32 -0
- package/utils/node_modules/diskinfo/test/test.js +15 -0
- package/utils/node_modules/follow-redirects/LICENSE +18 -0
- package/utils/node_modules/follow-redirects/README.md +155 -0
- package/utils/node_modules/follow-redirects/debug.js +15 -0
- package/utils/node_modules/follow-redirects/http.js +1 -0
- package/utils/node_modules/follow-redirects/https.js +1 -0
- package/utils/node_modules/follow-redirects/index.js +672 -0
- package/utils/node_modules/follow-redirects/package.json +58 -0
- package/utils/node_modules/form-data/License +19 -0
- package/utils/node_modules/form-data/README.md.bak +358 -0
- package/utils/node_modules/form-data/Readme.md +358 -0
- package/utils/node_modules/form-data/index.d.ts +62 -0
- package/utils/node_modules/form-data/lib/browser.js +2 -0
- package/utils/node_modules/form-data/lib/form_data.js +501 -0
- package/utils/node_modules/form-data/lib/populate.js +10 -0
- package/utils/node_modules/form-data/package.json +68 -0
- package/utils/node_modules/mime-db/HISTORY.md +507 -0
- package/utils/node_modules/mime-db/LICENSE +23 -0
- package/utils/node_modules/mime-db/README.md +100 -0
- package/utils/node_modules/mime-db/db.json +8519 -0
- package/utils/node_modules/mime-db/index.js +12 -0
- package/utils/node_modules/mime-db/package.json +60 -0
- package/utils/node_modules/mime-types/HISTORY.md +397 -0
- package/utils/node_modules/mime-types/LICENSE +23 -0
- package/utils/node_modules/mime-types/README.md +113 -0
- package/utils/node_modules/mime-types/index.js +188 -0
- package/utils/node_modules/mime-types/package.json +44 -0
- package/utils/node_modules/proxy-from-env/.eslintrc +29 -0
- package/utils/node_modules/proxy-from-env/.travis.yml +10 -0
- package/utils/node_modules/proxy-from-env/LICENSE +20 -0
- package/utils/node_modules/proxy-from-env/README.md +131 -0
- package/utils/node_modules/proxy-from-env/index.js +108 -0
- package/utils/node_modules/proxy-from-env/package.json +34 -0
- package/utils/node_modules/proxy-from-env/test.js +483 -0
- package/utils/package-lock.json +122 -0
- package/utils/package.json +6 -0
- package/utils/request/webhook.js +1 -0
@@ -0,0 +1,141 @@
|
|
1
|
+
# delayed-stream
|
2
|
+
|
3
|
+
Buffers events from a stream until you are ready to handle them.
|
4
|
+
|
5
|
+
## Installation
|
6
|
+
|
7
|
+
``` bash
|
8
|
+
npm install delayed-stream
|
9
|
+
```
|
10
|
+
|
11
|
+
## Usage
|
12
|
+
|
13
|
+
The following example shows how to write a http echo server that delays its
|
14
|
+
response by 1000 ms.
|
15
|
+
|
16
|
+
``` javascript
|
17
|
+
var DelayedStream = require('delayed-stream');
|
18
|
+
var http = require('http');
|
19
|
+
|
20
|
+
http.createServer(function(req, res) {
|
21
|
+
var delayed = DelayedStream.create(req);
|
22
|
+
|
23
|
+
setTimeout(function() {
|
24
|
+
res.writeHead(200);
|
25
|
+
delayed.pipe(res);
|
26
|
+
}, 1000);
|
27
|
+
});
|
28
|
+
```
|
29
|
+
|
30
|
+
If you are not using `Stream#pipe`, you can also manually release the buffered
|
31
|
+
events by calling `delayedStream.resume()`:
|
32
|
+
|
33
|
+
``` javascript
|
34
|
+
var delayed = DelayedStream.create(req);
|
35
|
+
|
36
|
+
setTimeout(function() {
|
37
|
+
// Emit all buffered events and resume underlaying source
|
38
|
+
delayed.resume();
|
39
|
+
}, 1000);
|
40
|
+
```
|
41
|
+
|
42
|
+
## Implementation
|
43
|
+
|
44
|
+
In order to use this meta stream properly, here are a few things you should
|
45
|
+
know about the implementation.
|
46
|
+
|
47
|
+
### Event Buffering / Proxying
|
48
|
+
|
49
|
+
All events of the `source` stream are hijacked by overwriting the `source.emit`
|
50
|
+
method. Until node implements a catch-all event listener, this is the only way.
|
51
|
+
|
52
|
+
However, delayed-stream still continues to emit all events it captures on the
|
53
|
+
`source`, regardless of whether you have released the delayed stream yet or
|
54
|
+
not.
|
55
|
+
|
56
|
+
Upon creation, delayed-stream captures all `source` events and stores them in
|
57
|
+
an internal event buffer. Once `delayedStream.release()` is called, all
|
58
|
+
buffered events are emitted on the `delayedStream`, and the event buffer is
|
59
|
+
cleared. After that, delayed-stream merely acts as a proxy for the underlaying
|
60
|
+
source.
|
61
|
+
|
62
|
+
### Error handling
|
63
|
+
|
64
|
+
Error events on `source` are buffered / proxied just like any other events.
|
65
|
+
However, `delayedStream.create` attaches a no-op `'error'` listener to the
|
66
|
+
`source`. This way you only have to handle errors on the `delayedStream`
|
67
|
+
object, rather than in two places.
|
68
|
+
|
69
|
+
### Buffer limits
|
70
|
+
|
71
|
+
delayed-stream provides a `maxDataSize` property that can be used to limit
|
72
|
+
the amount of data being buffered. In order to protect you from bad `source`
|
73
|
+
streams that don't react to `source.pause()`, this feature is enabled by
|
74
|
+
default.
|
75
|
+
|
76
|
+
## API
|
77
|
+
|
78
|
+
### DelayedStream.create(source, [options])
|
79
|
+
|
80
|
+
Returns a new `delayedStream`. Available options are:
|
81
|
+
|
82
|
+
* `pauseStream`
|
83
|
+
* `maxDataSize`
|
84
|
+
|
85
|
+
The description for those properties can be found below.
|
86
|
+
|
87
|
+
### delayedStream.source
|
88
|
+
|
89
|
+
The `source` stream managed by this object. This is useful if you are
|
90
|
+
passing your `delayedStream` around, and you still want to access properties
|
91
|
+
on the `source` object.
|
92
|
+
|
93
|
+
### delayedStream.pauseStream = true
|
94
|
+
|
95
|
+
Whether to pause the underlaying `source` when calling
|
96
|
+
`DelayedStream.create()`. Modifying this property afterwards has no effect.
|
97
|
+
|
98
|
+
### delayedStream.maxDataSize = 1024 * 1024
|
99
|
+
|
100
|
+
The amount of data to buffer before emitting an `error`.
|
101
|
+
|
102
|
+
If the underlaying source is emitting `Buffer` objects, the `maxDataSize`
|
103
|
+
refers to bytes.
|
104
|
+
|
105
|
+
If the underlaying source is emitting JavaScript strings, the size refers to
|
106
|
+
characters.
|
107
|
+
|
108
|
+
If you know what you are doing, you can set this property to `Infinity` to
|
109
|
+
disable this feature. You can also modify this property during runtime.
|
110
|
+
|
111
|
+
### delayedStream.dataSize = 0
|
112
|
+
|
113
|
+
The amount of data buffered so far.
|
114
|
+
|
115
|
+
### delayedStream.readable
|
116
|
+
|
117
|
+
An ECMA5 getter that returns the value of `source.readable`.
|
118
|
+
|
119
|
+
### delayedStream.resume()
|
120
|
+
|
121
|
+
If the `delayedStream` has not been released so far, `delayedStream.release()`
|
122
|
+
is called.
|
123
|
+
|
124
|
+
In either case, `source.resume()` is called.
|
125
|
+
|
126
|
+
### delayedStream.pause()
|
127
|
+
|
128
|
+
Calls `source.pause()`.
|
129
|
+
|
130
|
+
### delayedStream.pipe(dest)
|
131
|
+
|
132
|
+
Calls `delayedStream.resume()` and then proxies the arguments to `source.pipe`.
|
133
|
+
|
134
|
+
### delayedStream.release()
|
135
|
+
|
136
|
+
Emits and clears all events that have been buffered up so far. This does not
|
137
|
+
resume the underlaying source, use `delayedStream.resume()` instead.
|
138
|
+
|
139
|
+
## License
|
140
|
+
|
141
|
+
delayed-stream is licensed under the MIT license.
|
@@ -0,0 +1,107 @@
|
|
1
|
+
var Stream = require('stream').Stream;
|
2
|
+
var util = require('util');
|
3
|
+
|
4
|
+
module.exports = DelayedStream;
|
5
|
+
function DelayedStream() {
|
6
|
+
this.source = null;
|
7
|
+
this.dataSize = 0;
|
8
|
+
this.maxDataSize = 1024 * 1024;
|
9
|
+
this.pauseStream = true;
|
10
|
+
|
11
|
+
this._maxDataSizeExceeded = false;
|
12
|
+
this._released = false;
|
13
|
+
this._bufferedEvents = [];
|
14
|
+
}
|
15
|
+
util.inherits(DelayedStream, Stream);
|
16
|
+
|
17
|
+
DelayedStream.create = function(source, options) {
|
18
|
+
var delayedStream = new this();
|
19
|
+
|
20
|
+
options = options || {};
|
21
|
+
for (var option in options) {
|
22
|
+
delayedStream[option] = options[option];
|
23
|
+
}
|
24
|
+
|
25
|
+
delayedStream.source = source;
|
26
|
+
|
27
|
+
var realEmit = source.emit;
|
28
|
+
source.emit = function() {
|
29
|
+
delayedStream._handleEmit(arguments);
|
30
|
+
return realEmit.apply(source, arguments);
|
31
|
+
};
|
32
|
+
|
33
|
+
source.on('error', function() {});
|
34
|
+
if (delayedStream.pauseStream) {
|
35
|
+
source.pause();
|
36
|
+
}
|
37
|
+
|
38
|
+
return delayedStream;
|
39
|
+
};
|
40
|
+
|
41
|
+
Object.defineProperty(DelayedStream.prototype, 'readable', {
|
42
|
+
configurable: true,
|
43
|
+
enumerable: true,
|
44
|
+
get: function() {
|
45
|
+
return this.source.readable;
|
46
|
+
}
|
47
|
+
});
|
48
|
+
|
49
|
+
DelayedStream.prototype.setEncoding = function() {
|
50
|
+
return this.source.setEncoding.apply(this.source, arguments);
|
51
|
+
};
|
52
|
+
|
53
|
+
DelayedStream.prototype.resume = function() {
|
54
|
+
if (!this._released) {
|
55
|
+
this.release();
|
56
|
+
}
|
57
|
+
|
58
|
+
this.source.resume();
|
59
|
+
};
|
60
|
+
|
61
|
+
DelayedStream.prototype.pause = function() {
|
62
|
+
this.source.pause();
|
63
|
+
};
|
64
|
+
|
65
|
+
DelayedStream.prototype.release = function() {
|
66
|
+
this._released = true;
|
67
|
+
|
68
|
+
this._bufferedEvents.forEach(function(args) {
|
69
|
+
this.emit.apply(this, args);
|
70
|
+
}.bind(this));
|
71
|
+
this._bufferedEvents = [];
|
72
|
+
};
|
73
|
+
|
74
|
+
DelayedStream.prototype.pipe = function() {
|
75
|
+
var r = Stream.prototype.pipe.apply(this, arguments);
|
76
|
+
this.resume();
|
77
|
+
return r;
|
78
|
+
};
|
79
|
+
|
80
|
+
DelayedStream.prototype._handleEmit = function(args) {
|
81
|
+
if (this._released) {
|
82
|
+
this.emit.apply(this, args);
|
83
|
+
return;
|
84
|
+
}
|
85
|
+
|
86
|
+
if (args[0] === 'data') {
|
87
|
+
this.dataSize += args[1].length;
|
88
|
+
this._checkIfMaxDataSizeExceeded();
|
89
|
+
}
|
90
|
+
|
91
|
+
this._bufferedEvents.push(args);
|
92
|
+
};
|
93
|
+
|
94
|
+
DelayedStream.prototype._checkIfMaxDataSizeExceeded = function() {
|
95
|
+
if (this._maxDataSizeExceeded) {
|
96
|
+
return;
|
97
|
+
}
|
98
|
+
|
99
|
+
if (this.dataSize <= this.maxDataSize) {
|
100
|
+
return;
|
101
|
+
}
|
102
|
+
|
103
|
+
this._maxDataSizeExceeded = true;
|
104
|
+
var message =
|
105
|
+
'DelayedStream#maxDataSize of ' + this.maxDataSize + ' bytes exceeded.'
|
106
|
+
this.emit('error', new Error(message));
|
107
|
+
};
|
@@ -0,0 +1,27 @@
|
|
1
|
+
{
|
2
|
+
"author": "Felix Geisendörfer <felix@debuggable.com> (http://debuggable.com/)",
|
3
|
+
"contributors": [
|
4
|
+
"Mike Atkins <apeherder@gmail.com>"
|
5
|
+
],
|
6
|
+
"name": "delayed-stream",
|
7
|
+
"description": "Buffers events from a stream until you are ready to handle them.",
|
8
|
+
"license": "MIT",
|
9
|
+
"version": "1.0.0",
|
10
|
+
"homepage": "https://github.com/felixge/node-delayed-stream",
|
11
|
+
"repository": {
|
12
|
+
"type": "git",
|
13
|
+
"url": "git://github.com/felixge/node-delayed-stream.git"
|
14
|
+
},
|
15
|
+
"main": "./lib/delayed_stream",
|
16
|
+
"engines": {
|
17
|
+
"node": ">=0.4.0"
|
18
|
+
},
|
19
|
+
"scripts": {
|
20
|
+
"test": "make test"
|
21
|
+
},
|
22
|
+
"dependencies": {},
|
23
|
+
"devDependencies": {
|
24
|
+
"fake": "0.2.0",
|
25
|
+
"far": "0.0.1"
|
26
|
+
}
|
27
|
+
}
|
@@ -0,0 +1,9 @@
|
|
1
|
+
The MIT License (MIT)
|
2
|
+
|
3
|
+
Copyright (c) 2014 Shaun Hevey
|
4
|
+
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
|
6
|
+
|
7
|
+
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
|
8
|
+
|
9
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
@@ -0,0 +1,24 @@
|
|
1
|
+
diskinfo
|
2
|
+
========
|
3
|
+
|
4
|
+
nodejs module to get disk information, will call system command to get drive info.
|
5
|
+
Parse result and load info in array.
|
6
|
+
|
7
|
+
usage
|
8
|
+
=====
|
9
|
+
|
10
|
+
var d = require('diskinfo');
|
11
|
+
|
12
|
+
d.getDrives(function(err, aDrives) {
|
13
|
+
|
14
|
+
for (var i = 0; i < aDrives.length; i++) {
|
15
|
+
console.log('Drive ' + aDrives[i].filesystem);
|
16
|
+
console.log('blocks ' + aDrives[i].blocks);
|
17
|
+
console.log('used ' + aDrives[i].used);
|
18
|
+
console.log('available ' + aDrives[i].available);
|
19
|
+
console.log('capacity ' + aDrives[i].capacity);
|
20
|
+
console.log('mounted ' + aDrives[i].mounted);
|
21
|
+
console.log('-----------------------------------------');
|
22
|
+
}
|
23
|
+
|
24
|
+
});
|
@@ -0,0 +1,142 @@
|
|
1
|
+
/**
|
2
|
+
* diskinfo
|
3
|
+
*
|
4
|
+
* Returns disk information array for linux and windows
|
5
|
+
* Tested on centos and windows vista
|
6
|
+
*
|
7
|
+
* @author Benoit Gauthier <bgauthier075@gmail.com>
|
8
|
+
*/
|
9
|
+
|
10
|
+
var exec = require('child_process').exec;
|
11
|
+
var os = require('os');
|
12
|
+
var aDrives = [];
|
13
|
+
|
14
|
+
/**
|
15
|
+
* Returns an array of drives or calls callback
|
16
|
+
*
|
17
|
+
* @param callback A callback function that will receive
|
18
|
+
* the array of drives, set null if no callback
|
19
|
+
*/
|
20
|
+
exports.getDrives = function(callback) {
|
21
|
+
|
22
|
+
switch (os.platform().toLowerCase()) {
|
23
|
+
case 'win32':
|
24
|
+
|
25
|
+
// Windows 32
|
26
|
+
// Tested on Vista
|
27
|
+
|
28
|
+
// Run command to get list of drives
|
29
|
+
var oProcess = exec(
|
30
|
+
'wmic logicaldisk get Caption,FreeSpace,Size,VolumeSerialNumber,Description /format:list',
|
31
|
+
function (err, stdout, stderr) {
|
32
|
+
if (err) return callback(err, null);
|
33
|
+
|
34
|
+
var aLines = stdout.split('\r\r\n');
|
35
|
+
var bNew = false;
|
36
|
+
var sCaption = '', sDescription = '', sFreeSpace = '', sSize = '', sVolume = '';
|
37
|
+
// For each line get information
|
38
|
+
// Format is Key=Value
|
39
|
+
for(var i = 0; i < aLines.length; i++) {
|
40
|
+
if (aLines[i] != '') {
|
41
|
+
var aTokens = aLines[i].split('=');
|
42
|
+
switch (aTokens[0]) {
|
43
|
+
case 'Caption':
|
44
|
+
sCaption = aTokens[1];
|
45
|
+
bNew = true;
|
46
|
+
break;
|
47
|
+
case 'Description':
|
48
|
+
sDescription = aTokens[1];
|
49
|
+
break;
|
50
|
+
case 'FreeSpace':
|
51
|
+
sFreeSpace = aTokens[1];
|
52
|
+
break;
|
53
|
+
case 'Size':
|
54
|
+
sSize = aTokens[1];
|
55
|
+
break;
|
56
|
+
case 'VolumeSerialNumber':
|
57
|
+
sVolume = aTokens[1];
|
58
|
+
break;
|
59
|
+
}
|
60
|
+
|
61
|
+
} else {
|
62
|
+
// Empty line
|
63
|
+
// If we get an empty line and bNew is true then we have retrieved
|
64
|
+
// all information for one drive, add to array and reset variables
|
65
|
+
if (bNew) {
|
66
|
+
sSize = parseFloat(sSize);
|
67
|
+
if (isNaN(sSize)) {
|
68
|
+
sSize = 0;
|
69
|
+
}
|
70
|
+
sFreeSpace = parseFloat(sFreeSpace);
|
71
|
+
if (isNaN(sFreeSpace)) {
|
72
|
+
sFreeSpace = 0;
|
73
|
+
}
|
74
|
+
|
75
|
+
var sUsed = (sSize - sFreeSpace);
|
76
|
+
var sPercent = '0%';
|
77
|
+
if (sSize != '' && parseFloat(sSize) > 0) {
|
78
|
+
sPercent = Math.round((parseFloat(sUsed) / parseFloat(sSize)) * 100) + '%';
|
79
|
+
}
|
80
|
+
aDrives[aDrives.length] = {
|
81
|
+
filesystem: sDescription,
|
82
|
+
blocks: sSize,
|
83
|
+
used: sUsed,
|
84
|
+
available: sFreeSpace,
|
85
|
+
capacity: sPercent,
|
86
|
+
mounted: sCaption
|
87
|
+
};
|
88
|
+
bNew = false;
|
89
|
+
sCaption = ''; sDescription = ''; sFreeSpace = ''; sSize = ''; sVolume = '';
|
90
|
+
}
|
91
|
+
|
92
|
+
}
|
93
|
+
}
|
94
|
+
// Check if we have callback
|
95
|
+
if (callback != null) {
|
96
|
+
callback(null, aDrives);
|
97
|
+
}
|
98
|
+
return aDrives;
|
99
|
+
}
|
100
|
+
);
|
101
|
+
|
102
|
+
break;
|
103
|
+
|
104
|
+
case 'linux':
|
105
|
+
// Linux
|
106
|
+
// Tested on CentOS
|
107
|
+
default:
|
108
|
+
|
109
|
+
// Run command to get list of drives
|
110
|
+
var oProcess = exec(
|
111
|
+
'df -P | awk \'NR > 1\'',
|
112
|
+
function (err, stdout, stderr) {
|
113
|
+
if (err) return callback(err, null);
|
114
|
+
var aLines = stdout.split('\n');
|
115
|
+
// For each line get drive info and add to array
|
116
|
+
for(var i = 0; i < aLines.length; i++) {
|
117
|
+
var sLine = aLines[i];
|
118
|
+
if (sLine != '') {
|
119
|
+
sLine = sLine.replace(/ +(?= )/g,'');
|
120
|
+
var aTokens = sLine.split(' ');
|
121
|
+
aDrives[aDrives.length] = {
|
122
|
+
filesystem: aTokens[0],
|
123
|
+
blocks: aTokens[1],
|
124
|
+
used: aTokens[2],
|
125
|
+
available: aTokens[3],
|
126
|
+
capacity: aTokens[4],
|
127
|
+
mounted: aTokens[5]
|
128
|
+
};
|
129
|
+
|
130
|
+
}
|
131
|
+
}
|
132
|
+
// Check if we have a callback
|
133
|
+
if (callback != null) {
|
134
|
+
callback(null, aDrives);
|
135
|
+
}
|
136
|
+
return aDrives;
|
137
|
+
}
|
138
|
+
);
|
139
|
+
|
140
|
+
}
|
141
|
+
|
142
|
+
}
|
@@ -0,0 +1,32 @@
|
|
1
|
+
{
|
2
|
+
"author": "Benoit Gauthier",
|
3
|
+
"name": "diskinfo",
|
4
|
+
"description": "Nodejs module to get drive information, tested on linux centos and windows vista",
|
5
|
+
"version": "0.0.3",
|
6
|
+
"license": "MIT",
|
7
|
+
"main": "./lib/diskinfo.js",
|
8
|
+
"scripts": {
|
9
|
+
},
|
10
|
+
"repository": {
|
11
|
+
"type": "git",
|
12
|
+
"url": "https://github.com/BenoitGauthier/diskinfo.git"
|
13
|
+
},
|
14
|
+
"keywords": [
|
15
|
+
"diskinfo",
|
16
|
+
"disk",
|
17
|
+
"disks",
|
18
|
+
"free space",
|
19
|
+
"volumes",
|
20
|
+
"harddisk",
|
21
|
+
"hard drive"
|
22
|
+
],
|
23
|
+
"main": "./lib/diskinfo",
|
24
|
+
"dependencies": {
|
25
|
+
},
|
26
|
+
"os": [
|
27
|
+
"linux",
|
28
|
+
"win32"
|
29
|
+
],
|
30
|
+
"devDependencies": {
|
31
|
+
}
|
32
|
+
}
|
@@ -0,0 +1,15 @@
|
|
1
|
+
var d = require('diskinfo');
|
2
|
+
|
3
|
+
d.getDrives(function(err, aDrives) {
|
4
|
+
|
5
|
+
for (var i = 0; i < aDrives.length; i++) {
|
6
|
+
console.log('Drive ' + aDrives[i].filesystem);
|
7
|
+
console.log('blocks ' + aDrives[i].blocks);
|
8
|
+
console.log('used ' + aDrives[i].used);
|
9
|
+
console.log('available ' + aDrives[i].available);
|
10
|
+
console.log('capacity ' + aDrives[i].capacity);
|
11
|
+
console.log('mounted ' + aDrives[i].mounted);
|
12
|
+
console.log('-----------------------------------------');
|
13
|
+
}
|
14
|
+
|
15
|
+
});
|
@@ -0,0 +1,18 @@
|
|
1
|
+
Copyright 2014–present Olivier Lalonde <olalonde@gmail.com>, James Talmage <james@talmage.io>, Ruben Verborgh
|
2
|
+
|
3
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy of
|
4
|
+
this software and associated documentation files (the "Software"), to deal in
|
5
|
+
the Software without restriction, including without limitation the rights to
|
6
|
+
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
|
7
|
+
of the Software, and to permit persons to whom the Software is furnished to do
|
8
|
+
so, subject to the following conditions:
|
9
|
+
|
10
|
+
The above copyright notice and this permission notice shall be included in all
|
11
|
+
copies or substantial portions of the Software.
|
12
|
+
|
13
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
14
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
15
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
16
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
|
17
|
+
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
|
18
|
+
IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
@@ -0,0 +1,155 @@
|
|
1
|
+
## Follow Redirects
|
2
|
+
|
3
|
+
Drop-in replacement for Node's `http` and `https` modules that automatically follows redirects.
|
4
|
+
|
5
|
+
[](https://www.npmjs.com/package/follow-redirects)
|
6
|
+
[](https://github.com/follow-redirects/follow-redirects/actions)
|
7
|
+
[](https://coveralls.io/r/follow-redirects/follow-redirects?branch=master)
|
8
|
+
[](https://www.npmjs.com/package/follow-redirects)
|
9
|
+
[](https://github.com/sponsors/RubenVerborgh)
|
10
|
+
|
11
|
+
`follow-redirects` provides [request](https://nodejs.org/api/http.html#http_http_request_options_callback) and [get](https://nodejs.org/api/http.html#http_http_get_options_callback)
|
12
|
+
methods that behave identically to those found on the native [http](https://nodejs.org/api/http.html#http_http_request_options_callback) and [https](https://nodejs.org/api/https.html#https_https_request_options_callback)
|
13
|
+
modules, with the exception that they will seamlessly follow redirects.
|
14
|
+
|
15
|
+
```javascript
|
16
|
+
const { http, https } = require('follow-redirects');
|
17
|
+
|
18
|
+
http.get('http://bit.ly/900913', response => {
|
19
|
+
response.on('data', chunk => {
|
20
|
+
console.log(chunk);
|
21
|
+
});
|
22
|
+
}).on('error', err => {
|
23
|
+
console.error(err);
|
24
|
+
});
|
25
|
+
```
|
26
|
+
|
27
|
+
You can inspect the final redirected URL through the `responseUrl` property on the `response`.
|
28
|
+
If no redirection happened, `responseUrl` is the original request URL.
|
29
|
+
|
30
|
+
```javascript
|
31
|
+
const request = https.request({
|
32
|
+
host: 'bitly.com',
|
33
|
+
path: '/UHfDGO',
|
34
|
+
}, response => {
|
35
|
+
console.log(response.responseUrl);
|
36
|
+
// 'http://duckduckgo.com/robots.txt'
|
37
|
+
});
|
38
|
+
request.end();
|
39
|
+
```
|
40
|
+
|
41
|
+
## Options
|
42
|
+
### Global options
|
43
|
+
Global options are set directly on the `follow-redirects` module:
|
44
|
+
|
45
|
+
```javascript
|
46
|
+
const followRedirects = require('follow-redirects');
|
47
|
+
followRedirects.maxRedirects = 10;
|
48
|
+
followRedirects.maxBodyLength = 20 * 1024 * 1024; // 20 MB
|
49
|
+
```
|
50
|
+
|
51
|
+
The following global options are supported:
|
52
|
+
|
53
|
+
- `maxRedirects` (default: `21`) – sets the maximum number of allowed redirects; if exceeded, an error will be emitted.
|
54
|
+
|
55
|
+
- `maxBodyLength` (default: 10MB) – sets the maximum size of the request body; if exceeded, an error will be emitted.
|
56
|
+
|
57
|
+
### Per-request options
|
58
|
+
Per-request options are set by passing an `options` object:
|
59
|
+
|
60
|
+
```javascript
|
61
|
+
const url = require('url');
|
62
|
+
const { http, https } = require('follow-redirects');
|
63
|
+
|
64
|
+
const options = url.parse('http://bit.ly/900913');
|
65
|
+
options.maxRedirects = 10;
|
66
|
+
options.beforeRedirect = (options, response, request) => {
|
67
|
+
// Use this to adjust the request options upon redirecting,
|
68
|
+
// to inspect the latest response headers,
|
69
|
+
// or to cancel the request by throwing an error
|
70
|
+
|
71
|
+
// response.headers = the redirect response headers
|
72
|
+
// response.statusCode = the redirect response code (eg. 301, 307, etc.)
|
73
|
+
|
74
|
+
// request.url = the requested URL that resulted in a redirect
|
75
|
+
// request.headers = the headers in the request that resulted in a redirect
|
76
|
+
// request.method = the method of the request that resulted in a redirect
|
77
|
+
if (options.hostname === "example.com") {
|
78
|
+
options.auth = "user:password";
|
79
|
+
}
|
80
|
+
};
|
81
|
+
http.request(options);
|
82
|
+
```
|
83
|
+
|
84
|
+
In addition to the [standard HTTP](https://nodejs.org/api/http.html#http_http_request_options_callback) and [HTTPS options](https://nodejs.org/api/https.html#https_https_request_options_callback),
|
85
|
+
the following per-request options are supported:
|
86
|
+
- `followRedirects` (default: `true`) – whether redirects should be followed.
|
87
|
+
|
88
|
+
- `maxRedirects` (default: `21`) – sets the maximum number of allowed redirects; if exceeded, an error will be emitted.
|
89
|
+
|
90
|
+
- `maxBodyLength` (default: 10MB) – sets the maximum size of the request body; if exceeded, an error will be emitted.
|
91
|
+
|
92
|
+
- `beforeRedirect` (default: `undefined`) – optionally change the request `options` on redirects, or abort the request by throwing an error.
|
93
|
+
|
94
|
+
- `agents` (default: `undefined`) – sets the `agent` option per protocol, since HTTP and HTTPS use different agents. Example value: `{ http: new http.Agent(), https: new https.Agent() }`
|
95
|
+
|
96
|
+
- `trackRedirects` (default: `false`) – whether to store the redirected response details into the `redirects` array on the response object.
|
97
|
+
|
98
|
+
|
99
|
+
### Advanced usage
|
100
|
+
By default, `follow-redirects` will use the Node.js default implementations
|
101
|
+
of [`http`](https://nodejs.org/api/http.html)
|
102
|
+
and [`https`](https://nodejs.org/api/https.html).
|
103
|
+
To enable features such as caching and/or intermediate request tracking,
|
104
|
+
you might instead want to wrap `follow-redirects` around custom protocol implementations:
|
105
|
+
|
106
|
+
```javascript
|
107
|
+
const { http, https } = require('follow-redirects').wrap({
|
108
|
+
http: require('your-custom-http'),
|
109
|
+
https: require('your-custom-https'),
|
110
|
+
});
|
111
|
+
```
|
112
|
+
|
113
|
+
Such custom protocols only need an implementation of the `request` method.
|
114
|
+
|
115
|
+
## Browser Usage
|
116
|
+
|
117
|
+
Due to the way the browser works,
|
118
|
+
the `http` and `https` browser equivalents perform redirects by default.
|
119
|
+
|
120
|
+
By requiring `follow-redirects` this way:
|
121
|
+
```javascript
|
122
|
+
const http = require('follow-redirects/http');
|
123
|
+
const https = require('follow-redirects/https');
|
124
|
+
```
|
125
|
+
you can easily tell webpack and friends to replace
|
126
|
+
`follow-redirect` by the built-in versions:
|
127
|
+
|
128
|
+
```json
|
129
|
+
{
|
130
|
+
"follow-redirects/http" : "http",
|
131
|
+
"follow-redirects/https" : "https"
|
132
|
+
}
|
133
|
+
```
|
134
|
+
|
135
|
+
## Contributing
|
136
|
+
|
137
|
+
Pull Requests are always welcome. Please [file an issue](https://github.com/follow-redirects/follow-redirects/issues)
|
138
|
+
detailing your proposal before you invest your valuable time. Additional features and bug fixes should be accompanied
|
139
|
+
by tests. You can run the test suite locally with a simple `npm test` command.
|
140
|
+
|
141
|
+
## Debug Logging
|
142
|
+
|
143
|
+
`follow-redirects` uses the excellent [debug](https://www.npmjs.com/package/debug) for logging. To turn on logging
|
144
|
+
set the environment variable `DEBUG=follow-redirects` for debug output from just this module. When running the test
|
145
|
+
suite it is sometimes advantageous to set `DEBUG=*` to see output from the express server as well.
|
146
|
+
|
147
|
+
## Authors
|
148
|
+
|
149
|
+
- [Ruben Verborgh](https://ruben.verborgh.org/)
|
150
|
+
- [Olivier Lalonde](mailto:olalonde@gmail.com)
|
151
|
+
- [James Talmage](mailto:james@talmage.io)
|
152
|
+
|
153
|
+
## License
|
154
|
+
|
155
|
+
[MIT License](https://github.com/follow-redirects/follow-redirects/blob/master/LICENSE)
|
@@ -0,0 +1,15 @@
|
|
1
|
+
var debug;
|
2
|
+
|
3
|
+
module.exports = function () {
|
4
|
+
if (!debug) {
|
5
|
+
try {
|
6
|
+
/* eslint global-require: off */
|
7
|
+
debug = require("debug")("follow-redirects");
|
8
|
+
}
|
9
|
+
catch (error) { /* */ }
|
10
|
+
if (typeof debug !== "function") {
|
11
|
+
debug = function () { /* */ };
|
12
|
+
}
|
13
|
+
}
|
14
|
+
debug.apply(null, arguments);
|
15
|
+
};
|