koa 2.14.0 → 3.0.0-alpha.0

package/lib/request.js

@@ -1,23 +1,23 @@
 
-'use strict';
+'use strict'
 
 /**
  * Module dependencies.
  */
 
-const URL = require('url').URL;
-const net = require('net');
-const accepts = require('accepts');
-const contentType = require('content-type');
-const stringify = require('url').format;
-const parse = require('parseurl');
-const qs = require('querystring');
-const typeis = require('type-is');
-const fresh = require('fresh');
-const only = require('only');
-const util = require('util');
+const URL = require('url').URL
+const net = require('net')
+const accepts = require('accepts')
+const contentType = require('content-type')
+const stringify = require('url').format
+const parse = require('parseurl')
+const qs = require('querystring')
+const typeis = require('type-is')
+const fresh = require('fresh')
+const only = require('only')
+const util = require('util')
 
-const IP = Symbol('context#ip');
+const IP = Symbol('context#ip')
 
 /**
  * Prototype.
@@ -32,8 +32,8 @@ module.exports = {
    * @api public
    */
 
-  get header() {
-    return this.req.headers;
+  get header () {
+    return this.req.headers
   },
 
   /**
@@ -42,8 +42,8 @@ module.exports = {
    * @api public
    */
 
-  set header(val) {
-    this.req.headers = val;
+  set header (val) {
+    this.req.headers = val
   },
 
   /**
@@ -53,8 +53,8 @@ module.exports = {
    * @api public
    */
 
-  get headers() {
-    return this.req.headers;
+  get headers () {
+    return this.req.headers
   },
 
   /**
@@ -63,8 +63,8 @@ module.exports = {
    * @api public
    */
 
-  set headers(val) {
-    this.req.headers = val;
+  set headers (val) {
+    this.req.headers = val
   },
 
   /**
@@ -74,8 +74,8 @@ module.exports = {
    * @api public
    */
 
-  get url() {
-    return this.req.url;
+  get url () {
+    return this.req.url
   },
 
   /**
@@ -84,8 +84,8 @@ module.exports = {
    * @api public
    */
 
-  set url(val) {
-    this.req.url = val;
+  set url (val) {
+    this.req.url = val
   },
 
   /**
@@ -95,8 +95,8 @@ module.exports = {
    * @api public
    */
 
-  get origin() {
-    return `${this.protocol}://${this.host}`;
+  get origin () {
+    return `${this.protocol}://${this.host}`
   },
 
   /**
@@ -106,10 +106,10 @@ module.exports = {
    * @api public
    */
 
-  get href() {
+  get href () {
     // support: `GET http://example.com/foo`
-    if (/^https?:\/\//i.test(this.originalUrl)) return this.originalUrl;
-    return this.origin + this.originalUrl;
+    if (/^https?:\/\//i.test(this.originalUrl)) return this.originalUrl
+    return this.origin + this.originalUrl
   },
 
   /**
@@ -119,8 +119,8 @@ module.exports = {
    * @api public
    */
 
-  get method() {
-    return this.req.method;
+  get method () {
+    return this.req.method
   },
 
   /**
@@ -130,8 +130,8 @@ module.exports = {
    * @api public
    */
 
-  set method(val) {
-    this.req.method = val;
+  set method (val) {
+    this.req.method = val
   },
 
   /**
@@ -141,8 +141,8 @@ module.exports = {
    * @api public
    */
 
-  get path() {
-    return parse(this.req).pathname;
+  get path () {
+    return parse(this.req).pathname
   },
 
   /**
@@ -152,14 +152,14 @@ module.exports = {
    * @api public
    */
 
-  set path(path) {
-    const url = parse(this.req);
-    if (url.pathname === path) return;
+  set path (path) {
+    const url = parse(this.req)
+    if (url.pathname === path) return
 
-    url.pathname = path;
-    url.path = null;
+    url.pathname = path
+    url.path = null
 
-    this.url = stringify(url);
+    this.url = stringify(url)
   },
 
   /**
@@ -169,10 +169,10 @@ module.exports = {
    * @api public
    */
 
-  get query() {
-    const str = this.querystring;
-    const c = this._querycache = this._querycache || {};
-    return c[str] || (c[str] = qs.parse(str));
+  get query () {
+    const str = this.querystring
+    const c = this._querycache = this._querycache || {}
+    return c[str] || (c[str] = qs.parse(str))
   },
 
   /**
@@ -182,8 +182,8 @@ module.exports = {
    * @api public
    */
 
-  set query(obj) {
-    this.querystring = qs.stringify(obj);
+  set query (obj) {
+    this.querystring = qs.stringify(obj)
   },
 
   /**
@@ -193,9 +193,9 @@ module.exports = {
    * @api public
    */
 
-  get querystring() {
-    if (!this.req) return '';
-    return parse(this.req).query || '';
+  get querystring () {
+    if (!this.req) return ''
+    return parse(this.req).query || ''
   },
 
   /**
@@ -205,14 +205,14 @@ module.exports = {
    * @api public
    */
 
-  set querystring(str) {
-    const url = parse(this.req);
-    if (url.search === `?${str}`) return;
+  set querystring (str) {
+    const url = parse(this.req)
+    if (url.search === `?${str}`) return
 
-    url.search = str;
-    url.path = null;
+    url.search = str
+    url.path = null
 
-    this.url = stringify(url);
+    this.url = stringify(url)
   },
 
   /**
@@ -223,9 +223,9 @@ module.exports = {
    * @api public
    */
 
-  get search() {
-    if (!this.querystring) return '';
-    return `?${this.querystring}`;
+  get search () {
+    if (!this.querystring) return ''
+    return `?${this.querystring}`
   },
 
   /**
@@ -236,8 +236,8 @@ module.exports = {
    * @api public
    */
 
-  set search(str) {
-    this.querystring = str;
+  set search (str) {
+    this.querystring = str
   },
 
   /**
@@ -249,15 +249,15 @@ module.exports = {
    * @api public
    */
 
-  get host() {
-    const proxy = this.app.proxy;
-    let host = proxy && this.get('X-Forwarded-Host');
+  get host () {
+    const proxy = this.app.proxy
+    let host = proxy && this.get('X-Forwarded-Host')
     if (!host) {
-      if (this.req.httpVersionMajor >= 2) host = this.get(':authority');
-      if (!host) host = this.get('Host');
+      if (this.req.httpVersionMajor >= 2) host = this.get(':authority')
+      if (!host) host = this.get('Host')
     }
-    if (!host) return '';
-    return host.split(/\s*,\s*/, 1)[0];
+    if (!host) return ''
+    return host.split(/\s*,\s*/, 1)[0]
   },
 
   /**
@@ -269,11 +269,11 @@ module.exports = {
    * @api public
    */
 
-  get hostname() {
-    const host = this.host;
-    if (!host) return '';
-    if ('[' === host[0]) return this.URL.hostname || ''; // IPv6
-    return host.split(':', 1)[0];
+  get hostname () {
+    const host = this.host
+    if (!host) return ''
+    if (host[0] === '[') return this.URL.hostname || '' // IPv6
+    return host.split(':', 1)[0]
   },
 
   /**
@@ -284,17 +284,17 @@ module.exports = {
    * @api public
    */
 
-  get URL() {
+  get URL () {
     /* istanbul ignore else */
     if (!this.memoizedURL) {
-      const originalUrl = this.originalUrl || ''; // avoid undefined in template string
+      const originalUrl = this.originalUrl || '' // avoid undefined in template string
       try {
-        this.memoizedURL = new URL(`${this.origin}${originalUrl}`);
+        this.memoizedURL = new URL(`${this.origin}${originalUrl}`)
       } catch (err) {
-        this.memoizedURL = Object.create(null);
+        this.memoizedURL = Object.create(null)
       }
     }
-    return this.memoizedURL;
+    return this.memoizedURL
   },
 
   /**
@@ -306,19 +306,19 @@ module.exports = {
    * @api public
    */
 
-  get fresh() {
-    const method = this.method;
-    const s = this.ctx.status;
+  get fresh () {
+    const method = this.method
+    const s = this.ctx.status
 
     // GET or HEAD for weak freshness validation only
-    if ('GET' !== method && 'HEAD' !== method) return false;
+    if (method !== 'GET' && method !== 'HEAD') return false
 
     // 2xx or 304 as per rfc2616 14.26
-    if ((s >= 200 && s < 300) || 304 === s) {
-      return fresh(this.header, this.response.header);
+    if ((s >= 200 && s < 300) || s === 304) {
+      return fresh(this.header, this.response.header)
     }
 
-    return false;
+    return false
   },
 
   /**
@@ -330,8 +330,8 @@ module.exports = {
    * @api public
    */
 
-  get stale() {
-    return !this.fresh;
+  get stale () {
+    return !this.fresh
   },
 
   /**
@@ -341,9 +341,9 @@ module.exports = {
    * @api public
    */
 
-  get idempotent() {
-    const methods = ['GET', 'HEAD', 'PUT', 'DELETE', 'OPTIONS', 'TRACE'];
-    return !!~methods.indexOf(this.method);
+  get idempotent () {
+    const methods = ['GET', 'HEAD', 'PUT', 'DELETE', 'OPTIONS', 'TRACE']
+    return !!~methods.indexOf(this.method)
   },
 
   /**
@@ -353,8 +353,8 @@ module.exports = {
    * @api public
    */
 
-  get socket() {
-    return this.req.socket;
+  get socket () {
+    return this.req.socket
   },
 
   /**
@@ -364,12 +364,12 @@ module.exports = {
    * @api public
    */
 
-  get charset() {
+  get charset () {
     try {
-      const { parameters } = contentType.parse(this.req);
-      return parameters.charset || '';
+      const { parameters } = contentType.parse(this.req)
+      return parameters.charset || ''
     } catch (e) {
-      return '';
+      return ''
     }
   },
 
@@ -380,10 +380,10 @@ module.exports = {
    * @api public
    */
 
-  get length() {
-    const len = this.get('Content-Length');
-    if (len === '') return;
-    return ~~len;
+  get length () {
+    const len = this.get('Content-Length')
+    if (len === '') return
+    return ~~len
   },
 
   /**
@@ -398,11 +398,11 @@ module.exports = {
    * @api public
    */
 
-  get protocol() {
-    if (this.socket.encrypted) return 'https';
-    if (!this.app.proxy) return 'http';
-    const proto = this.get('X-Forwarded-Proto');
-    return proto ? proto.split(/\s*,\s*/, 1)[0] : 'http';
+  get protocol () {
+    if (this.socket.encrypted) return 'https'
+    if (!this.app.proxy) return 'http'
+    const proto = this.get('X-Forwarded-Proto')
+    return proto ? proto.split(/\s*,\s*/, 1)[0] : 'http'
   },
 
   /**
@@ -414,8 +414,8 @@ module.exports = {
    * @api public
    */
 
-  get secure() {
-    return 'https' === this.protocol;
+  get secure () {
+    return this.protocol === 'https'
   },
 
   /**
@@ -430,16 +430,16 @@ module.exports = {
    * @api public
    */
 
-  get ips() {
-    const proxy = this.app.proxy;
-    const val = this.get(this.app.proxyIpHeader);
+  get ips () {
+    const proxy = this.app.proxy
+    const val = this.get(this.app.proxyIpHeader)
     let ips = proxy && val
       ? val.split(/\s*,\s*/)
-      : [];
+      : []
     if (this.app.maxIpsCount > 0) {
-      ips = ips.slice(-this.app.maxIpsCount);
+      ips = ips.slice(-this.app.maxIpsCount)
     }
-    return ips;
+    return ips
   },
 
   /**
@@ -451,15 +451,15 @@ module.exports = {
    * @api public
    */
 
-  get ip() {
+  get ip () {
     if (!this[IP]) {
-      this[IP] = this.ips[0] || this.socket.remoteAddress || '';
+      this[IP] = this.ips[0] || this.socket.remoteAddress || ''
     }
-    return this[IP];
+    return this[IP]
   },
 
-  set ip(_ip) {
-    this[IP] = _ip;
+  set ip (_ip) {
+    this[IP] = _ip
   },
 
   /**
@@ -478,14 +478,14 @@ module.exports = {
    * @api public
    */
 
-  get subdomains() {
-    const offset = this.app.subdomainOffset;
-    const hostname = this.hostname;
-    if (net.isIP(hostname)) return [];
+  get subdomains () {
+    const offset = this.app.subdomainOffset
+    const hostname = this.hostname
+    if (net.isIP(hostname)) return []
     return hostname
       .split('.')
       .reverse()
-      .slice(offset);
+      .slice(offset)
   },
 
   /**
@@ -496,8 +496,8 @@ module.exports = {
    * @api private
    */
 
-  get accept() {
-    return this._accept || (this._accept = accepts(this.req));
+  get accept () {
+    return this._accept || (this._accept = accepts(this.req))
   },
 
   /**
@@ -507,8 +507,8 @@ module.exports = {
    * @api private
    */
 
-  set accept(obj) {
-    this._accept = obj;
+  set accept (obj) {
+    this._accept = obj
   },
 
   /**
@@ -552,8 +552,8 @@ module.exports = {
    * @api public
    */
 
-  accepts(...args) {
-    return this.accept.types(...args);
+  accepts (...args) {
+    return this.accept.types(...args)
   },
 
   /**
@@ -569,8 +569,8 @@ module.exports = {
    * @api public
    */
 
-  acceptsEncodings(...args) {
-    return this.accept.encodings(...args);
+  acceptsEncodings (...args) {
+    return this.accept.encodings(...args)
   },
 
   /**
@@ -586,8 +586,8 @@ module.exports = {
    * @api public
    */
 
-  acceptsCharsets(...args) {
-    return this.accept.charsets(...args);
+  acceptsCharsets (...args) {
+    return this.accept.charsets(...args)
   },
 
   /**
@@ -603,8 +603,8 @@ module.exports = {
    * @api public
    */
 
-  acceptsLanguages(...args) {
-    return this.accept.languages(...args);
+  acceptsLanguages (...args) {
+    return this.accept.languages(...args)
   },
 
   /**
@@ -634,8 +634,8 @@ module.exports = {
    * @api public
    */
 
-  is(type, ...types) {
-    return typeis(this.req, type, ...types);
+  is (type, ...types) {
+    return typeis(this.req, type, ...types)
   },
 
   /**
@@ -646,10 +646,10 @@ module.exports = {
    * @api public
    */
 
-  get type() {
-    const type = this.get('Content-Type');
-    if (!type) return '';
-    return type.split(';')[0];
+  get type () {
+    const type = this.get('Content-Type')
+    if (!type) return ''
+    return type.split(';')[0]
   },
 
   /**
@@ -674,14 +674,14 @@ module.exports = {
    * @api public
    */
 
-  get(field) {
-    const req = this.req;
+  get (field) {
+    const req = this.req
     switch (field = field.toLowerCase()) {
       case 'referer':
       case 'referrer':
-        return req.headers.referrer || req.headers.referer || '';
+        return req.headers.referrer || req.headers.referer || ''
       default:
-        return req.headers[field] || '';
+        return req.headers[field] || ''
     }
   },
 
@@ -692,9 +692,9 @@ module.exports = {
    * @api public
    */
 
-  inspect() {
-    if (!this.req) return;
-    return this.toJSON();
+  inspect () {
+    if (!this.req) return
+    return this.toJSON()
   },
 
   /**
@@ -704,14 +704,14 @@ module.exports = {
    * @api public
    */
 
-  toJSON() {
+  toJSON () {
     return only(this, [
       'method',
       'url',
       'header'
-    ]);
+    ])
   }
-};
+}
 
 /**
  * Custom inspection implementation for newer Node.js versions.
@@ -722,5 +722,5 @@ module.exports = {
 
 /* istanbul ignore else */
 if (util.inspect.custom) {
-  module.exports[util.inspect.custom] = module.exports.inspect;
+  module.exports[util.inspect.custom] = module.exports.inspect
 }