angular-slickgrid 4.2.1 → 4.2.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/LICENSE +20 -20
- package/app/modules/angular-slickgrid/components/angular-slickgrid.component.d.ts +2 -2
- package/app/modules/angular-slickgrid/extensions/slickRowDetailView.d.ts +0 -2
- package/docs/assets/lib/multiple-select/README.md +17 -17
- package/esm2020/app/modules/angular-slickgrid/components/angular-slickgrid.component.mjs +14 -14
- package/esm2020/app/modules/angular-slickgrid/constants.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/extensions/index.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/extensions/slickRowDetailView.mjs +2 -4
- package/esm2020/app/modules/angular-slickgrid/global-grid-options.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/index.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/models/angularComponentOutput.interface.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/models/angularGridInstance.interface.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/models/externalTestingDependencies.interface.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/models/gridOption.interface.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/models/index.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/models/rowDetailView.interface.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/models/slickGrid.interface.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/modules/angular-slickgrid.module.mjs +7 -10
- package/esm2020/app/modules/angular-slickgrid/services/angularUtil.service.mjs +4 -4
- package/esm2020/app/modules/angular-slickgrid/services/bsDropdown.service.mjs +4 -4
- package/esm2020/app/modules/angular-slickgrid/services/container.service.mjs +4 -4
- package/esm2020/app/modules/angular-slickgrid/services/index.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/services/translater.service.mjs +4 -4
- package/esm2020/app/modules/angular-slickgrid/services/utilities.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/slickgrid-config.mjs +1 -1
- package/esm2020/public_api.mjs +1 -1
- package/fesm2015/angular-slickgrid.mjs +32 -37
- package/fesm2015/angular-slickgrid.mjs.map +1 -1
- package/fesm2020/angular-slickgrid.mjs +32 -37
- package/fesm2020/angular-slickgrid.mjs.map +1 -1
- package/i18n/en.json +89 -89
- package/i18n/fr.json +90 -90
- package/{angular-slickgrid.d.ts → index.d.ts} +0 -0
- package/package.json +11 -11
- package/test/cypress/node_modules/@cypress/request/README.md +1038 -0
- package/test/cypress/node_modules/@cypress/xvfb/README.md +48 -0
- package/test/cypress/node_modules/@cypress/xvfb/node_modules/debug/README.md +437 -0
- package/test/cypress/node_modules/@types/node/README.md +16 -0
- package/test/cypress/node_modules/@types/sinonjs__fake-timers/README.md +16 -0
- package/test/cypress/node_modules/@types/sizzle/README.md +16 -0
- package/test/cypress/node_modules/@types/yauzl/README.md +16 -0
- package/test/cypress/node_modules/@types/yauzl/node_modules/@types/node/README.md +16 -0
- package/test/cypress/node_modules/aggregate-error/README.md +61 -0
- package/test/cypress/node_modules/ansi-colors/README.md +315 -0
- package/test/cypress/node_modules/ansi-escapes/README.md +245 -0
- package/test/cypress/node_modules/ansi-regex/README.md +78 -0
- package/test/cypress/node_modules/ansi-styles/README.md +152 -0
- package/test/cypress/node_modules/arch/README.md +71 -0
- package/test/cypress/node_modules/asn1/README.md +50 -0
- package/test/cypress/node_modules/assert-plus/README.md +162 -0
- package/test/cypress/node_modules/astral-regex/README.md +46 -0
- package/test/cypress/node_modules/async/README.md +60 -0
- package/test/cypress/node_modules/asynckit/README.md +233 -0
- package/test/cypress/node_modules/at-least-node/README.md +25 -0
- package/test/cypress/node_modules/aws-sign2/README.md +4 -0
- package/test/cypress/node_modules/aws4/README.md +183 -0
- package/test/cypress/node_modules/balanced-match/README.md +91 -0
- package/test/cypress/node_modules/base64-js/README.md +34 -0
- package/test/cypress/node_modules/bcrypt-pbkdf/README.md +45 -0
- package/test/cypress/node_modules/blob-util/README.md +623 -0
- package/test/cypress/node_modules/bluebird/README.md +57 -0
- package/test/cypress/node_modules/brace-expansion/README.md +129 -0
- package/test/cypress/node_modules/buffer/README.md +410 -0
- package/test/cypress/node_modules/buffer-crc32/README.md +47 -0
- package/test/cypress/node_modules/cachedir/README.md +27 -0
- package/test/cypress/node_modules/caseless/README.md +45 -0
- package/test/cypress/node_modules/chalk/README.md +293 -0
- package/test/cypress/node_modules/chalk/node_modules/supports-color/README.md +76 -0
- package/test/cypress/node_modules/check-more-types/README.md +952 -0
- package/test/cypress/node_modules/ci-info/README.md +114 -0
- package/test/cypress/node_modules/clean-stack/README.md +76 -0
- package/test/cypress/node_modules/cli-cursor/README.md +55 -0
- package/test/cypress/node_modules/cli-table3/README.md +218 -0
- package/test/cypress/node_modules/cli-truncate/README.md +139 -0
- package/test/cypress/node_modules/color-convert/README.md +68 -0
- package/test/cypress/node_modules/color-name/README.md +11 -0
- package/test/cypress/node_modules/colorette/README.md +102 -0
- package/test/cypress/node_modules/colors/README.md +221 -0
- package/test/cypress/node_modules/combined-stream/README.md +138 -0
- package/test/cypress/node_modules/commander/README.md +737 -0
- package/test/cypress/node_modules/common-tags/README.md +687 -0
- package/test/cypress/node_modules/core-util-is/README.md +3 -0
- package/test/cypress/node_modules/cross-spawn/README.md +96 -0
- package/test/cypress/node_modules/cypress/README.md +25 -0
- package/test/cypress/node_modules/cypress/mount-utils/README.md +14 -0
- package/test/cypress/node_modules/cypress/react/README.md +414 -0
- package/test/cypress/node_modules/cypress/vue/README.md +678 -0
- package/test/cypress/node_modules/cypress/vue2/README.md +693 -0
- package/test/cypress/node_modules/dashdash/README.md +574 -0
- package/test/cypress/node_modules/dayjs/README.md +128 -0
- package/test/cypress/node_modules/debug/README.md +455 -0
- package/test/cypress/node_modules/delayed-stream/README.md +141 -0
- package/test/cypress/node_modules/ecc-jsbn/README.md +8 -0
- package/test/cypress/node_modules/emoji-regex/README.md +73 -0
- package/test/cypress/node_modules/end-of-stream/README.md +54 -0
- package/test/cypress/node_modules/enquirer/README.md +1752 -0
- package/test/cypress/node_modules/escape-string-regexp/README.md +27 -0
- package/test/cypress/node_modules/eventemitter2/README.md +809 -0
- package/test/cypress/node_modules/execa/README.md +656 -0
- package/test/cypress/node_modules/executable/README.md +64 -0
- package/test/cypress/node_modules/extend/README.md +81 -0
- package/test/cypress/node_modules/extract-zip/README.md +57 -0
- package/test/cypress/node_modules/extract-zip/node_modules/debug/README.md +455 -0
- package/test/cypress/node_modules/extsprintf/README.md +46 -0
- package/test/cypress/node_modules/fd-slicer/README.md +199 -0
- package/test/cypress/node_modules/figures/README.md +139 -0
- package/test/cypress/node_modules/forever-agent/README.md +4 -0
- package/test/cypress/node_modules/form-data/README.md +234 -0
- package/test/cypress/node_modules/fs-extra/README.md +264 -0
- package/test/cypress/node_modules/fs.realpath/README.md +33 -0
- package/test/cypress/node_modules/get-stream/README.md +124 -0
- package/test/cypress/node_modules/getos/README.md +79 -0
- package/test/cypress/node_modules/getpass/README.md +32 -0
- package/test/cypress/node_modules/glob/README.md +375 -0
- package/test/cypress/node_modules/global-dirs/README.md +72 -0
- package/test/cypress/node_modules/graceful-fs/README.md +133 -0
- package/test/cypress/node_modules/has-flag/README.md +89 -0
- package/test/cypress/node_modules/http-signature/README.md +80 -0
- package/test/cypress/node_modules/human-signals/README.md +155 -0
- package/test/cypress/node_modules/ieee754/README.md +51 -0
- package/test/cypress/node_modules/indent-string/README.md +70 -0
- package/test/cypress/node_modules/inflight/README.md +37 -0
- package/test/cypress/node_modules/inherits/README.md +42 -0
- package/test/cypress/node_modules/ini/README.md +102 -0
- package/test/cypress/node_modules/is-ci/README.md +50 -0
- package/test/cypress/node_modules/is-fullwidth-code-point/README.md +39 -0
- package/test/cypress/node_modules/is-installed-globally/README.md +31 -0
- package/test/cypress/node_modules/is-path-inside/README.md +63 -0
- package/test/cypress/node_modules/is-stream/README.md +57 -0
- package/test/cypress/node_modules/is-typedarray/README.md +16 -0
- package/test/cypress/node_modules/isexe/README.md +51 -0
- package/test/cypress/node_modules/isstream/README.md +66 -0
- package/test/cypress/node_modules/jsbn/README.md +175 -0
- package/test/cypress/node_modules/json-schema/README.md +3 -0
- package/test/cypress/node_modules/json-stringify-safe/README.md +52 -0
- package/test/cypress/node_modules/jsonfile/README.md +205 -0
- package/test/cypress/node_modules/jsonfile/node_modules/universalify/README.md +76 -0
- package/test/cypress/node_modules/jsprim/README.md +287 -0
- package/test/cypress/node_modules/lazy-ass/README.md +269 -0
- package/test/cypress/node_modules/listr2/README.md +17 -0
- package/test/cypress/node_modules/lodash/README.md +39 -0
- package/test/cypress/node_modules/lodash.once/README.md +18 -0
- package/test/cypress/node_modules/log-symbols/README.md +51 -0
- package/test/cypress/node_modules/log-update/README.md +97 -0
- package/test/cypress/node_modules/log-update/node_modules/slice-ansi/README.md +66 -0
- package/test/cypress/node_modules/log-update/node_modules/wrap-ansi/README.md +97 -0
- package/test/cypress/node_modules/lru-cache/README.md +166 -0
- package/test/cypress/node_modules/merge-stream/README.md +78 -0
- package/test/cypress/node_modules/mime-db/README.md +102 -0
- package/test/cypress/node_modules/mime-types/README.md +123 -0
- package/test/cypress/node_modules/mimic-fn/README.md +69 -0
- package/test/cypress/node_modules/minimatch/README.md +209 -0
- package/test/cypress/node_modules/ms/README.md +60 -0
- package/test/cypress/node_modules/npm-run-path/README.md +115 -0
- package/test/cypress/node_modules/once/README.md +79 -0
- package/test/cypress/node_modules/onetime/README.md +94 -0
- package/test/cypress/node_modules/ospath/README.md +53 -0
- package/test/cypress/node_modules/p-map/README.md +89 -0
- package/test/cypress/node_modules/path-is-absolute/README.md +59 -0
- package/test/cypress/node_modules/path-key/README.md +61 -0
- package/test/cypress/node_modules/pend/README.md +41 -0
- package/test/cypress/node_modules/performance-now/README.md +30 -0
- package/test/cypress/node_modules/pify/README.md +119 -0
- package/test/cypress/node_modules/pretty-bytes/README.md +131 -0
- package/test/cypress/node_modules/proxy-from-env/README.md +131 -0
- package/test/cypress/node_modules/psl/README.md +215 -0
- package/test/cypress/node_modules/pump/README.md +65 -0
- package/test/cypress/node_modules/punycode/README.md +122 -0
- package/test/cypress/node_modules/qs/README.md +475 -0
- package/test/cypress/node_modules/request-progress/README.md +78 -0
- package/test/cypress/node_modules/restore-cursor/README.md +26 -0
- package/test/cypress/node_modules/rimraf/README.md +101 -0
- package/test/cypress/node_modules/rxjs/README.md +147 -0
- package/test/cypress/node_modules/rxjs/_esm2015/README.md +147 -0
- package/test/cypress/node_modules/rxjs/_esm5/README.md +147 -0
- package/test/cypress/node_modules/rxjs/src/README.md +147 -0
- package/test/cypress/node_modules/safe-buffer/README.md +584 -0
- package/test/cypress/node_modules/safer-buffer/README.md +156 -0
- package/test/cypress/node_modules/semver/README.md +566 -0
- package/test/cypress/node_modules/shebang-command/README.md +34 -0
- package/test/cypress/node_modules/shebang-regex/README.md +33 -0
- package/test/cypress/node_modules/signal-exit/README.md +39 -0
- package/test/cypress/node_modules/slice-ansi/README.md +72 -0
- package/test/cypress/node_modules/sshpk/README.md +804 -0
- package/test/cypress/node_modules/string-width/README.md +50 -0
- package/test/cypress/node_modules/strip-ansi/README.md +46 -0
- package/test/cypress/node_modules/strip-final-newline/README.md +30 -0
- package/test/cypress/node_modules/supports-color/README.md +77 -0
- package/test/cypress/node_modules/throttleit/README.md +32 -0
- package/test/cypress/node_modules/tmp/README.md +365 -0
- package/test/cypress/node_modules/tough-cookie/README.md +527 -0
- package/test/cypress/node_modules/tslib/README.md +142 -0
- package/test/cypress/node_modules/tunnel-agent/README.md +4 -0
- package/test/cypress/node_modules/tweetnacl/README.md +459 -0
- package/test/cypress/node_modules/type-fest/README.md +760 -0
- package/test/cypress/node_modules/universalify/README.md +76 -0
- package/test/cypress/node_modules/untildify/README.md +30 -0
- package/test/cypress/node_modules/uuid/README.md +505 -0
- package/test/cypress/node_modules/verror/README.md +528 -0
- package/test/cypress/node_modules/verror/node_modules/extsprintf/README.md +46 -0
- package/test/cypress/node_modules/which/README.md +54 -0
- package/test/cypress/node_modules/wrap-ansi/README.md +91 -0
- package/test/cypress/node_modules/wrappy/README.md +36 -0
- package/test/cypress/node_modules/yallist/README.md +204 -0
- package/test/cypress/node_modules/yauzl/README.md +658 -0
|
@@ -0,0 +1,475 @@
|
|
|
1
|
+
# qs <sup>[![Version Badge][2]][1]</sup>
|
|
2
|
+
|
|
3
|
+
[![Build Status][3]][4]
|
|
4
|
+
[![dependency status][5]][6]
|
|
5
|
+
[![dev dependency status][7]][8]
|
|
6
|
+
[![License][license-image]][license-url]
|
|
7
|
+
[![Downloads][downloads-image]][downloads-url]
|
|
8
|
+
|
|
9
|
+
[![npm badge][11]][1]
|
|
10
|
+
|
|
11
|
+
A querystring parsing and stringifying library with some added security.
|
|
12
|
+
|
|
13
|
+
Lead Maintainer: [Jordan Harband](https://github.com/ljharb)
|
|
14
|
+
|
|
15
|
+
The **qs** module was originally created and maintained by [TJ Holowaychuk](https://github.com/visionmedia/node-querystring).
|
|
16
|
+
|
|
17
|
+
## Usage
|
|
18
|
+
|
|
19
|
+
```javascript
|
|
20
|
+
var qs = require('qs');
|
|
21
|
+
var assert = require('assert');
|
|
22
|
+
|
|
23
|
+
var obj = qs.parse('a=c');
|
|
24
|
+
assert.deepEqual(obj, { a: 'c' });
|
|
25
|
+
|
|
26
|
+
var str = qs.stringify(obj);
|
|
27
|
+
assert.equal(str, 'a=c');
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
### Parsing Objects
|
|
31
|
+
|
|
32
|
+
[](#preventEval)
|
|
33
|
+
```javascript
|
|
34
|
+
qs.parse(string, [options]);
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
**qs** allows you to create nested objects within your query strings, by surrounding the name of sub-keys with square brackets `[]`.
|
|
38
|
+
For example, the string `'foo[bar]=baz'` converts to:
|
|
39
|
+
|
|
40
|
+
```javascript
|
|
41
|
+
assert.deepEqual(qs.parse('foo[bar]=baz'), {
|
|
42
|
+
foo: {
|
|
43
|
+
bar: 'baz'
|
|
44
|
+
}
|
|
45
|
+
});
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
When using the `plainObjects` option the parsed value is returned as a null object, created via `Object.create(null)` and as such you should be aware that prototype methods will not exist on it and a user may set those names to whatever value they like:
|
|
49
|
+
|
|
50
|
+
```javascript
|
|
51
|
+
var nullObject = qs.parse('a[hasOwnProperty]=b', { plainObjects: true });
|
|
52
|
+
assert.deepEqual(nullObject, { a: { hasOwnProperty: 'b' } });
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
By default parameters that would overwrite properties on the object prototype are ignored, if you wish to keep the data from those fields either use `plainObjects` as mentioned above, or set `allowPrototypes` to `true` which will allow user input to overwrite those properties. *WARNING* It is generally a bad idea to enable this option as it can cause problems when attempting to use the properties that have been overwritten. Always be careful with this option.
|
|
56
|
+
|
|
57
|
+
```javascript
|
|
58
|
+
var protoObject = qs.parse('a[hasOwnProperty]=b', { allowPrototypes: true });
|
|
59
|
+
assert.deepEqual(protoObject, { a: { hasOwnProperty: 'b' } });
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
URI encoded strings work too:
|
|
63
|
+
|
|
64
|
+
```javascript
|
|
65
|
+
assert.deepEqual(qs.parse('a%5Bb%5D=c'), {
|
|
66
|
+
a: { b: 'c' }
|
|
67
|
+
});
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
You can also nest your objects, like `'foo[bar][baz]=foobarbaz'`:
|
|
71
|
+
|
|
72
|
+
```javascript
|
|
73
|
+
assert.deepEqual(qs.parse('foo[bar][baz]=foobarbaz'), {
|
|
74
|
+
foo: {
|
|
75
|
+
bar: {
|
|
76
|
+
baz: 'foobarbaz'
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
});
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
By default, when nesting objects **qs** will only parse up to 5 children deep. This means if you attempt to parse a string like
|
|
83
|
+
`'a[b][c][d][e][f][g][h][i]=j'` your resulting object will be:
|
|
84
|
+
|
|
85
|
+
```javascript
|
|
86
|
+
var expected = {
|
|
87
|
+
a: {
|
|
88
|
+
b: {
|
|
89
|
+
c: {
|
|
90
|
+
d: {
|
|
91
|
+
e: {
|
|
92
|
+
f: {
|
|
93
|
+
'[g][h][i]': 'j'
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
};
|
|
101
|
+
var string = 'a[b][c][d][e][f][g][h][i]=j';
|
|
102
|
+
assert.deepEqual(qs.parse(string), expected);
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
This depth can be overridden by passing a `depth` option to `qs.parse(string, [options])`:
|
|
106
|
+
|
|
107
|
+
```javascript
|
|
108
|
+
var deep = qs.parse('a[b][c][d][e][f][g][h][i]=j', { depth: 1 });
|
|
109
|
+
assert.deepEqual(deep, { a: { b: { '[c][d][e][f][g][h][i]': 'j' } } });
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
The depth limit helps mitigate abuse when **qs** is used to parse user input, and it is recommended to keep it a reasonably small number.
|
|
113
|
+
|
|
114
|
+
For similar reasons, by default **qs** will only parse up to 1000 parameters. This can be overridden by passing a `parameterLimit` option:
|
|
115
|
+
|
|
116
|
+
```javascript
|
|
117
|
+
var limited = qs.parse('a=b&c=d', { parameterLimit: 1 });
|
|
118
|
+
assert.deepEqual(limited, { a: 'b' });
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
To bypass the leading question mark, use `ignoreQueryPrefix`:
|
|
122
|
+
|
|
123
|
+
```javascript
|
|
124
|
+
var prefixed = qs.parse('?a=b&c=d', { ignoreQueryPrefix: true });
|
|
125
|
+
assert.deepEqual(prefixed, { a: 'b', c: 'd' });
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
An optional delimiter can also be passed:
|
|
129
|
+
|
|
130
|
+
```javascript
|
|
131
|
+
var delimited = qs.parse('a=b;c=d', { delimiter: ';' });
|
|
132
|
+
assert.deepEqual(delimited, { a: 'b', c: 'd' });
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
Delimiters can be a regular expression too:
|
|
136
|
+
|
|
137
|
+
```javascript
|
|
138
|
+
var regexed = qs.parse('a=b;c=d,e=f', { delimiter: /[;,]/ });
|
|
139
|
+
assert.deepEqual(regexed, { a: 'b', c: 'd', e: 'f' });
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
Option `allowDots` can be used to enable dot notation:
|
|
143
|
+
|
|
144
|
+
```javascript
|
|
145
|
+
var withDots = qs.parse('a.b=c', { allowDots: true });
|
|
146
|
+
assert.deepEqual(withDots, { a: { b: 'c' } });
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
### Parsing Arrays
|
|
150
|
+
|
|
151
|
+
**qs** can also parse arrays using a similar `[]` notation:
|
|
152
|
+
|
|
153
|
+
```javascript
|
|
154
|
+
var withArray = qs.parse('a[]=b&a[]=c');
|
|
155
|
+
assert.deepEqual(withArray, { a: ['b', 'c'] });
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
You may specify an index as well:
|
|
159
|
+
|
|
160
|
+
```javascript
|
|
161
|
+
var withIndexes = qs.parse('a[1]=c&a[0]=b');
|
|
162
|
+
assert.deepEqual(withIndexes, { a: ['b', 'c'] });
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
Note that the only difference between an index in an array and a key in an object is that the value between the brackets must be a number
|
|
166
|
+
to create an array. When creating arrays with specific indices, **qs** will compact a sparse array to only the existing values preserving
|
|
167
|
+
their order:
|
|
168
|
+
|
|
169
|
+
```javascript
|
|
170
|
+
var noSparse = qs.parse('a[1]=b&a[15]=c');
|
|
171
|
+
assert.deepEqual(noSparse, { a: ['b', 'c'] });
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
Note that an empty string is also a value, and will be preserved:
|
|
175
|
+
|
|
176
|
+
```javascript
|
|
177
|
+
var withEmptyString = qs.parse('a[]=&a[]=b');
|
|
178
|
+
assert.deepEqual(withEmptyString, { a: ['', 'b'] });
|
|
179
|
+
|
|
180
|
+
var withIndexedEmptyString = qs.parse('a[0]=b&a[1]=&a[2]=c');
|
|
181
|
+
assert.deepEqual(withIndexedEmptyString, { a: ['b', '', 'c'] });
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
**qs** will also limit specifying indices in an array to a maximum index of `20`. Any array members with an index of greater than `20` will
|
|
185
|
+
instead be converted to an object with the index as the key:
|
|
186
|
+
|
|
187
|
+
```javascript
|
|
188
|
+
var withMaxIndex = qs.parse('a[100]=b');
|
|
189
|
+
assert.deepEqual(withMaxIndex, { a: { '100': 'b' } });
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
This limit can be overridden by passing an `arrayLimit` option:
|
|
193
|
+
|
|
194
|
+
```javascript
|
|
195
|
+
var withArrayLimit = qs.parse('a[1]=b', { arrayLimit: 0 });
|
|
196
|
+
assert.deepEqual(withArrayLimit, { a: { '1': 'b' } });
|
|
197
|
+
```
|
|
198
|
+
|
|
199
|
+
To disable array parsing entirely, set `parseArrays` to `false`.
|
|
200
|
+
|
|
201
|
+
```javascript
|
|
202
|
+
var noParsingArrays = qs.parse('a[]=b', { parseArrays: false });
|
|
203
|
+
assert.deepEqual(noParsingArrays, { a: { '0': 'b' } });
|
|
204
|
+
```
|
|
205
|
+
|
|
206
|
+
If you mix notations, **qs** will merge the two items into an object:
|
|
207
|
+
|
|
208
|
+
```javascript
|
|
209
|
+
var mixedNotation = qs.parse('a[0]=b&a[b]=c');
|
|
210
|
+
assert.deepEqual(mixedNotation, { a: { '0': 'b', b: 'c' } });
|
|
211
|
+
```
|
|
212
|
+
|
|
213
|
+
You can also create arrays of objects:
|
|
214
|
+
|
|
215
|
+
```javascript
|
|
216
|
+
var arraysOfObjects = qs.parse('a[][b]=c');
|
|
217
|
+
assert.deepEqual(arraysOfObjects, { a: [{ b: 'c' }] });
|
|
218
|
+
```
|
|
219
|
+
|
|
220
|
+
### Stringifying
|
|
221
|
+
|
|
222
|
+
[](#preventEval)
|
|
223
|
+
```javascript
|
|
224
|
+
qs.stringify(object, [options]);
|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
When stringifying, **qs** by default URI encodes output. Objects are stringified as you would expect:
|
|
228
|
+
|
|
229
|
+
```javascript
|
|
230
|
+
assert.equal(qs.stringify({ a: 'b' }), 'a=b');
|
|
231
|
+
assert.equal(qs.stringify({ a: { b: 'c' } }), 'a%5Bb%5D=c');
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
This encoding can be disabled by setting the `encode` option to `false`:
|
|
235
|
+
|
|
236
|
+
```javascript
|
|
237
|
+
var unencoded = qs.stringify({ a: { b: 'c' } }, { encode: false });
|
|
238
|
+
assert.equal(unencoded, 'a[b]=c');
|
|
239
|
+
```
|
|
240
|
+
|
|
241
|
+
Encoding can be disabled for keys by setting the `encodeValuesOnly` option to `true`:
|
|
242
|
+
```javascript
|
|
243
|
+
var encodedValues = qs.stringify(
|
|
244
|
+
{ a: 'b', c: ['d', 'e=f'], f: [['g'], ['h']] },
|
|
245
|
+
{ encodeValuesOnly: true }
|
|
246
|
+
);
|
|
247
|
+
assert.equal(encodedValues,'a=b&c[0]=d&c[1]=e%3Df&f[0][0]=g&f[1][0]=h');
|
|
248
|
+
```
|
|
249
|
+
|
|
250
|
+
This encoding can also be replaced by a custom encoding method set as `encoder` option:
|
|
251
|
+
|
|
252
|
+
```javascript
|
|
253
|
+
var encoded = qs.stringify({ a: { b: 'c' } }, { encoder: function (str) {
|
|
254
|
+
// Passed in values `a`, `b`, `c`
|
|
255
|
+
return // Return encoded string
|
|
256
|
+
}})
|
|
257
|
+
```
|
|
258
|
+
|
|
259
|
+
_(Note: the `encoder` option does not apply if `encode` is `false`)_
|
|
260
|
+
|
|
261
|
+
Analogue to the `encoder` there is a `decoder` option for `parse` to override decoding of properties and values:
|
|
262
|
+
|
|
263
|
+
```javascript
|
|
264
|
+
var decoded = qs.parse('x=z', { decoder: function (str) {
|
|
265
|
+
// Passed in values `x`, `z`
|
|
266
|
+
return // Return decoded string
|
|
267
|
+
}})
|
|
268
|
+
```
|
|
269
|
+
|
|
270
|
+
Examples beyond this point will be shown as though the output is not URI encoded for clarity. Please note that the return values in these cases *will* be URI encoded during real usage.
|
|
271
|
+
|
|
272
|
+
When arrays are stringified, by default they are given explicit indices:
|
|
273
|
+
|
|
274
|
+
```javascript
|
|
275
|
+
qs.stringify({ a: ['b', 'c', 'd'] });
|
|
276
|
+
// 'a[0]=b&a[1]=c&a[2]=d'
|
|
277
|
+
```
|
|
278
|
+
|
|
279
|
+
You may override this by setting the `indices` option to `false`:
|
|
280
|
+
|
|
281
|
+
```javascript
|
|
282
|
+
qs.stringify({ a: ['b', 'c', 'd'] }, { indices: false });
|
|
283
|
+
// 'a=b&a=c&a=d'
|
|
284
|
+
```
|
|
285
|
+
|
|
286
|
+
You may use the `arrayFormat` option to specify the format of the output array:
|
|
287
|
+
|
|
288
|
+
```javascript
|
|
289
|
+
qs.stringify({ a: ['b', 'c'] }, { arrayFormat: 'indices' })
|
|
290
|
+
// 'a[0]=b&a[1]=c'
|
|
291
|
+
qs.stringify({ a: ['b', 'c'] }, { arrayFormat: 'brackets' })
|
|
292
|
+
// 'a[]=b&a[]=c'
|
|
293
|
+
qs.stringify({ a: ['b', 'c'] }, { arrayFormat: 'repeat' })
|
|
294
|
+
// 'a=b&a=c'
|
|
295
|
+
```
|
|
296
|
+
|
|
297
|
+
When objects are stringified, by default they use bracket notation:
|
|
298
|
+
|
|
299
|
+
```javascript
|
|
300
|
+
qs.stringify({ a: { b: { c: 'd', e: 'f' } } });
|
|
301
|
+
// 'a[b][c]=d&a[b][e]=f'
|
|
302
|
+
```
|
|
303
|
+
|
|
304
|
+
You may override this to use dot notation by setting the `allowDots` option to `true`:
|
|
305
|
+
|
|
306
|
+
```javascript
|
|
307
|
+
qs.stringify({ a: { b: { c: 'd', e: 'f' } } }, { allowDots: true });
|
|
308
|
+
// 'a.b.c=d&a.b.e=f'
|
|
309
|
+
```
|
|
310
|
+
|
|
311
|
+
Empty strings and null values will omit the value, but the equals sign (=) remains in place:
|
|
312
|
+
|
|
313
|
+
```javascript
|
|
314
|
+
assert.equal(qs.stringify({ a: '' }), 'a=');
|
|
315
|
+
```
|
|
316
|
+
|
|
317
|
+
Key with no values (such as an empty object or array) will return nothing:
|
|
318
|
+
|
|
319
|
+
```javascript
|
|
320
|
+
assert.equal(qs.stringify({ a: [] }), '');
|
|
321
|
+
assert.equal(qs.stringify({ a: {} }), '');
|
|
322
|
+
assert.equal(qs.stringify({ a: [{}] }), '');
|
|
323
|
+
assert.equal(qs.stringify({ a: { b: []} }), '');
|
|
324
|
+
assert.equal(qs.stringify({ a: { b: {}} }), '');
|
|
325
|
+
```
|
|
326
|
+
|
|
327
|
+
Properties that are set to `undefined` will be omitted entirely:
|
|
328
|
+
|
|
329
|
+
```javascript
|
|
330
|
+
assert.equal(qs.stringify({ a: null, b: undefined }), 'a=');
|
|
331
|
+
```
|
|
332
|
+
|
|
333
|
+
The query string may optionally be prepended with a question mark:
|
|
334
|
+
|
|
335
|
+
```javascript
|
|
336
|
+
assert.equal(qs.stringify({ a: 'b', c: 'd' }, { addQueryPrefix: true }), '?a=b&c=d');
|
|
337
|
+
```
|
|
338
|
+
|
|
339
|
+
The delimiter may be overridden with stringify as well:
|
|
340
|
+
|
|
341
|
+
```javascript
|
|
342
|
+
assert.equal(qs.stringify({ a: 'b', c: 'd' }, { delimiter: ';' }), 'a=b;c=d');
|
|
343
|
+
```
|
|
344
|
+
|
|
345
|
+
If you only want to override the serialization of `Date` objects, you can provide a `serializeDate` option:
|
|
346
|
+
|
|
347
|
+
```javascript
|
|
348
|
+
var date = new Date(7);
|
|
349
|
+
assert.equal(qs.stringify({ a: date }), 'a=1970-01-01T00:00:00.007Z'.replace(/:/g, '%3A'));
|
|
350
|
+
assert.equal(
|
|
351
|
+
qs.stringify({ a: date }, { serializeDate: function (d) { return d.getTime(); } }),
|
|
352
|
+
'a=7'
|
|
353
|
+
);
|
|
354
|
+
```
|
|
355
|
+
|
|
356
|
+
You may use the `sort` option to affect the order of parameter keys:
|
|
357
|
+
|
|
358
|
+
```javascript
|
|
359
|
+
function alphabeticalSort(a, b) {
|
|
360
|
+
return a.localeCompare(b);
|
|
361
|
+
}
|
|
362
|
+
assert.equal(qs.stringify({ a: 'c', z: 'y', b : 'f' }, { sort: alphabeticalSort }), 'a=c&b=f&z=y');
|
|
363
|
+
```
|
|
364
|
+
|
|
365
|
+
Finally, you can use the `filter` option to restrict which keys will be included in the stringified output.
|
|
366
|
+
If you pass a function, it will be called for each key to obtain the replacement value. Otherwise, if you
|
|
367
|
+
pass an array, it will be used to select properties and array indices for stringification:
|
|
368
|
+
|
|
369
|
+
```javascript
|
|
370
|
+
function filterFunc(prefix, value) {
|
|
371
|
+
if (prefix == 'b') {
|
|
372
|
+
// Return an `undefined` value to omit a property.
|
|
373
|
+
return;
|
|
374
|
+
}
|
|
375
|
+
if (prefix == 'e[f]') {
|
|
376
|
+
return value.getTime();
|
|
377
|
+
}
|
|
378
|
+
if (prefix == 'e[g][0]') {
|
|
379
|
+
return value * 2;
|
|
380
|
+
}
|
|
381
|
+
return value;
|
|
382
|
+
}
|
|
383
|
+
qs.stringify({ a: 'b', c: 'd', e: { f: new Date(123), g: [2] } }, { filter: filterFunc });
|
|
384
|
+
// 'a=b&c=d&e[f]=123&e[g][0]=4'
|
|
385
|
+
qs.stringify({ a: 'b', c: 'd', e: 'f' }, { filter: ['a', 'e'] });
|
|
386
|
+
// 'a=b&e=f'
|
|
387
|
+
qs.stringify({ a: ['b', 'c', 'd'], e: 'f' }, { filter: ['a', 0, 2] });
|
|
388
|
+
// 'a[0]=b&a[2]=d'
|
|
389
|
+
```
|
|
390
|
+
|
|
391
|
+
### Handling of `null` values
|
|
392
|
+
|
|
393
|
+
By default, `null` values are treated like empty strings:
|
|
394
|
+
|
|
395
|
+
```javascript
|
|
396
|
+
var withNull = qs.stringify({ a: null, b: '' });
|
|
397
|
+
assert.equal(withNull, 'a=&b=');
|
|
398
|
+
```
|
|
399
|
+
|
|
400
|
+
Parsing does not distinguish between parameters with and without equal signs. Both are converted to empty strings.
|
|
401
|
+
|
|
402
|
+
```javascript
|
|
403
|
+
var equalsInsensitive = qs.parse('a&b=');
|
|
404
|
+
assert.deepEqual(equalsInsensitive, { a: '', b: '' });
|
|
405
|
+
```
|
|
406
|
+
|
|
407
|
+
To distinguish between `null` values and empty strings use the `strictNullHandling` flag. In the result string the `null`
|
|
408
|
+
values have no `=` sign:
|
|
409
|
+
|
|
410
|
+
```javascript
|
|
411
|
+
var strictNull = qs.stringify({ a: null, b: '' }, { strictNullHandling: true });
|
|
412
|
+
assert.equal(strictNull, 'a&b=');
|
|
413
|
+
```
|
|
414
|
+
|
|
415
|
+
To parse values without `=` back to `null` use the `strictNullHandling` flag:
|
|
416
|
+
|
|
417
|
+
```javascript
|
|
418
|
+
var parsedStrictNull = qs.parse('a&b=', { strictNullHandling: true });
|
|
419
|
+
assert.deepEqual(parsedStrictNull, { a: null, b: '' });
|
|
420
|
+
```
|
|
421
|
+
|
|
422
|
+
To completely skip rendering keys with `null` values, use the `skipNulls` flag:
|
|
423
|
+
|
|
424
|
+
```javascript
|
|
425
|
+
var nullsSkipped = qs.stringify({ a: 'b', c: null}, { skipNulls: true });
|
|
426
|
+
assert.equal(nullsSkipped, 'a=b');
|
|
427
|
+
```
|
|
428
|
+
|
|
429
|
+
### Dealing with special character sets
|
|
430
|
+
|
|
431
|
+
By default the encoding and decoding of characters is done in `utf-8`. If you
|
|
432
|
+
wish to encode querystrings to a different character set (i.e.
|
|
433
|
+
[Shift JIS](https://en.wikipedia.org/wiki/Shift_JIS)) you can use the
|
|
434
|
+
[`qs-iconv`](https://github.com/martinheidegger/qs-iconv) library:
|
|
435
|
+
|
|
436
|
+
```javascript
|
|
437
|
+
var encoder = require('qs-iconv/encoder')('shift_jis');
|
|
438
|
+
var shiftJISEncoded = qs.stringify({ a: 'こんにちは!' }, { encoder: encoder });
|
|
439
|
+
assert.equal(shiftJISEncoded, 'a=%82%B1%82%F1%82%C9%82%BF%82%CD%81I');
|
|
440
|
+
```
|
|
441
|
+
|
|
442
|
+
This also works for decoding of query strings:
|
|
443
|
+
|
|
444
|
+
```javascript
|
|
445
|
+
var decoder = require('qs-iconv/decoder')('shift_jis');
|
|
446
|
+
var obj = qs.parse('a=%82%B1%82%F1%82%C9%82%BF%82%CD%81I', { decoder: decoder });
|
|
447
|
+
assert.deepEqual(obj, { a: 'こんにちは!' });
|
|
448
|
+
```
|
|
449
|
+
|
|
450
|
+
### RFC 3986 and RFC 1738 space encoding
|
|
451
|
+
|
|
452
|
+
RFC3986 used as default option and encodes ' ' to *%20* which is backward compatible.
|
|
453
|
+
In the same time, output can be stringified as per RFC1738 with ' ' equal to '+'.
|
|
454
|
+
|
|
455
|
+
```
|
|
456
|
+
assert.equal(qs.stringify({ a: 'b c' }), 'a=b%20c');
|
|
457
|
+
assert.equal(qs.stringify({ a: 'b c' }, { format : 'RFC3986' }), 'a=b%20c');
|
|
458
|
+
assert.equal(qs.stringify({ a: 'b c' }, { format : 'RFC1738' }), 'a=b+c');
|
|
459
|
+
```
|
|
460
|
+
|
|
461
|
+
[1]: https://npmjs.org/package/qs
|
|
462
|
+
[2]: http://versionbadg.es/ljharb/qs.svg
|
|
463
|
+
[3]: https://api.travis-ci.org/ljharb/qs.svg
|
|
464
|
+
[4]: https://travis-ci.org/ljharb/qs
|
|
465
|
+
[5]: https://david-dm.org/ljharb/qs.svg
|
|
466
|
+
[6]: https://david-dm.org/ljharb/qs
|
|
467
|
+
[7]: https://david-dm.org/ljharb/qs/dev-status.svg
|
|
468
|
+
[8]: https://david-dm.org/ljharb/qs?type=dev
|
|
469
|
+
[9]: https://ci.testling.com/ljharb/qs.png
|
|
470
|
+
[10]: https://ci.testling.com/ljharb/qs
|
|
471
|
+
[11]: https://nodei.co/npm/qs.png?downloads=true&stars=true
|
|
472
|
+
[license-image]: http://img.shields.io/npm/l/qs.svg
|
|
473
|
+
[license-url]: LICENSE
|
|
474
|
+
[downloads-image]: http://img.shields.io/npm/dm/qs.svg
|
|
475
|
+
[downloads-url]: http://npm-stat.com/charts.html?package=qs
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
# request-progress
|
|
2
|
+
|
|
3
|
+
[![NPM version][npm-image]][npm-url] [![Downloads][downloads-image]][npm-url] [![Build Status][travis-image]][travis-url] [![Coverage Status][coveralls-image]][coveralls-url] [![Dependency status][david-dm-image]][david-dm-url] [![Dev Dependency status][david-dm-dev-image]][david-dm-dev-url]
|
|
4
|
+
|
|
5
|
+
[npm-url]:https://npmjs.org/package/request-progress
|
|
6
|
+
[downloads-image]:http://img.shields.io/npm/dm/request-progress.svg
|
|
7
|
+
[npm-image]:http://img.shields.io/npm/v/request-progress.svg
|
|
8
|
+
[travis-url]:https://travis-ci.org/IndigoUnited/node-request-progress
|
|
9
|
+
[travis-image]:http://img.shields.io/travis/IndigoUnited/node-request-progress/master.svg
|
|
10
|
+
[coveralls-url]:https://coveralls.io/r/IndigoUnited/node-request-progress
|
|
11
|
+
[coveralls-image]:https://img.shields.io/coveralls/IndigoUnited/node-request-progress/master.svg
|
|
12
|
+
[david-dm-url]:https://david-dm.org/IndigoUnited/node-request-progress
|
|
13
|
+
[david-dm-image]:https://img.shields.io/david/IndigoUnited/node-request-progress.svg
|
|
14
|
+
[david-dm-dev-url]:https://david-dm.org/IndigoUnited/node-request-progress#info=devDependencies
|
|
15
|
+
[david-dm-dev-image]:https://img.shields.io/david/dev/IndigoUnited/node-request-progress.svg
|
|
16
|
+
|
|
17
|
+
Tracks the download progress of a request made with [request](https://github.com/mikeal/request), giving insight of various metrics including progress percentage, download speed and time remaining.
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
## Installation
|
|
21
|
+
|
|
22
|
+
`$ npm install request-progress`
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
## Usage
|
|
26
|
+
|
|
27
|
+
```js
|
|
28
|
+
var fs = require('fs');
|
|
29
|
+
var request = require('request');
|
|
30
|
+
var progress = require('request-progress');
|
|
31
|
+
|
|
32
|
+
// The options argument is optional so you can omit it
|
|
33
|
+
progress(request('https://az412801.vo.msecnd.net/vhd/VMBuild_20141027/VirtualBox/IE11/Windows/IE11.Win8.1.For.Windows.VirtualBox.zip'), {
|
|
34
|
+
// throttle: 2000, // Throttle the progress event to 2000ms, defaults to 1000ms
|
|
35
|
+
// delay: 1000, // Only start to emit after 1000ms delay, defaults to 0ms
|
|
36
|
+
// lengthHeader: 'x-transfer-length' // Length header to use, defaults to content-length
|
|
37
|
+
})
|
|
38
|
+
.on('progress', function (state) {
|
|
39
|
+
// The state is an object that looks like this:
|
|
40
|
+
// {
|
|
41
|
+
// percent: 0.5, // Overall percent (between 0 to 1)
|
|
42
|
+
// speed: 554732, // The download speed in bytes/sec
|
|
43
|
+
// size: {
|
|
44
|
+
// total: 90044871, // The total payload size in bytes
|
|
45
|
+
// transferred: 27610959 // The transferred payload size in bytes
|
|
46
|
+
// },
|
|
47
|
+
// time: {
|
|
48
|
+
// elapsed: 36.235, // The total elapsed seconds since the start (3 decimals)
|
|
49
|
+
// remaining: 81.403 // The remaining seconds to finish (3 decimals)
|
|
50
|
+
// }
|
|
51
|
+
// }
|
|
52
|
+
console.log('progress', state);
|
|
53
|
+
})
|
|
54
|
+
.on('error', function (err) {
|
|
55
|
+
// Do something with err
|
|
56
|
+
})
|
|
57
|
+
.on('end', function () {
|
|
58
|
+
// Do something after request finishes
|
|
59
|
+
})
|
|
60
|
+
.pipe(fs.createWriteStream('IE11.Win8.1.For.Windows.VirtualBox.zip'));
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
If the request's response does not include the `content-length` header, the values of some metrics will be `null`.
|
|
64
|
+
Also `speed` and `time.remaining` will be `null` until it can be calculated.
|
|
65
|
+
|
|
66
|
+
The `state` object emitted in the `progress` event is reused to avoid creating a new object for each event.
|
|
67
|
+
If you wish to peek the `state` object at any time, it is available in `request.progressState`.
|
|
68
|
+
|
|
69
|
+
|
|
70
|
+
## Tests
|
|
71
|
+
|
|
72
|
+
`$ npm test`
|
|
73
|
+
`$ npm test-cov` to get coverage report
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
## License
|
|
77
|
+
|
|
78
|
+
Released under the [MIT License](http://www.opensource.org/licenses/mit-license.php).
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# restore-cursor [](https://travis-ci.org/sindresorhus/restore-cursor)
|
|
2
|
+
|
|
3
|
+
> Gracefully restore the CLI cursor on exit
|
|
4
|
+
|
|
5
|
+
Prevent the cursor you've hidden interactively from remaining hidden if the process crashes.
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
## Install
|
|
9
|
+
|
|
10
|
+
```
|
|
11
|
+
$ npm install restore-cursor
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
## Usage
|
|
16
|
+
|
|
17
|
+
```js
|
|
18
|
+
const restoreCursor = require('restore-cursor');
|
|
19
|
+
|
|
20
|
+
restoreCursor();
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
## License
|
|
25
|
+
|
|
26
|
+
MIT © [Sindre Sorhus](https://sindresorhus.com)
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
[](https://travis-ci.org/isaacs/rimraf) [](https://david-dm.org/isaacs/rimraf) [](https://david-dm.org/isaacs/rimraf#info=devDependencies)
|
|
2
|
+
|
|
3
|
+
The [UNIX command](http://en.wikipedia.org/wiki/Rm_(Unix)) `rm -rf` for node.
|
|
4
|
+
|
|
5
|
+
Install with `npm install rimraf`, or just drop rimraf.js somewhere.
|
|
6
|
+
|
|
7
|
+
## API
|
|
8
|
+
|
|
9
|
+
`rimraf(f, [opts], callback)`
|
|
10
|
+
|
|
11
|
+
The first parameter will be interpreted as a globbing pattern for files. If you
|
|
12
|
+
want to disable globbing you can do so with `opts.disableGlob` (defaults to
|
|
13
|
+
`false`). This might be handy, for instance, if you have filenames that contain
|
|
14
|
+
globbing wildcard characters.
|
|
15
|
+
|
|
16
|
+
The callback will be called with an error if there is one. Certain
|
|
17
|
+
errors are handled for you:
|
|
18
|
+
|
|
19
|
+
* Windows: `EBUSY` and `ENOTEMPTY` - rimraf will back off a maximum of
|
|
20
|
+
`opts.maxBusyTries` times before giving up, adding 100ms of wait
|
|
21
|
+
between each attempt. The default `maxBusyTries` is 3.
|
|
22
|
+
* `ENOENT` - If the file doesn't exist, rimraf will return
|
|
23
|
+
successfully, since your desired outcome is already the case.
|
|
24
|
+
* `EMFILE` - Since `readdir` requires opening a file descriptor, it's
|
|
25
|
+
possible to hit `EMFILE` if too many file descriptors are in use.
|
|
26
|
+
In the sync case, there's nothing to be done for this. But in the
|
|
27
|
+
async case, rimraf will gradually back off with timeouts up to
|
|
28
|
+
`opts.emfileWait` ms, which defaults to 1000.
|
|
29
|
+
|
|
30
|
+
## options
|
|
31
|
+
|
|
32
|
+
* unlink, chmod, stat, lstat, rmdir, readdir,
|
|
33
|
+
unlinkSync, chmodSync, statSync, lstatSync, rmdirSync, readdirSync
|
|
34
|
+
|
|
35
|
+
In order to use a custom file system library, you can override
|
|
36
|
+
specific fs functions on the options object.
|
|
37
|
+
|
|
38
|
+
If any of these functions are present on the options object, then
|
|
39
|
+
the supplied function will be used instead of the default fs
|
|
40
|
+
method.
|
|
41
|
+
|
|
42
|
+
Sync methods are only relevant for `rimraf.sync()`, of course.
|
|
43
|
+
|
|
44
|
+
For example:
|
|
45
|
+
|
|
46
|
+
```javascript
|
|
47
|
+
var myCustomFS = require('some-custom-fs')
|
|
48
|
+
|
|
49
|
+
rimraf('some-thing', myCustomFS, callback)
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
* maxBusyTries
|
|
53
|
+
|
|
54
|
+
If an `EBUSY`, `ENOTEMPTY`, or `EPERM` error code is encountered
|
|
55
|
+
on Windows systems, then rimraf will retry with a linear backoff
|
|
56
|
+
wait of 100ms longer on each try. The default maxBusyTries is 3.
|
|
57
|
+
|
|
58
|
+
Only relevant for async usage.
|
|
59
|
+
|
|
60
|
+
* emfileWait
|
|
61
|
+
|
|
62
|
+
If an `EMFILE` error is encountered, then rimraf will retry
|
|
63
|
+
repeatedly with a linear backoff of 1ms longer on each try, until
|
|
64
|
+
the timeout counter hits this max. The default limit is 1000.
|
|
65
|
+
|
|
66
|
+
If you repeatedly encounter `EMFILE` errors, then consider using
|
|
67
|
+
[graceful-fs](http://npm.im/graceful-fs) in your program.
|
|
68
|
+
|
|
69
|
+
Only relevant for async usage.
|
|
70
|
+
|
|
71
|
+
* glob
|
|
72
|
+
|
|
73
|
+
Set to `false` to disable [glob](http://npm.im/glob) pattern
|
|
74
|
+
matching.
|
|
75
|
+
|
|
76
|
+
Set to an object to pass options to the glob module. The default
|
|
77
|
+
glob options are `{ nosort: true, silent: true }`.
|
|
78
|
+
|
|
79
|
+
Glob version 6 is used in this module.
|
|
80
|
+
|
|
81
|
+
Relevant for both sync and async usage.
|
|
82
|
+
|
|
83
|
+
* disableGlob
|
|
84
|
+
|
|
85
|
+
Set to any non-falsey value to disable globbing entirely.
|
|
86
|
+
(Equivalent to setting `glob: false`.)
|
|
87
|
+
|
|
88
|
+
## rimraf.sync
|
|
89
|
+
|
|
90
|
+
It can remove stuff synchronously, too. But that's not so good. Use
|
|
91
|
+
the async API. It's better.
|
|
92
|
+
|
|
93
|
+
## CLI
|
|
94
|
+
|
|
95
|
+
If installed with `npm install rimraf -g` it can be used as a global
|
|
96
|
+
command `rimraf <path> [<path> ...]` which is useful for cross platform support.
|
|
97
|
+
|
|
98
|
+
## mkdirp
|
|
99
|
+
|
|
100
|
+
If you need to create a directory recursively, check out
|
|
101
|
+
[mkdirp](https://github.com/substack/node-mkdirp).
|