1 |
|
2 |
|
3 |
|
4 |
|
5 |
|
6 |
|
7 |
|
8 | 'use strict';
|
9 |
|
10 |
|
11 |
|
12 |
|
13 |
|
14 |
|
15 | var Buffer = require('safe-buffer').Buffer
|
16 | var contentDisposition = require('content-disposition');
|
17 | var contentType = require('content-type');
|
18 | var deprecate = require('depd')('express');
|
19 | var flatten = require('array-flatten');
|
20 | var mime = require('send').mime;
|
21 | var etag = require('etag');
|
22 | var proxyaddr = require('proxy-addr');
|
23 | var qs = require('qs');
|
24 | var querystring = require('querystring');
|
25 |
|
26 |
|
27 |
|
28 |
|
29 |
|
30 |
|
31 |
|
32 |
|
33 |
|
34 |
|
35 | exports.etag = createETagGenerator({ weak: false })
|
36 |
|
37 |
|
38 |
|
39 |
|
40 |
|
41 |
|
42 |
|
43 |
|
44 |
|
45 |
|
46 | exports.wetag = createETagGenerator({ weak: true })
|
47 |
|
48 |
|
49 |
|
50 |
|
51 |
|
52 |
|
53 |
|
54 |
|
55 |
|
56 | exports.isAbsolute = function(path){
|
57 | if ('/' === path[0]) return true;
|
58 | if (':' === path[1] && ('\\' === path[2] || '/' === path[2])) return true;
|
59 | if ('\\\\' === path.substring(0, 2)) return true;
|
60 | };
|
61 |
|
62 |
|
63 |
|
64 |
|
65 |
|
66 |
|
67 |
|
68 |
|
69 |
|
70 | exports.flatten = deprecate.function(flatten,
|
71 | 'utils.flatten: use array-flatten npm module instead');
|
72 |
|
73 |
|
74 |
|
75 |
|
76 |
|
77 |
|
78 |
|
79 |
|
80 |
|
81 | exports.normalizeType = function(type){
|
82 | return ~type.indexOf('/')
|
83 | ? acceptParams(type)
|
84 | : { value: mime.lookup(type), params: {} };
|
85 | };
|
86 |
|
87 |
|
88 |
|
89 |
|
90 |
|
91 |
|
92 |
|
93 |
|
94 |
|
95 | exports.normalizeTypes = function(types){
|
96 | var ret = [];
|
97 |
|
98 | for (var i = 0; i < types.length; ++i) {
|
99 | ret.push(exports.normalizeType(types[i]));
|
100 | }
|
101 |
|
102 | return ret;
|
103 | };
|
104 |
|
105 |
|
106 |
|
107 |
|
108 |
|
109 |
|
110 |
|
111 |
|
112 |
|
113 |
|
114 | exports.contentDisposition = deprecate.function(contentDisposition,
|
115 | 'utils.contentDisposition: use content-disposition npm module instead');
|
116 |
|
117 |
|
118 |
|
119 |
|
120 |
|
121 |
|
122 |
|
123 |
|
124 |
|
125 |
|
126 |
|
127 | function acceptParams(str, index) {
|
128 | var parts = str.split(/ *; */);
|
129 | var ret = { value: parts[0], quality: 1, params: {}, originalIndex: index };
|
130 |
|
131 | for (var i = 1; i < parts.length; ++i) {
|
132 | var pms = parts[i].split(/ *= */);
|
133 | if ('q' === pms[0]) {
|
134 | ret.quality = parseFloat(pms[1]);
|
135 | } else {
|
136 | ret.params[pms[0]] = pms[1];
|
137 | }
|
138 | }
|
139 |
|
140 | return ret;
|
141 | }
|
142 |
|
143 |
|
144 |
|
145 |
|
146 |
|
147 |
|
148 |
|
149 |
|
150 |
|
151 | exports.compileETag = function(val) {
|
152 | var fn;
|
153 |
|
154 | if (typeof val === 'function') {
|
155 | return val;
|
156 | }
|
157 |
|
158 | switch (val) {
|
159 | case true:
|
160 | fn = exports.wetag;
|
161 | break;
|
162 | case false:
|
163 | break;
|
164 | case 'strong':
|
165 | fn = exports.etag;
|
166 | break;
|
167 | case 'weak':
|
168 | fn = exports.wetag;
|
169 | break;
|
170 | default:
|
171 | throw new TypeError('unknown value for etag function: ' + val);
|
172 | }
|
173 |
|
174 | return fn;
|
175 | }
|
176 |
|
177 |
|
178 |
|
179 |
|
180 |
|
181 |
|
182 |
|
183 |
|
184 |
|
185 | exports.compileQueryParser = function compileQueryParser(val) {
|
186 | var fn;
|
187 |
|
188 | if (typeof val === 'function') {
|
189 | return val;
|
190 | }
|
191 |
|
192 | switch (val) {
|
193 | case true:
|
194 | fn = querystring.parse;
|
195 | break;
|
196 | case false:
|
197 | fn = newObject;
|
198 | break;
|
199 | case 'extended':
|
200 | fn = parseExtendedQueryString;
|
201 | break;
|
202 | case 'simple':
|
203 | fn = querystring.parse;
|
204 | break;
|
205 | default:
|
206 | throw new TypeError('unknown value for query parser function: ' + val);
|
207 | }
|
208 |
|
209 | return fn;
|
210 | }
|
211 |
|
212 |
|
213 |
|
214 |
|
215 |
|
216 |
|
217 |
|
218 |
|
219 |
|
220 | exports.compileTrust = function(val) {
|
221 | if (typeof val === 'function') return val;
|
222 |
|
223 | if (val === true) {
|
224 |
|
225 | return function(){ return true };
|
226 | }
|
227 |
|
228 | if (typeof val === 'number') {
|
229 |
|
230 | return function(a, i){ return i < val };
|
231 | }
|
232 |
|
233 | if (typeof val === 'string') {
|
234 |
|
235 | val = val.split(/ *, */);
|
236 | }
|
237 |
|
238 | return proxyaddr.compile(val || []);
|
239 | }
|
240 |
|
241 |
|
242 |
|
243 |
|
244 |
|
245 |
|
246 |
|
247 |
|
248 |
|
249 |
|
250 | exports.setCharset = function setCharset(type, charset) {
|
251 | if (!type || !charset) {
|
252 | return type;
|
253 | }
|
254 |
|
255 |
|
256 | var parsed = contentType.parse(type);
|
257 |
|
258 |
|
259 | parsed.parameters.charset = charset;
|
260 |
|
261 |
|
262 | return contentType.format(parsed);
|
263 | };
|
264 |
|
265 |
|
266 |
|
267 |
|
268 |
|
269 |
|
270 |
|
271 |
|
272 |
|
273 |
|
274 | function createETagGenerator (options) {
|
275 | return function generateETag (body, encoding) {
|
276 | var buf = !Buffer.isBuffer(body)
|
277 | ? Buffer.from(body, encoding)
|
278 | : body
|
279 |
|
280 | return etag(buf, options)
|
281 | }
|
282 | }
|
283 |
|
284 |
|
285 |
|
286 |
|
287 |
|
288 |
|
289 |
|
290 |
|
291 | function parseExtendedQueryString(str) {
|
292 | return qs.parse(str, {
|
293 | allowPrototypes: true
|
294 | });
|
295 | }
|
296 |
|
297 |
|
298 |
|
299 |
|
300 |
|
301 |
|
302 |
|
303 |
|
304 | function newObject() {
|
305 | return {};
|
306 | }
|