@eggjs/koa 3.0.0 → 3.1.0-beta.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/dist/response.js CHANGED
@@ -1,472 +1,387 @@
1
- import assert from 'node:assert';
2
- import { extname } from 'node:path';
3
- import util from 'node:util';
4
- import Stream from 'node:stream';
5
- import contentDisposition, {} from 'content-disposition';
6
- import { getType } from 'cache-content-type';
7
- import onFinish from 'on-finished';
8
- import escape from 'escape-html';
9
- import { is as typeis } from 'type-is';
10
- import statuses from 'statuses';
11
- import destroy from 'destroy';
12
- import vary from 'vary';
13
- import encodeUrl from 'encodeurl';
14
- export class Response {
15
- app;
16
- req;
17
- res;
18
- ctx;
19
- request;
20
- constructor(app, ctx, req, res) {
21
- this.app = app;
22
- this.req = req;
23
- this.res = res;
24
- this.ctx = ctx;
25
- }
26
- /**
27
- * Return the request socket.
28
- */
29
- get socket() {
30
- return this.res.socket;
31
- }
32
- /**
33
- * Return response header.
34
- */
35
- get header() {
36
- return this.res.getHeaders() || {};
37
- }
38
- /**
39
- * Return response header, alias as response.header
40
- */
41
- get headers() {
42
- return this.header;
43
- }
44
- _explicitStatus;
45
- /**
46
- * Get response status code.
47
- */
48
- get status() {
49
- return this.res.statusCode;
50
- }
51
- /**
52
- * Set response status code.
53
- */
54
- set status(code) {
55
- if (this.headerSent)
56
- return;
57
- assert.ok(Number.isInteger(code), 'status code must be a number');
58
- assert.ok(code >= 100 && code <= 999, `invalid status code: ${code}`);
59
- this._explicitStatus = true;
60
- this.res.statusCode = code;
61
- if (this.req.httpVersionMajor < 2 && statuses.message[code]) {
62
- this.res.statusMessage = statuses.message[code];
63
- }
64
- if (this.body && statuses.empty[code]) {
65
- this.body = null;
66
- }
67
- }
68
- /**
69
- * Get response status message
70
- */
71
- get message() {
72
- return this.res.statusMessage ?? statuses.message[this.status];
73
- }
74
- /**
75
- * Set response status message
76
- */
77
- set message(msg) {
78
- this.res.statusMessage = msg;
79
- }
80
- // oxlint-disable-next-line typescript/no-explicit-any
81
- _body;
82
- _explicitNullBody;
83
- /**
84
- * Get response body.
85
- */
86
- get body() {
87
- return this._body;
88
- }
89
- /**
90
- * Set response body.
91
- */
92
- set body(val) {
93
- const original = this._body;
94
- this._body = val;
95
- // no content
96
- if (val === null || val === undefined) {
97
- if (!statuses.empty[this.status]) {
98
- this.status = 204;
99
- }
100
- if (val === null) {
101
- this._explicitNullBody = true;
102
- }
103
- this.remove('Content-Type');
104
- this.remove('Content-Length');
105
- this.remove('Transfer-Encoding');
106
- return;
107
- }
108
- // set the status
109
- if (!this._explicitStatus)
110
- this.status = 200;
111
- // set the content-type only if not yet set
112
- const setType = !this.has('Content-Type');
113
- // string
114
- if (typeof val === 'string') {
115
- if (setType)
116
- this.type = /^\s*?</.test(val) ? 'html' : 'text';
117
- this.length = Buffer.byteLength(val);
118
- return;
119
- }
120
- // buffer
121
- if (Buffer.isBuffer(val)) {
122
- if (setType)
123
- this.type = 'bin';
124
- this.length = val.length;
125
- return;
126
- }
127
- // stream
128
- if (val instanceof Stream) {
129
- onFinish(this.res, destroy.bind(null, val));
130
- // oxlint-disable-next-line eqeqeq
131
- if (original != val) {
132
- val.once('error', err => this.ctx.onerror(err));
133
- // overwriting
134
- if (original !== null && original !== undefined) {
135
- this.remove('Content-Length');
136
- }
137
- }
138
- if (setType) {
139
- this.type = 'bin';
140
- }
141
- return;
142
- }
143
- // json
144
- this.remove('Content-Length');
145
- this.type = 'json';
146
- }
147
- /**
148
- * Set Content-Length field to `n`.
149
- */
150
- set length(n) {
151
- if (n === undefined)
152
- return;
153
- if (!this.has('Transfer-Encoding')) {
154
- this.set('Content-Length', n);
155
- }
156
- }
157
- /**
158
- * Return parsed response Content-Length when present.
159
- *
160
- * When Content-Length is not defined it will return `undefined`.
161
- */
162
- get length() {
163
- if (this.has('Content-Length')) {
164
- return Number.parseInt(this.get('Content-Length')) || 0;
165
- }
166
- const { body } = this;
167
- if (!body || body instanceof Stream) {
168
- return undefined;
169
- }
170
- if (typeof body === 'string') {
171
- return Buffer.byteLength(body);
172
- }
173
- if (Buffer.isBuffer(body)) {
174
- return body.length;
175
- }
176
- return Buffer.byteLength(JSON.stringify(body));
177
- }
178
- /**
179
- * Check if a header has been written to the socket.
180
- */
181
- get headerSent() {
182
- return this.res.headersSent;
183
- }
184
- /**
185
- * Vary on `field`.
186
- */
187
- vary(field) {
188
- if (this.headerSent)
189
- return;
190
- vary(this.res, field);
191
- }
192
- _getBackReferrer() {
193
- const referrer = this.ctx.get('Referrer');
194
- if (referrer) {
195
- // referrer is a relative path
196
- if (referrer.startsWith('/')) {
197
- return referrer;
198
- }
199
- // referrer is an absolute URL, check if it's the same origin
200
- const url = new URL(referrer, this.ctx.href);
201
- if (url.host === this.ctx.host) {
202
- return referrer;
203
- }
204
- }
205
- }
206
- /**
207
- * Perform a 302 redirect to `url`.
208
- *
209
- * The string "back" is special-cased
210
- * to provide Referrer support, when Referrer
211
- * is not present `alt` or "/" is used.
212
- *
213
- * Examples:
214
- *
215
- * this.redirect('back');
216
- * this.redirect('back', '/index.html');
217
- * this.redirect('/login');
218
- * this.redirect('http://google.com'); // will format to 'http://google.com/'
219
- */
220
- redirect(url, alt) {
221
- // location
222
- if (url === 'back') {
223
- url = this._getBackReferrer() || alt || '/';
224
- }
225
- if (url.startsWith('https://') || url.startsWith('http://')) {
226
- // formatting url again avoid security escapes
227
- url = new URL(url).toString();
228
- }
229
- this.set('Location', encodeUrl(url));
230
- // status
231
- if (!statuses.redirect[this.status])
232
- this.status = 302;
233
- // html
234
- if (this.ctx.accepts('html')) {
235
- url = escape(url);
236
- this.type = 'text/html; charset=utf-8';
237
- this.body = `Redirecting to ${url}.`;
238
- return;
239
- }
240
- // text
241
- this.type = 'text/plain; charset=utf-8';
242
- this.body = `Redirecting to ${url}.`;
243
- }
244
- /**
245
- * Set Content-Disposition header to "attachment" with optional `filename`.
246
- */
247
- attachment(filename, options) {
248
- if (filename)
249
- this.type = extname(filename);
250
- this.set('Content-Disposition', contentDisposition(filename, options));
251
- }
252
- /**
253
- * Set Content-Type response header with `type` through `mime.lookup()`
254
- * when it does not contain a charset.
255
- *
256
- * Examples:
257
- *
258
- * this.type = '.html';
259
- * this.type = 'html';
260
- * this.type = 'json';
261
- * this.type = 'application/json';
262
- * this.type = 'png';
263
- */
264
- set type(type) {
265
- if (!type) {
266
- this.remove('Content-Type');
267
- return;
268
- }
269
- const mimeType = getType(type);
270
- if (mimeType) {
271
- this.set('Content-Type', mimeType);
272
- }
273
- }
274
- /**
275
- * Return the response mime type void of
276
- * parameters such as "charset".
277
- */
278
- get type() {
279
- const type = this.get('Content-Type');
280
- if (!type)
281
- return '';
282
- return type.split(';', 1)[0];
283
- }
284
- /**
285
- * Check whether the response is one of the listed types.
286
- * Pretty much the same as `this.request.is()`.
287
- *
288
- * this.response.is('html')
289
- * this.response.is('html', 'json')
290
- */
291
- is(type, ...types) {
292
- let testTypes = [];
293
- if (type) {
294
- testTypes = Array.isArray(type) ? type : [type];
295
- }
296
- return typeis(this.type, [...testTypes, ...types]);
297
- }
298
- /**
299
- * Set the Last-Modified date using a string or a Date.
300
- *
301
- * this.response.lastModified = new Date();
302
- * this.response.lastModified = '2013-09-13';
303
- */
304
- set lastModified(val) {
305
- if (typeof val === 'string')
306
- val = new Date(val);
307
- if (val) {
308
- this.set('Last-Modified', val.toUTCString());
309
- }
310
- }
311
- /**
312
- * Get the Last-Modified date in Date form, if it exists.
313
- */
314
- get lastModified() {
315
- const date = this.get('last-modified');
316
- if (date)
317
- return new Date(date);
318
- }
319
- /**
320
- * Set the ETag of a response.
321
- * This will normalize the quotes if necessary.
322
- *
323
- * this.response.etag = 'md5-hash-sum';
324
- * this.response.etag = '"md5-hash-sum"';
325
- * this.response.etag = 'W/"123456789"';
326
- */
327
- set etag(val) {
328
- if (!/^(W\/)?"/.test(val))
329
- val = `"${val}"`;
330
- this.set('ETag', val);
331
- }
332
- /**
333
- * Get the ETag of a response.
334
- */
335
- get etag() {
336
- return this.get('ETag');
337
- }
338
- /**
339
- * Return response header.
340
- *
341
- * Examples:
342
- *
343
- * this.get('Content-Type');
344
- * // => "text/plain"
345
- *
346
- * this.get('content-type');
347
- * // => "text/plain"
348
- */
349
- get(field) {
350
- return (this.header[field.toLowerCase()] || '');
351
- }
352
- /**
353
- * Returns true if the header identified by name is currently set in the outgoing headers.
354
- * The header name matching is case-insensitive.
355
- *
356
- * Examples:
357
- *
358
- * this.has('Content-Type');
359
- * // => true
360
- *
361
- * this.get('content-type');
362
- * // => true
363
- */
364
- has(field) {
365
- return this.res.hasHeader(field);
366
- }
367
- /**
368
- * Set header `field` to `val` or pass
369
- * an object of header fields.
370
- *
371
- * Examples:
372
- *
373
- * this.set('Foo', ['bar', 'baz']);
374
- * this.set('Accept', 'application/json');
375
- * this.set({ Accept: 'text/plain', 'X-API-Key': 'tobi' });
376
- */
377
- set(field, val) {
378
- if (this.headerSent)
379
- return;
380
- if (typeof field === 'string') {
381
- let value = val;
382
- if (Array.isArray(val)) {
383
- value = val.map(v => (typeof v === 'string' ? v : String(v)));
384
- }
385
- else if (typeof val !== 'string') {
386
- value = String(val);
387
- }
388
- this.res.setHeader(field, value);
389
- }
390
- else {
391
- for (const key in field) {
392
- this.set(key, field[key]);
393
- }
394
- }
395
- }
396
- /**
397
- * Append additional header `field` with value `val`.
398
- *
399
- * Examples:
400
- *
401
- * ```
402
- * this.append('Link', ['<http://localhost/>', '<http://localhost:3000/>']);
403
- * this.append('Set-Cookie', 'foo=bar; Path=/; HttpOnly');
404
- * this.append('Warning', '199 Miscellaneous warning');
405
- */
406
- append(field, val) {
407
- const prev = this.get(field);
408
- let value = val;
409
- if (prev) {
410
- value = Array.isArray(prev) ? prev.concat(value) : [prev].concat(val);
411
- }
412
- return this.set(field, value);
413
- }
414
- /**
415
- * Remove header `field`.
416
- */
417
- remove(field) {
418
- if (this.headerSent)
419
- return;
420
- this.res.removeHeader(field);
421
- }
422
- /**
423
- * Checks if the request is writable.
424
- * Tests for the existence of the socket
425
- * as node sometimes does not set it.
426
- */
427
- get writable() {
428
- // can't write any more after response finished
429
- // response.writableEnded is available since Node > 12.9
430
- // https://nodejs.org/api/http.html#http_response_writableended
431
- // response.finished is undocumented feature of previous Node versions
432
- // https://stackoverflow.com/questions/16254385/undocumented-response-finished-in-node-js
433
- if (this.res.writableEnded || this.res.finished)
434
- return false;
435
- const socket = this.res.socket;
436
- // There are already pending outgoing res, but still writable
437
- // https://github.com/nodejs/node/blob/v4.4.7/lib/_http_server.js#L486
438
- if (!socket)
439
- return true;
440
- return socket.writable;
441
- }
442
- /**
443
- * Inspect implementation.
444
- */
445
- inspect() {
446
- if (!this.res)
447
- return;
448
- const o = this.toJSON();
449
- Reflect.set(o, 'body', this.body);
450
- return o;
451
- }
452
- [util.inspect.custom]() {
453
- return this.inspect();
454
- }
455
- /**
456
- * Return JSON representation.
457
- */
458
- toJSON() {
459
- return {
460
- status: this.status,
461
- message: this.message,
462
- header: this.header,
463
- };
464
- }
465
- /**
466
- * Flush any set headers and begin the body
467
- */
468
- flushHeaders() {
469
- this.res.flushHeaders();
470
- }
471
- }
472
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVzcG9uc2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvcmVzcG9uc2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxNQUFNLE1BQU0sYUFBYSxDQUFDO0FBQ2pDLE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxXQUFXLENBQUM7QUFDcEMsT0FBTyxJQUFJLE1BQU0sV0FBVyxDQUFDO0FBQzdCLE9BQU8sTUFBTSxNQUFNLGFBQWEsQ0FBQztBQUdqQyxPQUFPLGtCQUFrQixFQUFFLEVBRTFCLE1BQU0scUJBQXFCLENBQUM7QUFDN0IsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBQzdDLE9BQU8sUUFBUSxNQUFNLGFBQWEsQ0FBQztBQUNuQyxPQUFPLE1BQU0sTUFBTSxhQUFhLENBQUM7QUFDakMsT0FBTyxFQUFFLEVBQUUsSUFBSSxNQUFNLEVBQUUsTUFBTSxTQUFTLENBQUM7QUFDdkMsT0FBTyxRQUFRLE1BQU0sVUFBVSxDQUFDO0FBQ2hDLE9BQU8sT0FBTyxNQUFNLFNBQVMsQ0FBQztBQUM5QixPQUFPLElBQUksTUFBTSxNQUFNLENBQUM7QUFDeEIsT0FBTyxTQUFTLE1BQU0sV0FBVyxDQUFDO0FBTWxDLE1BQU0sT0FBTyxRQUFRO0lBRW5CLEdBQUcsQ0FBYztJQUNqQixHQUFHLENBQWtCO0lBQ3JCLEdBQUcsQ0FBaUI7SUFDcEIsR0FBRyxDQUFVO0lBQ2IsT0FBTyxDQUFVO0lBRWpCLFlBQ0UsR0FBZ0IsRUFDaEIsR0FBWSxFQUNaLEdBQW9CLEVBQ3BCLEdBQW1CO1FBRW5CLElBQUksQ0FBQyxHQUFHLEdBQUcsR0FBRyxDQUFDO1FBQ2YsSUFBSSxDQUFDLEdBQUcsR0FBRyxHQUFHLENBQUM7UUFDZixJQUFJLENBQUMsR0FBRyxHQUFHLEdBQUcsQ0FBQztRQUNmLElBQUksQ0FBQyxHQUFHLEdBQUcsR0FBRyxDQUFDO0lBQ2pCLENBQUM7SUFFRDs7T0FFRztJQUNILElBQUksTUFBTTtRQUNS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
1
+ import util from "node:util";
2
+ import Stream from "node:stream";
3
+ import onFinished from "on-finished";
4
+ import statuses from "statuses";
5
+ import { is } from "type-is";
6
+ import assert from "node:assert";
7
+ import { extname } from "node:path";
8
+ import contentDisposition from "content-disposition";
9
+ import { getType } from "cache-content-type";
10
+ import escape from "escape-html";
11
+ import destroy from "destroy";
12
+ import vary from "vary";
13
+ import encodeUrl from "encodeurl";
14
+
15
+ //#region src/response.ts
16
+ var Response = class {
17
+ app;
18
+ req;
19
+ res;
20
+ ctx;
21
+ request;
22
+ constructor(app, ctx, req, res) {
23
+ this.app = app;
24
+ this.req = req;
25
+ this.res = res;
26
+ this.ctx = ctx;
27
+ }
28
+ /**
29
+ * Return the request socket.
30
+ */
31
+ get socket() {
32
+ return this.res.socket;
33
+ }
34
+ /**
35
+ * Return response header.
36
+ */
37
+ get header() {
38
+ return this.res.getHeaders() || {};
39
+ }
40
+ /**
41
+ * Return response header, alias as response.header
42
+ */
43
+ get headers() {
44
+ return this.header;
45
+ }
46
+ _explicitStatus;
47
+ /**
48
+ * Get response status code.
49
+ */
50
+ get status() {
51
+ return this.res.statusCode;
52
+ }
53
+ /**
54
+ * Set response status code.
55
+ */
56
+ set status(code) {
57
+ if (this.headerSent) return;
58
+ assert.ok(Number.isInteger(code), "status code must be a number");
59
+ assert.ok(code >= 100 && code <= 999, `invalid status code: ${code}`);
60
+ this._explicitStatus = true;
61
+ this.res.statusCode = code;
62
+ if (this.req.httpVersionMajor < 2 && statuses.message[code]) this.res.statusMessage = statuses.message[code];
63
+ if (this.body && statuses.empty[code]) this.body = null;
64
+ }
65
+ /**
66
+ * Get response status message
67
+ */
68
+ get message() {
69
+ return this.res.statusMessage ?? statuses.message[this.status];
70
+ }
71
+ /**
72
+ * Set response status message
73
+ */
74
+ set message(msg) {
75
+ this.res.statusMessage = msg;
76
+ }
77
+ _body;
78
+ _explicitNullBody;
79
+ /**
80
+ * Get response body.
81
+ */
82
+ get body() {
83
+ return this._body;
84
+ }
85
+ /**
86
+ * Set response body.
87
+ */
88
+ set body(val) {
89
+ const original = this._body;
90
+ this._body = val;
91
+ if (val === null || val === void 0) {
92
+ if (!statuses.empty[this.status]) this.status = 204;
93
+ if (val === null) this._explicitNullBody = true;
94
+ this.remove("Content-Type");
95
+ this.remove("Content-Length");
96
+ this.remove("Transfer-Encoding");
97
+ return;
98
+ }
99
+ if (!this._explicitStatus) this.status = 200;
100
+ const setType = !this.has("Content-Type");
101
+ if (typeof val === "string") {
102
+ if (setType) this.type = /^\s*?</.test(val) ? "html" : "text";
103
+ this.length = Buffer.byteLength(val);
104
+ return;
105
+ }
106
+ if (Buffer.isBuffer(val)) {
107
+ if (setType) this.type = "bin";
108
+ this.length = val.length;
109
+ return;
110
+ }
111
+ if (val instanceof Stream) {
112
+ onFinished(this.res, destroy.bind(null, val));
113
+ if (original != val) {
114
+ val.once("error", (err) => this.ctx.onerror(err));
115
+ if (original !== null && original !== void 0) this.remove("Content-Length");
116
+ }
117
+ if (setType) this.type = "bin";
118
+ return;
119
+ }
120
+ this.remove("Content-Length");
121
+ this.type = "json";
122
+ }
123
+ /**
124
+ * Set Content-Length field to `n`.
125
+ */
126
+ set length(n) {
127
+ if (n === void 0) return;
128
+ if (!this.has("Transfer-Encoding")) this.set("Content-Length", n);
129
+ }
130
+ /**
131
+ * Return parsed response Content-Length when present.
132
+ *
133
+ * When Content-Length is not defined it will return `undefined`.
134
+ */
135
+ get length() {
136
+ if (this.has("Content-Length")) return Number.parseInt(this.get("Content-Length")) || 0;
137
+ const body = this.body;
138
+ if (!body || body instanceof Stream) return;
139
+ if (typeof body === "string") return Buffer.byteLength(body);
140
+ if (Buffer.isBuffer(body)) return body.length;
141
+ return Buffer.byteLength(JSON.stringify(body));
142
+ }
143
+ /**
144
+ * Check if a header has been written to the socket.
145
+ */
146
+ get headerSent() {
147
+ return this.res.headersSent;
148
+ }
149
+ /**
150
+ * Vary on `field`.
151
+ */
152
+ vary(field) {
153
+ if (this.headerSent) return;
154
+ vary(this.res, field);
155
+ }
156
+ _getBackReferrer() {
157
+ const referrer = this.ctx.get("Referrer");
158
+ if (referrer) {
159
+ if (referrer.startsWith("/")) return referrer;
160
+ if (new URL(referrer, this.ctx.href).host === this.ctx.host) return referrer;
161
+ }
162
+ }
163
+ /**
164
+ * Perform a 302 redirect to `url`.
165
+ *
166
+ * The string "back" is special-cased
167
+ * to provide Referrer support, when Referrer
168
+ * is not present `alt` or "/" is used.
169
+ *
170
+ * Examples:
171
+ *
172
+ * this.redirect('back');
173
+ * this.redirect('back', '/index.html');
174
+ * this.redirect('/login');
175
+ * this.redirect('http://google.com'); // will format to 'http://google.com/'
176
+ */
177
+ redirect(url, alt) {
178
+ if (url === "back") url = this._getBackReferrer() || alt || "/";
179
+ if (url.startsWith("https://") || url.startsWith("http://")) url = new URL(url).toString();
180
+ this.set("Location", encodeUrl(url));
181
+ if (!statuses.redirect[this.status]) this.status = 302;
182
+ if (this.ctx.accepts("html")) {
183
+ url = escape(url);
184
+ this.type = "text/html; charset=utf-8";
185
+ this.body = `Redirecting to ${url}.`;
186
+ return;
187
+ }
188
+ this.type = "text/plain; charset=utf-8";
189
+ this.body = `Redirecting to ${url}.`;
190
+ }
191
+ /**
192
+ * Set Content-Disposition header to "attachment" with optional `filename`.
193
+ */
194
+ attachment(filename, options) {
195
+ if (filename) this.type = extname(filename);
196
+ this.set("Content-Disposition", contentDisposition(filename, options));
197
+ }
198
+ /**
199
+ * Set Content-Type response header with `type` through `mime.lookup()`
200
+ * when it does not contain a charset.
201
+ *
202
+ * Examples:
203
+ *
204
+ * this.type = '.html';
205
+ * this.type = 'html';
206
+ * this.type = 'json';
207
+ * this.type = 'application/json';
208
+ * this.type = 'png';
209
+ */
210
+ set type(type) {
211
+ if (!type) {
212
+ this.remove("Content-Type");
213
+ return;
214
+ }
215
+ const mimeType = getType(type);
216
+ if (mimeType) this.set("Content-Type", mimeType);
217
+ }
218
+ /**
219
+ * Return the response mime type void of
220
+ * parameters such as "charset".
221
+ */
222
+ get type() {
223
+ const type = this.get("Content-Type");
224
+ if (!type) return "";
225
+ return type.split(";", 1)[0];
226
+ }
227
+ /**
228
+ * Check whether the response is one of the listed types.
229
+ * Pretty much the same as `this.request.is()`.
230
+ *
231
+ * this.response.is('html')
232
+ * this.response.is('html', 'json')
233
+ */
234
+ is(type, ...types) {
235
+ let testTypes = [];
236
+ if (type) testTypes = Array.isArray(type) ? type : [type];
237
+ return is(this.type, [...testTypes, ...types]);
238
+ }
239
+ /**
240
+ * Set the Last-Modified date using a string or a Date.
241
+ *
242
+ * this.response.lastModified = new Date();
243
+ * this.response.lastModified = '2013-09-13';
244
+ */
245
+ set lastModified(val) {
246
+ if (typeof val === "string") val = new Date(val);
247
+ if (val) this.set("Last-Modified", val.toUTCString());
248
+ }
249
+ /**
250
+ * Get the Last-Modified date in Date form, if it exists.
251
+ */
252
+ get lastModified() {
253
+ const date = this.get("last-modified");
254
+ if (date) return new Date(date);
255
+ }
256
+ /**
257
+ * Set the ETag of a response.
258
+ * This will normalize the quotes if necessary.
259
+ *
260
+ * this.response.etag = 'md5-hash-sum';
261
+ * this.response.etag = '"md5-hash-sum"';
262
+ * this.response.etag = 'W/"123456789"';
263
+ */
264
+ set etag(val) {
265
+ if (!/^(W\/)?"/.test(val)) val = `"${val}"`;
266
+ this.set("ETag", val);
267
+ }
268
+ /**
269
+ * Get the ETag of a response.
270
+ */
271
+ get etag() {
272
+ return this.get("ETag");
273
+ }
274
+ /**
275
+ * Return response header.
276
+ *
277
+ * Examples:
278
+ *
279
+ * this.get('Content-Type');
280
+ * // => "text/plain"
281
+ *
282
+ * this.get('content-type');
283
+ * // => "text/plain"
284
+ */
285
+ get(field) {
286
+ return this.header[field.toLowerCase()] || "";
287
+ }
288
+ /**
289
+ * Returns true if the header identified by name is currently set in the outgoing headers.
290
+ * The header name matching is case-insensitive.
291
+ *
292
+ * Examples:
293
+ *
294
+ * this.has('Content-Type');
295
+ * // => true
296
+ *
297
+ * this.get('content-type');
298
+ * // => true
299
+ */
300
+ has(field) {
301
+ return this.res.hasHeader(field);
302
+ }
303
+ /**
304
+ * Set header `field` to `val` or pass
305
+ * an object of header fields.
306
+ *
307
+ * Examples:
308
+ *
309
+ * this.set('Foo', ['bar', 'baz']);
310
+ * this.set('Accept', 'application/json');
311
+ * this.set({ Accept: 'text/plain', 'X-API-Key': 'tobi' });
312
+ */
313
+ set(field, val) {
314
+ if (this.headerSent) return;
315
+ if (typeof field === "string") {
316
+ let value = val;
317
+ if (Array.isArray(val)) value = val.map((v) => typeof v === "string" ? v : String(v));
318
+ else if (typeof val !== "string") value = String(val);
319
+ this.res.setHeader(field, value);
320
+ } else for (const key in field) this.set(key, field[key]);
321
+ }
322
+ /**
323
+ * Append additional header `field` with value `val`.
324
+ *
325
+ * Examples:
326
+ *
327
+ * ```
328
+ * this.append('Link', ['<http://localhost/>', '<http://localhost:3000/>']);
329
+ * this.append('Set-Cookie', 'foo=bar; Path=/; HttpOnly');
330
+ * this.append('Warning', '199 Miscellaneous warning');
331
+ */
332
+ append(field, val) {
333
+ const prev = this.get(field);
334
+ let value = val;
335
+ if (prev) value = Array.isArray(prev) ? prev.concat(value) : [prev].concat(val);
336
+ return this.set(field, value);
337
+ }
338
+ /**
339
+ * Remove header `field`.
340
+ */
341
+ remove(field) {
342
+ if (this.headerSent) return;
343
+ this.res.removeHeader(field);
344
+ }
345
+ /**
346
+ * Checks if the request is writable.
347
+ * Tests for the existence of the socket
348
+ * as node sometimes does not set it.
349
+ */
350
+ get writable() {
351
+ if (this.res.writableEnded || this.res.finished) return false;
352
+ const socket = this.res.socket;
353
+ if (!socket) return true;
354
+ return socket.writable;
355
+ }
356
+ /**
357
+ * Inspect implementation.
358
+ */
359
+ inspect() {
360
+ if (!this.res) return;
361
+ const o = this.toJSON();
362
+ Reflect.set(o, "body", this.body);
363
+ return o;
364
+ }
365
+ [util.inspect.custom]() {
366
+ return this.inspect();
367
+ }
368
+ /**
369
+ * Return JSON representation.
370
+ */
371
+ toJSON() {
372
+ return {
373
+ status: this.status,
374
+ message: this.message,
375
+ header: this.header
376
+ };
377
+ }
378
+ /**
379
+ * Flush any set headers and begin the body
380
+ */
381
+ flushHeaders() {
382
+ this.res.flushHeaders();
383
+ }
384
+ };
385
+
386
+ //#endregion
387
+ export { Response };