Launch Week Day 5: Introducing Reachability for PHP.Learn More →
Socket
Book a DemoSign in
Socket
Book a DemoSign in

koa

Package Overview
Dependencies
Maintainers
11
Versions
124
Alerts
File Explorer

Advanced tools

License
Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

koa - npm Package Compare versions

Comparing version
2.14.1
 to
3.0.0-alpha.0
+142
-132
lib/application.js
'use strict';
'use strict'

@@ -8,20 +8,31 @@ /**

const isGeneratorFunction = require('is-generator-function');
const debug = require('debug')('koa:application');
const onFinished = require('on-finished');
const assert = require('assert');
const response = require('./response');
const compose = require('koa-compose');
const context = require('./context');
const request = require('./request');
const statuses = require('statuses');
const Emitter = require('events');
const util = require('util');
const Stream = require('stream');
const http = require('http');
const only = require('only');
const convert = require('koa-convert');
const deprecate = require('depd')('koa');
const { HttpError } = require('http-errors');
const debug = require('debug')('koa:application')
const assert = require('assert')
const onFinished = require('on-finished')
const response = require('./response')
const compose = require('koa-compose')
const context = require('./context')
const request = require('./request')
const statuses = require('statuses')
const Emitter = require('events')
const util = require('util')
const Stream = require('stream')
const http = require('http')
const only = require('only')
const { HttpError } = require('http-errors')
/** @typedef {typeof import ('./context') & {
* app: Application
* req: import('http').IncomingMessage
* res: import('http').ServerResponse
* request: KoaRequest
* response: KoaResponse
* state: any
* originalUrl: string
* }} Context */
/** @typedef {typeof import('./request')} KoaRequest */
/** @typedef {typeof import('./response')} KoaResponse */
/**

@@ -51,25 +62,26 @@ * Expose `Application` class.

constructor(options) {
super();
options = options || {};
this.proxy = options.proxy || false;
this.subdomainOffset = options.subdomainOffset || 2;
this.proxyIpHeader = options.proxyIpHeader || 'X-Forwarded-For';
this.maxIpsCount = options.maxIpsCount || 0;
this.env = options.env || process.env.NODE_ENV || 'development';
if (options.keys) this.keys = options.keys;
this.middleware = [];
this.context = Object.create(context);
this.request = Object.create(request);
this.response = Object.create(response);
constructor (options) {
super()
options = options || {}
this.proxy = options.proxy || false
this.subdomainOffset = options.subdomainOffset || 2
this.proxyIpHeader = options.proxyIpHeader || 'X-Forwarded-For'
this.maxIpsCount = options.maxIpsCount || 0
this.env = options.env || process.env.NODE_ENV || 'development'
this.compose = options.compose || compose
if (options.keys) this.keys = options.keys
this.middleware = []
this.context = Object.create(context)
this.request = Object.create(request)
this.response = Object.create(response)
// util.inspect.custom support for node 6+
/* istanbul ignore else */
if (util.inspect.custom) {
this[util.inspect.custom] = this.inspect;
this[util.inspect.custom] = this.inspect
}
if (options.asyncLocalStorage) {
const { AsyncLocalStorage } = require('async_hooks');
assert(AsyncLocalStorage, 'Requires node 12.17.0 or higher to enable asyncLocalStorage');
this.ctxStorage = new AsyncLocalStorage();
this.use(this.createAsyncCtxStorageMiddleware());
const { AsyncLocalStorage } = require('async_hooks')
assert(AsyncLocalStorage, 'Requires node 12.17.0 or higher to enable asyncLocalStorage')
this.ctxStorage = new AsyncLocalStorage()
this.use(this.createAsyncCtxStorageMiddleware())
}

@@ -84,10 +96,10 @@ }

* @param {Mixed} ...
* @return {Server}
* @return {import('http').Server}
* @api public
*/
listen(...args) {
debug('listen');
const server = http.createServer(this.callback());
return server.listen(...args);
listen (...args) {
debug('listen')
const server = http.createServer(this.callback())
return server.listen(...args)
}

@@ -103,3 +115,3 @@

toJSON() {
toJSON () {
return only(this, [

@@ -109,3 +121,3 @@ 'subdomainOffset',

'env'
]);
])
}

@@ -120,4 +132,4 @@

inspect() {
return this.toJSON();
inspect () {
return this.toJSON()
}

@@ -130,3 +142,3 @@

*
* @param {Function} fn
* @param {(context: Context) => Promise<any | void>} fn
* @return {Application} self

@@ -136,13 +148,7 @@ * @api public

use(fn) {
if (typeof fn !== 'function') throw new TypeError('middleware must be a function!');
if (isGeneratorFunction(fn)) {
deprecate('Support for generators will be removed in v3. ' +
'See the documentation for examples of how to convert old middleware ' +
'https://github.com/koajs/koa/blob/master/docs/migration.md');
fn = convert(fn);
}
debug('use %s', fn._name || fn.name || '-');
this.middleware.push(fn);
return this;
use (fn) {
if (typeof fn !== 'function') throw new TypeError('middleware must be a function!')
debug('use %s', fn._name || fn.name || '-')
this.middleware.push(fn)
return this
}

@@ -158,20 +164,20 @@

callback() {
const fn = compose(this.middleware);
callback () {
const fn = this.compose(this.middleware)
if (!this.listenerCount('error')) this.on('error', this.onerror);
if (!this.listenerCount('error')) this.on('error', this.onerror)
const handleRequest = (req, res) => {
const ctx = this.createContext(req, res);
return this.handleRequest(ctx, fn);
};
const ctx = this.createContext(req, res)
return this.handleRequest(ctx, fn)
}
return handleRequest;
return handleRequest
}
/**
* return currnect contenxt from async local storage
* return current context from async local storage
*/
get currentContext() {
if (this.ctxStorage) return this.ctxStorage.getStore();
get currentContext () {
if (this.ctxStorage) return this.ctxStorage.getStore()
}

@@ -185,9 +191,9 @@

handleRequest(ctx, fnMiddleware) {
const res = ctx.res;
res.statusCode = 404;
const onerror = err => ctx.onerror(err);
const handleResponse = () => respond(ctx);
onFinished(res, onerror);
return fnMiddleware(ctx).then(handleResponse).catch(onerror);
handleRequest (ctx, fnMiddleware) {
const res = ctx.res
res.statusCode = 404
const onerror = err => ctx.onerror(err)
const handleResponse = () => respond(ctx)
onFinished(res, onerror)
return fnMiddleware(ctx).then(handleResponse).catch(onerror)
}

@@ -201,15 +207,18 @@

createContext(req, res) {
const context = Object.create(this.context);
const request = context.request = Object.create(this.request);
const response = context.response = Object.create(this.response);
context.app = request.app = response.app = this;
context.req = request.req = response.req = req;
context.res = request.res = response.res = res;
request.ctx = response.ctx = context;
request.response = response;
response.request = request;
context.originalUrl = request.originalUrl = req.url;
context.state = {};
return context;
createContext (req, res) {
/** @type {Context} */
const context = Object.create(this.context)
/** @type {KoaRequest} */
const request = context.request = Object.create(this.request)
/** @type {KoaResponse} */
const response = context.response = Object.create(this.response)
context.app = request.app = response.app = this
context.req = request.req = response.req = req
context.res = request.res = response.res = res
request.ctx = response.ctx = context
request.response = response
response.request = request
context.originalUrl = request.originalUrl = req.url
context.state = {}
return context
}

@@ -224,3 +233,3 @@

onerror(err) {
onerror (err) {
// When dealing with cross-globals a normal `instanceof` check doesn't work properly.

@@ -231,10 +240,10 @@ // See https://github.com/koajs/koa/issues/1466

Object.prototype.toString.call(err) === '[object Error]' ||
err instanceof Error;
if (!isNativeError) throw new TypeError(util.format('non-error thrown: %j', err));
err instanceof Error
if (!isNativeError) throw new TypeError(util.format('non-error thrown: %j', err))
if (404 === err.status || err.expose) return;
if (this.silent) return;
if (err.status === 404 || err.expose) return
if (this.silent) return
const msg = err.stack || err.toString();
console.error(`\n${msg.replace(/^/gm, ' ')}\n`);
const msg = err.stack || err.toString()
console.error(`\n${msg.replace(/^/gm, ' ')}\n`)
}

@@ -247,15 +256,15 @@

static get default() {
return Application;
static get default () {
return Application
}
createAsyncCtxStorageMiddleware() {
const app = this;
return async function asyncCtxStorage(ctx, next) {
await app.ctxStorage.run(ctx, async() => {
return await next();
});
};
createAsyncCtxStorageMiddleware () {
const app = this
return async function asyncCtxStorage (ctx, next) {
await app.ctxStorage.run(ctx, async () => {
return await next()
})
}
}
};
}

@@ -266,11 +275,11 @@ /**

function respond(ctx) {
function respond (ctx) {
// allow bypassing koa
if (false === ctx.respond) return;
if (ctx.respond === false) return
if (!ctx.writable) return;
if (!ctx.writable) return
const res = ctx.res;
let body = ctx.body;
const code = ctx.status;
const res = ctx.res
let body = ctx.body
const code = ctx.status

@@ -280,44 +289,45 @@ // ignore body

// strip headers
ctx.body = null;
return res.end();
ctx.body = null
return res.end()
}
if ('HEAD' === ctx.method) {
if (ctx.method === 'HEAD') {
if (!res.headersSent && !ctx.response.has('Content-Length')) {
const { length } = ctx.response;
if (Number.isInteger(length)) ctx.length = length;
const { length } = ctx.response
if (Number.isInteger(length)) ctx.length = length
}
return res.end();
return res.end()
}
// status body
if (null == body) {
if (body == null) {
if (ctx.response._explicitNullBody) {
ctx.response.remove('Content-Type');
ctx.response.remove('Transfer-Encoding');
return res.end();
ctx.response.remove('Content-Type')
ctx.response.remove('Transfer-Encoding')
ctx.length = 0
return res.end()
}
if (ctx.req.httpVersionMajor >= 2) {
body = String(code);
body = String(code)
} else {
body = ctx.message || String(code);
body = ctx.message || String(code)
}
if (!res.headersSent) {
ctx.type = 'text';
ctx.length = Buffer.byteLength(body);
ctx.type = 'text'
ctx.length = Buffer.byteLength(body)
}
return res.end(body);
return res.end(body)
}
// responses
if (Buffer.isBuffer(body)) return res.end(body);
if ('string' === typeof body) return res.end(body);
if (body instanceof Stream) return body.pipe(res);
if (Buffer.isBuffer(body)) return res.end(body)
if (typeof body === 'string') return res.end(body)
if (body instanceof Stream) return body.pipe(res)
// body: json
body = JSON.stringify(body);
body = JSON.stringify(body)
if (!res.headersSent) {
ctx.length = Buffer.byteLength(body);
ctx.length = Buffer.byteLength(body)
}
res.end(body);
res.end(body)
}

@@ -330,2 +340,2 @@

module.exports.HttpError = HttpError;
module.exports.HttpError = HttpError
+45
-45
lib/context.js
'use strict';
'use strict'

@@ -8,10 +8,10 @@ /**

const util = require('util');
const createError = require('http-errors');
const httpAssert = require('http-assert');
const delegate = require('delegates');
const statuses = require('statuses');
const Cookies = require('cookies');
const util = require('util')
const createError = require('http-errors')
const httpAssert = require('http-assert')
const delegate = require('delegates')
const statuses = require('statuses')
const Cookies = require('cookies')
const COOKIES = Symbol('context#cookies');
const COOKIES = Symbol('context#cookies')

@@ -32,5 +32,5 @@ /**

inspect() {
if (this === proto) return this;
return this.toJSON();
inspect () {
if (this === proto) return this
return this.toJSON()
},

@@ -50,3 +50,3 @@

toJSON() {
toJSON () {
return {

@@ -60,3 +60,3 @@ request: this.request.toJSON(),

socket: '<original node socket>'
};
}
},

@@ -100,4 +100,4 @@

throw(...args) {
throw createError(...args);
throw (...args) {
throw createError(...args)
},

@@ -112,7 +112,7 @@

onerror(err) {
onerror (err) {
// don't do anything if there is no error.
// this allows you to pass `this.onerror`
// to node-style callbacks.
if (null == err) return;
if (err == null) return

@@ -124,12 +124,12 @@ // When dealing with cross-globals a normal `instanceof` check doesn't work properly.

Object.prototype.toString.call(err) === '[object Error]' ||
err instanceof Error;
if (!isNativeError) err = new Error(util.format('non-error thrown: %j', err));
err instanceof Error
if (!isNativeError) err = new Error(util.format('non-error thrown: %j', err))
let headerSent = false;
let headerSent = false
if (this.headerSent || !this.writable) {
headerSent = err.headerSent = true;
headerSent = err.headerSent = true
}
// delegate
this.app.emit('error', err, this);
this.app.emit('error', err, this)

@@ -140,6 +140,6 @@ // nothing we can do here other

if (headerSent) {
return;
return
}
const { res } = this;
const { res } = this

@@ -149,30 +149,30 @@ // first unset all headers

if (typeof res.getHeaderNames === 'function') {
res.getHeaderNames().forEach(name => res.removeHeader(name));
res.getHeaderNames().forEach(name => res.removeHeader(name))
} else {
res._headers = {}; // Node < 7.7
res._headers = {} // Node < 7.7
}
// then set those specified
this.set(err.headers);
this.set(err.headers)
// force text/plain
this.type = 'text';
this.type = 'text'
let statusCode = err.status || err.statusCode;
let statusCode = err.status || err.statusCode
// ENOENT support
if ('ENOENT' === err.code) statusCode = 404;
if (err.code === 'ENOENT') statusCode = 404
// default to 500
if ('number' !== typeof statusCode || !statuses[statusCode]) statusCode = 500;
if (typeof statusCode !== 'number' || !statuses[statusCode]) statusCode = 500
// respond
const code = statuses[statusCode];
const msg = err.expose ? err.message : code;
this.status = err.status = statusCode;
this.length = Buffer.byteLength(msg);
res.end(msg);
const code = statuses[statusCode]
const msg = err.expose ? err.message : code
this.status = err.status = statusCode
this.length = Buffer.byteLength(msg)
res.end(msg)
},
get cookies() {
get cookies () {
if (!this[COOKIES]) {

@@ -182,11 +182,11 @@ this[COOKIES] = new Cookies(this.req, this.res, {

secure: this.request.secure
});
})
}
return this[COOKIES];
return this[COOKIES]
},
set cookies(_cookies) {
this[COOKIES] = _cookies;
set cookies (_cookies) {
this[COOKIES] = _cookies
}
};
}

@@ -202,3 +202,3 @@ /**

if (util.inspect.custom) {
module.exports[util.inspect.custom] = module.exports.inspect;
module.exports[util.inspect.custom] = module.exports.inspect
}

@@ -227,3 +227,3 @@

.getter('headerSent')
.getter('writable');
.getter('writable')

@@ -263,2 +263,2 @@ /**

.getter('ips')
.getter('ip');
.getter('ip')
+153
-153
lib/request.js
'use strict';
'use strict'

@@ -8,15 +8,15 @@ /**

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')

@@ -36,4 +36,4 @@ /**

get header() {
return this.req.headers;
get header () {
return this.req.headers
},

@@ -47,4 +47,4 @@

set header(val) {
this.req.headers = val;
set header (val) {
this.req.headers = val
},

@@ -59,4 +59,4 @@

get headers() {
return this.req.headers;
get headers () {
return this.req.headers
},

@@ -70,4 +70,4 @@

set headers(val) {
this.req.headers = val;
set headers (val) {
this.req.headers = val
},

@@ -82,4 +82,4 @@

get url() {
return this.req.url;
get url () {
return this.req.url
},

@@ -93,4 +93,4 @@

set url(val) {
this.req.url = val;
set url (val) {
this.req.url = val
},

@@ -105,4 +105,4 @@

get origin() {
return `${this.protocol}://${this.host}`;
get origin () {
return `${this.protocol}://${this.host}`
},

@@ -117,6 +117,6 @@

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
},

@@ -131,4 +131,4 @@

get method() {
return this.req.method;
get method () {
return this.req.method
},

@@ -143,4 +143,4 @@

set method(val) {
this.req.method = val;
set method (val) {
this.req.method = val
},

@@ -155,4 +155,4 @@

get path() {
return parse(this.req).pathname;
get path () {
return parse(this.req).pathname
},

@@ -167,10 +167,10 @@

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)
},

@@ -185,6 +185,6 @@

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))
},

@@ -199,4 +199,4 @@

set query(obj) {
this.querystring = qs.stringify(obj);
set query (obj) {
this.querystring = qs.stringify(obj)
},

@@ -211,5 +211,5 @@

get querystring() {
if (!this.req) return '';
return parse(this.req).query || '';
get querystring () {
if (!this.req) return ''
return parse(this.req).query || ''
},

@@ -224,10 +224,10 @@

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)
},

@@ -243,5 +243,5 @@

get search() {
if (!this.querystring) return '';
return `?${this.querystring}`;
get search () {
if (!this.querystring) return ''
return `?${this.querystring}`
},

@@ -257,4 +257,4 @@

set search(str) {
this.querystring = str;
set search (str) {
this.querystring = str
},

@@ -271,11 +271,11 @@

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]
},

@@ -292,7 +292,7 @@

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]
},

@@ -308,13 +308,13 @@

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
},

@@ -331,15 +331,15 @@

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
},

@@ -356,4 +356,4 @@

get stale() {
return !this.fresh;
get stale () {
return !this.fresh
},

@@ -368,5 +368,5 @@

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)
},

@@ -381,4 +381,4 @@

get socket() {
return this.req.socket;
get socket () {
return this.req.socket
},

@@ -393,8 +393,8 @@

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 ''
}

@@ -410,6 +410,6 @@ },

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
},

@@ -429,7 +429,7 @@

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'
},

@@ -446,4 +446,4 @@

get secure() {
return 'https' === this.protocol;
get secure () {
return this.protocol === 'https'
},

@@ -463,12 +463,12 @@

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
},

@@ -485,11 +485,11 @@

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
},

@@ -513,10 +513,10 @@

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)
},

@@ -532,4 +532,4 @@

get accept() {
return this._accept || (this._accept = accepts(this.req));
get accept () {
return this._accept || (this._accept = accepts(this.req))
},

@@ -544,4 +544,4 @@

set accept(obj) {
this._accept = obj;
set accept (obj) {
this._accept = obj
},

@@ -590,4 +590,4 @@

accepts(...args) {
return this.accept.types(...args);
accepts (...args) {
return this.accept.types(...args)
},

@@ -608,4 +608,4 @@

acceptsEncodings(...args) {
return this.accept.encodings(...args);
acceptsEncodings (...args) {
return this.accept.encodings(...args)
},

@@ -626,4 +626,4 @@

acceptsCharsets(...args) {
return this.accept.charsets(...args);
acceptsCharsets (...args) {
return this.accept.charsets(...args)
},

@@ -644,4 +644,4 @@

acceptsLanguages(...args) {
return this.accept.languages(...args);
acceptsLanguages (...args) {
return this.accept.languages(...args)
},

@@ -676,4 +676,4 @@

is(type, ...types) {
return typeis(this.req, type, ...types);
is (type, ...types) {
return typeis(this.req, type, ...types)
},

@@ -689,6 +689,6 @@

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]
},

@@ -718,10 +718,10 @@

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] || ''
}

@@ -737,5 +737,5 @@ },

inspect() {
if (!this.req) return;
return this.toJSON();
inspect () {
if (!this.req) return
return this.toJSON()
},

@@ -750,3 +750,3 @@

toJSON() {
toJSON () {
return only(this, [

@@ -756,5 +756,5 @@ 'method',

'header'
]);
])
}
};
}

@@ -770,3 +770,3 @@ /**

if (util.inspect.custom) {
module.exports[util.inspect.custom] = module.exports.inspect;
module.exports[util.inspect.custom] = module.exports.inspect
}
+154
-148
lib/response.js
'use strict';
'use strict'

@@ -8,16 +8,16 @@ /**

const contentDisposition = require('content-disposition');
const getType = require('cache-content-type');
const onFinish = require('on-finished');
const escape = require('escape-html');
const typeis = require('type-is').is;
const statuses = require('statuses');
const destroy = require('destroy');
const assert = require('assert');
const extname = require('path').extname;
const vary = require('vary');
const only = require('only');
const util = require('util');
const encodeUrl = require('encodeurl');
const Stream = require('stream');
const contentDisposition = require('content-disposition')
const getType = require('cache-content-type')
const onFinish = require('on-finished')
const escape = require('escape-html')
const typeis = require('type-is').is
const statuses = require('statuses')
const destroy = require('destroy')
const assert = require('assert')
const extname = require('path').extname
const vary = require('vary')
const only = require('only')
const util = require('util')
const encodeUrl = require('encodeurl')
const Stream = require('stream')

@@ -37,4 +37,4 @@ /**

get socket() {
return this.res.socket;
get socket () {
return this.res.socket
},

@@ -49,7 +49,7 @@

get header() {
const { res } = this;
get header () {
const { res } = this
return typeof res.getHeaders === 'function'
? res.getHeaders()
: res._headers || {}; // Node < 7.7
: res._headers || {} // Node < 7.7
},

@@ -64,4 +64,4 @@

get headers() {
return this.header;
get headers () {
return this.header
},

@@ -76,4 +76,4 @@

get status() {
return this.res.statusCode;
get status () {
return this.res.statusCode
},

@@ -88,11 +88,11 @@

set status(code) {
if (this.headerSent) return;
set status (code) {
if (this.headerSent) return
assert(Number.isInteger(code), 'status code must be a number');
assert(code >= 100 && code <= 999, `invalid status code: ${code}`);
this._explicitStatus = true;
this.res.statusCode = code;
if (this.req.httpVersionMajor < 2) this.res.statusMessage = statuses[code];
if (this.body && statuses.empty[code]) this.body = null;
assert(Number.isInteger(code), 'status code must be a number')
assert(code >= 100 && code <= 999, `invalid status code: ${code}`)
this._explicitStatus = true
this.res.statusCode = code
if (this.req.httpVersionMajor < 2) this.res.statusMessage = statuses[code]
if (this.body && statuses.empty[code]) this.body = null
},

@@ -107,4 +107,4 @@

get message() {
return this.res.statusMessage || statuses[this.status];
get message () {
return this.res.statusMessage || statuses[this.status]
},

@@ -119,4 +119,4 @@

set message(msg) {
this.res.statusMessage = msg;
set message (msg) {
this.res.statusMessage = msg
},

@@ -131,4 +131,4 @@

get body() {
return this._body;
get body () {
return this._body
},

@@ -143,27 +143,33 @@

set body(val) {
const original = this._body;
this._body = val;
set body (val) {
const original = this._body
this._body = val
// no content
if (null == val) {
if (!statuses.empty[this.status]) this.status = 204;
if (val === null) this._explicitNullBody = true;
this.remove('Content-Type');
this.remove('Content-Length');
this.remove('Transfer-Encoding');
return;
if (val == null) {
if (!statuses.empty[this.status]) {
if (this.type === 'application/json') {
this._body = 'null'
return
}
this.status = 204
}
if (val === null) this._explicitNullBody = true
this.remove('Content-Type')
this.remove('Content-Length')
this.remove('Transfer-Encoding')
return
}
// set the status
if (!this._explicitStatus) this.status = 200;
if (!this._explicitStatus) this.status = 200
// set the content-type only if not yet set
const setType = !this.has('Content-Type');
const setType = !this.has('Content-Type')
// string
if ('string' === typeof val) {
if (setType) this.type = /^\s*</.test(val) ? 'html' : 'text';
this.length = Buffer.byteLength(val);
return;
if (typeof val === 'string') {
if (setType) this.type = /^\s*</.test(val) ? 'html' : 'text'
this.length = Buffer.byteLength(val)
return
}

@@ -173,5 +179,5 @@

if (Buffer.isBuffer(val)) {
if (setType) this.type = 'bin';
this.length = val.length;
return;
if (setType) this.type = 'bin'
this.length = val.length
return
}

@@ -181,16 +187,16 @@

if (val instanceof Stream) {
onFinish(this.res, destroy.bind(null, val));
if (original != val) {
val.once('error', err => this.ctx.onerror(err));
onFinish(this.res, destroy.bind(null, val))
if (original !== val) {
val.once('error', err => this.ctx.onerror(err))
// overwriting
if (null != original) this.remove('Content-Length');
if (original != null) this.remove('Content-Length')
}
if (setType) this.type = 'bin';
return;
if (setType) this.type = 'bin'
return
}
// json
this.remove('Content-Length');
this.type = 'json';
this.remove('Content-Length')
this.type = 'json'
},

@@ -205,5 +211,5 @@

set length(n) {
set length (n) {
if (!this.has('Transfer-Encoding')) {
this.set('Content-Length', n);
this.set('Content-Length', n)
}

@@ -219,12 +225,12 @@ },

get length() {
get length () {
if (this.has('Content-Length')) {
return parseInt(this.get('Content-Length'), 10) || 0;
return parseInt(this.get('Content-Length'), 10) || 0
}
const { body } = this;
if (!body || body instanceof Stream) return undefined;
if ('string' === typeof body) return Buffer.byteLength(body);
if (Buffer.isBuffer(body)) return body.length;
return Buffer.byteLength(JSON.stringify(body));
const { body } = this
if (!body || body instanceof Stream) return undefined
if (typeof body === 'string') return Buffer.byteLength(body)
if (Buffer.isBuffer(body)) return body.length
return Buffer.byteLength(JSON.stringify(body))
},

@@ -239,4 +245,4 @@

get headerSent() {
return this.res.headersSent;
get headerSent () {
return this.res.headersSent
},

@@ -251,6 +257,6 @@

vary(field) {
if (this.headerSent) return;
vary (field) {
if (this.headerSent) return
vary(this.res, field);
vary(this.res, field)
},

@@ -277,21 +283,21 @@

redirect(url, alt) {
redirect (url, alt) {
// location
if ('back' === url) url = this.ctx.get('Referrer') || alt || '/';
this.set('Location', encodeUrl(url));
if (url === 'back') url = this.ctx.get('Referrer') || alt || '/'
this.set('Location', encodeUrl(url))
// status
if (!statuses.redirect[this.status]) this.status = 302;
if (!statuses.redirect[this.status]) this.status = 302
// html
if (this.ctx.accepts('html')) {
url = escape(url);
this.type = 'text/html; charset=utf-8';
this.body = `Redirecting to <a href="${url}">${url}</a>.`;
return;
url = escape(url)
this.type = 'text/html; charset=utf-8'
this.body = `Redirecting to <a href="${url}">${url}</a>.`
return
}
// text
this.type = 'text/plain; charset=utf-8';
this.body = `Redirecting to ${url}.`;
this.type = 'text/plain; charset=utf-8'
this.body = `Redirecting to ${url}.`
},

@@ -306,5 +312,5 @@

attachment(filename, options) {
if (filename) this.type = extname(filename);
this.set('Content-Disposition', contentDisposition(filename, options));
attachment (filename, options) {
if (filename) this.type = extname(filename)
this.set('Content-Disposition', contentDisposition(filename, options))
},

@@ -328,8 +334,8 @@

set type(type) {
type = getType(type);
set type (type) {
type = getType(type)
if (type) {
this.set('Content-Type', type);
this.set('Content-Type', type)
} else {
this.remove('Content-Type');
this.remove('Content-Type')
}

@@ -348,5 +354,5 @@ },

set lastModified(val) {
if ('string' === typeof val) val = new Date(val);
this.set('Last-Modified', val.toUTCString());
set lastModified (val) {
if (typeof val === 'string') val = new Date(val)
this.set('Last-Modified', val.toUTCString())
},

@@ -361,5 +367,5 @@

get lastModified() {
const date = this.get('last-modified');
if (date) return new Date(date);
get lastModified () {
const date = this.get('last-modified')
if (date) return new Date(date)
},

@@ -379,5 +385,5 @@

set etag(val) {
if (!/^(W\/)?"/.test(val)) val = `"${val}"`;
this.set('ETag', val);
set etag (val) {
if (!/^(W\/)?"/.test(val)) val = `"${val}"`
this.set('ETag', val)
},

@@ -392,4 +398,4 @@

get etag() {
return this.get('ETag');
get etag () {
return this.get('ETag')
},

@@ -405,6 +411,6 @@

get type() {
const type = this.get('Content-Type');
if (!type) return '';
return type.split(';', 1)[0];
get type () {
const type = this.get('Content-Type')
if (!type) return ''
return type.split(';', 1)[0]
},

@@ -422,4 +428,4 @@

is(type, ...types) {
return typeis(this.type, type, ...types);
is (type, ...types) {
return typeis(this.type, type, ...types)
},

@@ -439,8 +445,8 @@

* @param {String} field
* @return {String}
* @return {any}
* @api public
*/
get(field) {
return this.header[field.toLowerCase()] || '';
get (field) {
return this.res.getHeader(field)
},

@@ -465,7 +471,7 @@

has(field) {
has (field) {
return typeof this.res.hasHeader === 'function'
? this.res.hasHeader(field)
// Node < 7.7
: field.toLowerCase() in this.headers;
: field.toLowerCase() in this.headers
},

@@ -488,12 +494,12 @@

set(field, val) {
if (this.headerSent) return;
set (field, val) {
if (this.headerSent) return
if (2 === arguments.length) {
if (Array.isArray(val)) val = val.map(v => typeof v === 'string' ? v : String(v));
else if (typeof val !== 'string') val = String(val);
this.res.setHeader(field, val);
if (arguments.length === 2) {
if (Array.isArray(val)) val = val.map(v => typeof v === 'string' ? v : String(v))
else if (typeof val !== 'string') val = String(val)
this.res.setHeader(field, val)
} else {
for (const key in field) {
this.set(key, field[key]);
this.set(key, field[key])
}

@@ -519,4 +525,4 @@ }

append(field, val) {
const prev = this.get(field);
append (field, val) {
const prev = this.get(field)

@@ -526,6 +532,6 @@ if (prev) {

? prev.concat(val)
: [prev].concat(val);
: [prev].concat(val)
}
return this.set(field, val);
return this.set(field, val)
},

@@ -540,6 +546,6 @@

remove(field) {
if (this.headerSent) return;
remove (field) {
if (this.headerSent) return
this.res.removeHeader(field);
this.res.removeHeader(field)
},

@@ -556,3 +562,3 @@

get writable() {
get writable () {
// can't write any more after response finished

@@ -563,9 +569,9 @@ // response.writableEnded is available since Node > 12.9

// https://stackoverflow.com/questions/16254385/undocumented-response-finished-in-node-js
if (this.res.writableEnded || this.res.finished) return false;
if (this.res.writableEnded || this.res.finished) return false
const socket = this.res.socket;
const socket = this.res.socket
// There are already pending outgoing res, but still writable
// https://github.com/nodejs/node/blob/v4.4.7/lib/_http_server.js#L486
if (!socket) return true;
return socket.writable;
if (!socket) return true
return socket.writable
},

@@ -580,7 +586,7 @@

inspect() {
if (!this.res) return;
const o = this.toJSON();
o.body = this.body;
return o;
inspect () {
if (!this.res) return
const o = this.toJSON()
o.body = this.body
return o
},

@@ -595,3 +601,3 @@

toJSON() {
toJSON () {
return only(this, [

@@ -601,3 +607,3 @@ 'status',

'header'
]);
])
},

@@ -609,6 +615,6 @@

flushHeaders() {
this.res.flushHeaders();
flushHeaders () {
this.res.flushHeaders()
}
};
}

@@ -624,3 +630,3 @@ /**

if (util.inspect.custom) {
module.exports[util.inspect.custom] = module.exports.inspect;
module.exports[util.inspect.custom] = module.exports.inspect
}
+7
-16
package.json
{
"name": "koa",
"version": "2.14.1",
"version": "3.0.0-alpha.0",
"publishConfig": {
"tag": "experimental"
},
"description": "Koa web app framework",

@@ -11,10 +14,2 @@ "main": "lib/application.js",

},
"./lib/request": "./lib/request.js",
"./lib/request.js": "./lib/request.js",
"./lib/response": "./lib/response.js",
"./lib/response.js": "./lib/response.js",
"./lib/application": "./lib/application.js",
"./lib/application.js": "./lib/application.js",
"./lib/context": "./lib/context.js",
"./lib/context.js": "./lib/context.js",
"./*": "./*.js",

@@ -51,3 +46,2 @@ "./*.js": "./*.js",

"delegates": "^1.0.0",
"depd": "^2.0.0",
"destroy": "^1.0.4",

@@ -59,5 +53,3 @@ "encodeurl": "^1.0.2",

"http-errors": "^1.6.3",
"is-generator-function": "^1.0.7",
"koa-compose": "^4.1.0",
"koa-convert": "^2.0.0",
"on-finished": "^2.3.0",

@@ -72,3 +64,2 @@ "only": "~0.0.2",

"eslint": "^7.32.0",
"eslint-config-koa": "^2.0.0",
"eslint-config-standard": "^16.0.3",

@@ -80,7 +71,7 @@ "eslint-plugin-import": "^2.18.2",

"gen-esm-wrapper": "^1.0.6",
"jest": "^27.0.6",
"supertest": "^3.1.0"
"jest": "^28.1.2",
"supertest": "^6.2.4"
},
"engines": {
"node": "^4.8.4 || ^6.10.1 || ^7.10.1 || >= 8.1.4"
"node": ">= 12.17.0"
},

@@ -87,0 +78,0 @@ "files": [

+6
-7
Readme.md

@@ -5,3 +5,3 @@ <img src="/docs/logo.png" alt="Koa middleware framework for nodejs"/>

[![NPM version][npm-image]][npm-url]
[![build status][travis-image]][travis-url]
[![build status][github-action-image]][github-action-url]
[![Test coverage][coveralls-image]][coveralls-url]

@@ -21,3 +21,3 @@ [![OpenCollective Backers][backers-image]](#backers)

Koa requires __node v7.6.0__ or higher for ES2015 and async function support.
Koa requires __node v12.17.0__ or higher for ES2015 and async function support.

@@ -45,6 +45,4 @@ ```

- [Kick-Off-Koa](https://github.com/koajs/kick-off-koa) - An intro to Koa via a set of self-guided workshops.
- [Workshop](https://github.com/koajs/workshop) - A workshop to learn the basics of Koa, Express' spiritual successor.
- [Introduction Screencast](https://knowthen.com/episode-3-koajs-quickstart-guide/) - An introduction to installing and getting started with Koa
- [Guide](docs/guide.md) - Go straight to the docs.
## Middleware

@@ -187,2 +185,3 @@

- [KoaJS Slack Group](https://join.slack.com/t/koa-js/shared_invite/zt-5pjgthmb-1JeKDbByqqcARtlPbtf~vQ)
- [Badgeboard](https://koajs.github.io/badgeboard) and list of official modules

@@ -283,4 +282,4 @@ - [Examples](https://github.com/koajs/examples)

[npm-url]: https://www.npmjs.com/package/koa
[travis-image]: https://img.shields.io/travis/koajs/koa/master.svg?style=flat-square
[travis-url]: https://travis-ci.org/koajs/koa
[github-action-image]: https://github.com/koajs/koa/actions/workflows/node.js.yml/badge.svg
[github-action-url]: https://github.com/koajs/koa/actions/workflows/node.js.yml
[coveralls-image]: https://img.shields.io/codecov/c/github/koajs/koa.svg?style=flat-square

@@ -287,0 +286,0 @@ [coveralls-url]: https://codecov.io/github/koajs/koa?branch=master

-696
History.md
2.14.1 / 2022-12-07
==================
**fixes**
* [[`cb92bc9`](http://github.com/koajs/koa/commit/cb92bc98939bd71fd3c01e2dc681caf6545baa38)] - fix: should export createAsyncCtxStorageMiddleware function on application (#1724) (fengmk2 <<fengmk2@gmail.com>>)
2.14.0 / 2022-12-06
==================
**features**
* [[`a293122`](http://github.com/koajs/koa/commit/a29312212839c6f0418152d2a2cd3bf3fd3ee5e4)] - feat: support asyncLocalStorage (#1721) (fengmk2 <<fengmk2@gmail.com>>)
2.13.4 / 2021-10-19
==================
**fixes**
* [[`dbc9c5a`](http://github.com/koajs/koa/commit/dbc9c5a47e2b2799cab403186fdb010df5df6f67)] - fix: Do not response Content-Length if Transfer-Encoding is defined (#1602) (Yiyu He <<dead_horse@qq.com>>)
2.13.3 / 2021-09-24
==================
**fixes**
* [[`a37a2e5`](http://github.com/koajs/koa/commit/a37a2e5eec8997661a35ca10210f1d9950976041)] - fix: compatible with node-v12.19.0 & earlier (#1590) (hyj1991 <<yeekwanvong@gmail.com>>)
2.13.2 / 2021-09-24
==================
**fixes**
* [[`04acf02`](http://github.com/koajs/koa/commit/04acf0281a5dcb3fd463d4c8537984c686d0b96f)] - fix: nodejs deprecated api <DEP0148> (#1585) (#1588) (hyj1991 <<yeekwanvong@gmail.com>>)
**others**
* [[`3435e78`](http://github.com/koajs/koa/commit/3435e7864a59cca2835ebaad96c4eda801b99b24)] - lint++ (jongleberry <<jonathanrichardong@gmail.com>>)
* [[`2cd6618`](http://github.com/koajs/koa/commit/2cd66182f46965f1d824c24826e85df251cca3d2)] - Fix grammar mistake (#1527) (Matheus Souza <<37983247+souzasmatheus@users.noreply.github.com>>)
* [[`16ab46e`](http://github.com/koajs/koa/commit/16ab46e9f2b5411fd1c50312ac03719f0a90df61)] - chore: upgrade koa-convert dependency to ^2.0.0 (#1535) (Christian Rodemeyer <<atombrenner@users.noreply.github.com>>)
* [[`65113ca`](http://github.com/koajs/koa/commit/65113ca38af634e4b1002d5bc40917cc09a7b7c6)] - Fix jsdoc types for constructor (#1541) (Piotr Kuczynski <<piotr.kuczynski@gmail.com>>)
* [[`03e6317`](http://github.com/koajs/koa/commit/03e6317df24d2dce0c1f08869326149f766f1e41)] - :arrow_up: debug (jongleberry <<jonathanrichardong@gmail.com>>)
* [[`b37a2d0`](http://github.com/koajs/koa/commit/b37a2d09c137d9a553a0bdf8589b60c7f6425160)] - :arrow_up: eslint dependencies (jongleberry <<jonathanrichardong@gmail.com>>)
* [[`4a410cc`](http://github.com/koajs/koa/commit/4a410cc2fbd923868cac6a622f12cc652586abee)] - migrate assert.deepEqual => .deepStrictEqual (jongleberry <<jonathanrichardong@gmail.com>>)
* [[`4545b59`](http://github.com/koajs/koa/commit/4545b59aa521e377a4ebb0ccbb8abec01981fbf4)] - test: switch tests to jest (jongleberry <<jonathanrichardong@gmail.com>>)
* [[`596cfd5`](http://github.com/koajs/koa/commit/596cfd542ccd1d89d97453e29cf499d49a82e743)] - migrate assert.strict => .strictEqual (jongleberry <<jonathanrichardong@gmail.com>>)
* [[`be3e8b6`](http://github.com/koajs/koa/commit/be3e8b68ab58d469f0f450284528dbef32e2d7ba)] - test: switch to github actions (jongleberry <<jonathanrichardong@gmail.com>>)
* [[`a2570e3`](http://github.com/koajs/koa/commit/a2570e3ee622cfa5214c2f756ea03b3b7143dbf7)] - package: update bench scripts (jongleberry <<jonathanrichardong@gmail.com>>)
* [[`000acf0`](http://github.com/koajs/koa/commit/000acf06ab3e37006569addc8ace5c0a4365daa1)] - npm: enable package-lock (jongleberry <<jonathanrichardong@gmail.com>>)
* [[`47fdbca`](http://github.com/koajs/koa/commit/47fdbca8b1c3999c5726f54531f8b47640a65a6f)] - delete benchmarks (jongleberry <<jonathanrichardong@gmail.com>>)
* [[`0056f90`](http://github.com/koajs/koa/commit/0056f901e89fd0781067b2c9592fd5909f9ba94a)] - Create dependabot.yml (jongleberry <<jonathanrichardong@gmail.com>>)
* [[`698ce0a`](http://github.com/koajs/koa/commit/698ce0afbfac6480400625729a4b8fc4b4203fdc)] - test: fix typo in status.js (Ikko Ashimine <<eltociear@gmail.com>>)
* [[`eb51cf5`](http://github.com/koajs/koa/commit/eb51cf5fb35b39592a050b25fd261a574f547cfa)] - doc: app.keys needs to be long enought and random (#1520) (Yiyu He <<dead_horse@qq.com>>)
2.13.1 / 2021-01-04
==================
**fixes**
* [[`b5472f4`](http://github.com/koajs/koa/commit/b5472f4cbb87349becae36b4a9ad5f76a825abb8)] - fix: make ESM transpiled CommonJS play nice for TS folks, fix #1513 (#1518) (miwnwski <<m@iwnw.ski>>)
* [[`68d97d6`](http://github.com/koajs/koa/commit/68d97d69e4536065504bf9ef1e348a66b3f35709)] - fix: fixed order of vulnerability disclosure addresses (niftylettuce <<niftylettuce@gmail.com>>)
**others**
* [[`b4398f5`](http://github.com/koajs/koa/commit/b4398f5d68f9546167419f394a686afdcb5e10e2)] - correct verb tense in doc (#1512) (Matan Shavit <<71092861+matanshavit@users.noreply.github.com>>)
* [[`39e1a5a`](http://github.com/koajs/koa/commit/39e1a5a380aa2bbc4e2d164e8e4bf37cfd512516)] - fixed multiple grammatical errors in docs. (#1497) (Hridayesh Sharma <<vyasriday7@gmail.com>>)
* [[`aeb5d19`](http://github.com/koajs/koa/commit/aeb5d1984dcc5f8e3386f8f9724807ae6f3aa1c4)] - docs: added niftylettuce@gmail.com to vulnerability disclosure (niftylettuce <<niftylettuce@gmail.com>>)
* [[`6e1093b`](http://github.com/koajs/koa/commit/6e1093be27b41135c8e67fce108743d54e9cab67)] - docs: remove babel from readme (#1494) (miwnwski <<m@iwnw.ski>>)
* [[`38cb591`](http://github.com/koajs/koa/commit/38cb591254ff5f65a04e8fb57be293afe697c46e)] - docs: update specific for auto response status (AlbertAZ1992 <<ziyuximing@163.com>>)
* [[`2224cd9`](http://github.com/koajs/koa/commit/2224cd9b6a648e7ac2eb27eac332e7d6de7db26c)] - docs: remove babel ref. (#1488) (Imed Jaberi <<imed_jebari@hotmail.fr>>)
* [[`d51f983`](http://github.com/koajs/koa/commit/d51f98328c3b84493cc6bda0732aabb69e20e3a1)] - docs: fix assert example for response (#1489) (Imed Jaberi <<imed_jebari@hotmail.fr>>)
* [[`f8b49b8`](http://github.com/koajs/koa/commit/f8b49b859363ad6c3d9ea5c11ee62341407ceafd)] - chore: fix grammatical and spelling errors in comments and tests (#1490) (Matt Kubej <<mkubej@gmail.com>>)
* [[`d1c9263`](http://github.com/koajs/koa/commit/d1c92638c95d799df2fdff5576b96fc43a62813f)] - deps: update depd >> v2.0.0 (#1482) (imed jaberi <<imed_jebari@hotmail.fr>>)
2.13.0 / 2020-06-21
==================
**features**
* [[`bbcde76`](http://github.com/koajs/koa/commit/bbcde76f5cb5b67bbcd3201791cf0ef648fd3a8b)] - feat: support esm (#1474) (ZYSzys <<zhangyongsheng@youzan.com>>)
**others**
* [[`20e58cf`](http://github.com/koajs/koa/commit/20e58cf3e4f20fc5d5886df1d0ac6dd8c33bd202)] - test: imporve coverage to 100% (dead-horse <<dead_horse@qq.com>>)
* [[`4a40d63`](http://github.com/koajs/koa/commit/4a40d633c4b4a203c6656078f9952ccef65c5875)] - build: use prepare instead of prepublish (dead-horse <<dead_horse@qq.com>>)
* [[`226ba8c`](http://github.com/koajs/koa/commit/226ba8c8e81e83da48e7bf137be3f146d03f40b8)] - build: use prepublish instead of prepack (dead-horse <<dead_horse@qq.com>>)
2.12.1 / 2020-06-13
==================
**fixes**
* [[`e2030c7`](http://github.com/koajs/koa/commit/e2030c7249c7ae24e28158d8eae405a02fefc9f8)] - fix: Improve checks for Error in onerror handlers (#1468) (Julien Wajsberg <<felash@gmail.com>>)
**others**
* [[`5208c5e`](http://github.com/koajs/koa/commit/5208c5e15d35b3653fce6b8ed68d09865abea843)] - chore: Use single console.error() statement in error handler (#1471) (Mike Vosseller <<michael.vosseller@gmail.com>>)
2.12.0 / 2020-05-18
==================
**features**
* [[`0d2f421`](http://github.com/koajs/koa/commit/0d2f421c265350d3d84e1bc261572954479f27d3)] - feat: error handler treat err.statusCode as the same as err.status (#1460) (Vijay Krishnavanshi <<vijaykrishnavanshi@gmail.com>>)
* [[`8d52105`](http://github.com/koajs/koa/commit/8d52105a34234be9e771ff3b76b43e4e30328943)] - feat: allow bodyless responses for non empty status codes (#1447) (ejose19 <<8742215+ejose19@users.noreply.github.com>>)
**others**
* [[`faeaff5`](http://github.com/koajs/koa/commit/faeaff5c149a81a188ab8e5af0b994029e45acbb)] - fox: remove `error-inject` and fix error handling (#1409) (Konstantin Vyatkin <<tino@vtkn.io>>)
* [[`f7c732f`](http://github.com/koajs/koa/commit/f7c732fd06f724505e9090add4d977e667da55a8)] - docs: fixed incorrect onerror example (#1459) (Paul Annekov <<paul.annekov@gmail.com>>)
* [[`143d8f7`](http://github.com/koajs/koa/commit/143d8f72f2a232b4c97eac00e7811015911e4f7c)] - Always use strict equality. (#1225) (Yazan Medanat <<medanat@gmail.com>>)
* [[`6b6b0dd`](http://github.com/koajs/koa/commit/6b6b0ddf7aff073e65493c6efaffab8331c0331c)] - docs(api): add app.use chainability note (#1449) (Zac Anger <<zac@zacanger.com>>)
* [[`8ddab48`](http://github.com/koajs/koa/commit/8ddab48cbdbca1e6d1cc8c3ddae45491db524d51)] - docs: Document response status with empty body (#1445) (Marc-Aurèle DARCHE <<152407+madarche@users.noreply.github.com>>)
* [[`7deedb2`](http://github.com/koajs/koa/commit/7deedb235274223f1b9da46dee296545b23598de)] - docs: Updating context.md with the latest cookies opts (#1433) (Brad Ito <<phlogisticfugu@users.noreply.github.com>>)
* [[`3e97a10`](http://github.com/koajs/koa/commit/3e97a106bb846d9337737011bb85149ddd797229)] - docs(links): remove Google+ link (#1439) (laffachan <<45162759+laffachan@users.noreply.github.com>>)
* [[`eda2760`](http://github.com/koajs/koa/commit/eda27608f7d39ede86d7b402aae64b1867ce31c6)] - build: Drop unused Travis sudo: false directive (#1416) (Olle Jonsson <<olle.jonsson@gmail.com>>)
2.11.0 / 2019-10-28
==================
**features**
* [[`422e539`](http://github.com/koajs/koa/commit/422e539e8989e65ba43ecc39ddbaa3c4f755d465)] - feat: support app.proxyIPHeader and app.maxIpsCount to make ctx.ips more security (Yiyu He <<dead_horse@qq.com>>)
* [[`d48d88e`](http://github.com/koajs/koa/commit/d48d88ee17b780c02123e6d657274cab456e943e)] - feat: implement response.has (#1397) (Konstantin Vyatkin <<tino@vtkn.io>>)
**others**
* [[`4dc56f6`](http://github.com/koajs/koa/commit/4dc56f6d04e8f5fe12ba53a8a776653b3d7b60ed)] - chore: update ESLint and plugins/configs (#1407) (Konstantin Vyatkin <<tino@vtkn.io>>)
* [[`be7d334`](http://github.com/koajs/koa/commit/be7d334778481639294cdf87f5c359a230aeb65b)] - chore: removes code duplication at handling HEAD method (#1400) (Konstantin Vyatkin <<tino@vtkn.io>>)
* [[`f155785`](http://github.com/koajs/koa/commit/f155785e2bb42b5ddf0a8156401c6dafdf57ba8b)] - chore: support `writableEnded` (#1402) (Konstantin Vyatkin <<tino@vtkn.io>>)
* [[`b968688`](http://github.com/koajs/koa/commit/b968688afe2c727ae141f50aa983d481dbc1dbbf)] - chore: add FUNDING.yml (#1403) (Konstantin Vyatkin <<tino@vtkn.io>>)
* [[`4f96829`](http://github.com/koajs/koa/commit/4f968298f97394e488297ec32c8e927a3a322076)] - chore: remove isJSON in res.length (#1399) (Konstantin Vyatkin <<tino@vtkn.io>>)
* [[`8be5626`](http://github.com/koajs/koa/commit/8be5626bbb54e6c899a1b71d22411709126d9fea)] - build: enable codecov partial coverage and use bash uploader (#1396) (Konstantin Vyatkin <<tino@vtkn.io>>)
* [[`ef5c43b`](http://github.com/koajs/koa/commit/ef5c43bcbcf31819e032c3b7ae7654b7f8e9358b)] - chore: use rest params (#1393) (Konstantin Vyatkin <<tino@vtkn.io>>)
2.10.0 / 2019-10-12
==================
**features**
* [[`d7f7f77`](http://github.com/koajs/koa/commit/d7f7f77689e2eaef050686be2bdf3e72881a79ac)] - feat: support sameSite=none cookies (bump cookies dependency) (#1390) (Filip Skokan <<panva.ip@gmail.com>>)
2.9.0 / 2019-10-12
==================
**features**
* [[`2d1c598`](http://github.com/koajs/koa/commit/2d1c5981869e0fe6f5bc71b5c5582accfd125cc6)] - feat: export HttpError from http-errors library (Micheal Hill <<micheal.hill@trunkplatform.com>>)
**others**
* [[`cf70dbc`](http://github.com/koajs/koa/commit/cf70dbc6d2ba62bf1eb12b563dd5ecd27af6e2be)] - Chore: Use https in readme (#1389) (谭九鼎 <<109224573@qq.com>>)
2.8.2 / 2019-09-28
==================
**fixes**
* [[`54e8fab`](http://github.com/koajs/koa/commit/54e8fab3e3d907bbb264caf3e28a24773d0d6fdb)] - fix: encode redirect url if not already encoded (#1384) (fengmk2 <<fengmk2@gmail.com>>)
**others**
* [[`817b498`](http://github.com/koajs/koa/commit/817b49830571b45a8aec6b1fc1525434f5798c58)] - test: fix body test (#1375) (Robert Nagy <<ronagy@icloud.com>>)
* [[`f75d445`](http://github.com/koajs/koa/commit/f75d4455359ecdf30eeb676e2c7f31d4cf7b42ed)] - test: fix end after end (#1374) (Robert Nagy <<ronagy@icloud.com>>)
2.8.1 / 2019-08-19
==================
**fixes**
* [[`287e589`](http://github.com/koajs/koa/commit/287e589ac773d3738b2aa7d40e0b6d43dde5261b)] - fix: make options more compatibility (dead-horse <<dead_horse@qq.com>>)
2.8.0 / 2019-08-19
==================
**features**
* [[`5afff89`](http://github.com/koajs/koa/commit/5afff89eca0efe7081309dc2d123309e825df221)] - feat: accept options in the Application constructor (#1372) (Jake <<djakelambert@gmail.com>>)
**fixes**
* [[`ff70bdc`](http://github.com/koajs/koa/commit/ff70bdc75a30a37f63fc1f7d8cbae3204df3d982)] - fix: typo on document (#1355) (Jeff <<jeff.tian@outlook.com>>)
**others**
* [[`3b23865`](http://github.com/koajs/koa/commit/3b23865340cfba075f61f7dba0ea31fcc27260ec)] - docs: parameter of request.get is case-insensitive (#1373) (Gunnlaugur Thor Briem <<gunnlaugur@gmail.com>>)
* [[`a245d18`](http://github.com/koajs/koa/commit/a245d18a131341feec4f87659746954e78cae780)] - docs: Update response.socket (#1357) (Jeff <<jeff.tian@outlook.com>>)
* [[`d1d65dd`](http://github.com/koajs/koa/commit/d1d65dd29d7bbaf9ea42eaa5fcb0da3fb4df98e9)] - chore(deps): install egg-bin, mm as devDeps not deps (#1366) (Edvard Chen <<pigeon73101@gmail.com>>)
* [[`2c86b10`](http://github.com/koajs/koa/commit/2c86b10feafd868ebd071dda3a222e6f51972b5d)] - test: remove jest and use egg-bin(mocha) (#1363) (Yiyu He <<dead_horse@qq.com>>)
* [[`219bf22`](http://github.com/koajs/koa/commit/219bf22237b11bc375e2e110b93db512f1acfdd4)] - docs(context): update link (#1354) (Peng Jie <<bivinity.pengzjie@gmail.com>>)
* [[`52a6737`](http://github.com/koajs/koa/commit/52a673703a87a93c0f6a8552e6bd73caba66d2eb)] - chore: ignore Intellij IDEA project files (#1361) (Imon-Haque <<38266345+Imon-Haque@users.noreply.github.com>>)
* [[`b9e3546`](http://github.com/koajs/koa/commit/b9e35469d3bbd0a1ee92e0a815ce2512904d4a18)] - docs(api): fix keygrip link (#1350) (Peng Jie <<bivinity.pengzjie@gmail.com>>)
* [[`d4bdb5e`](http://github.com/koajs/koa/commit/d4bdb5ed9e2fe06ec44698b66c029f624135a0ab)] - chore: update eslint and fix lint errors (dead-horse <<dead_horse@qq.com>>)
* [[`12960c4`](http://github.com/koajs/koa/commit/12960c437cc25c53e682cfe5bff06d74a5bb1eb9)] - build: test on 8/10/12 (dead-horse <<dead_horse@qq.com>>)
* [[`00e8f7a`](http://github.com/koajs/koa/commit/00e8f7a1b7603aabdb7fb3567f485cb1c2076702)] - docs: ctx.type aliases ctx.response, not ctx.request (#1343) (Alex Berk <<berkalexanderc@gmail.com>>)
* [[`62f29eb`](http://github.com/koajs/koa/commit/62f29eb0c4dee01170a5511615e5bcc9faca26ca)] - docs(context): update cookies link (#1348) (Peng Jie <<dean.leehom@gmail.com>>)
* [[`b7fc526`](http://github.com/koajs/koa/commit/b7fc526ea49894f366153bd32997e02568c0b8a6)] - docs: fix typo in cookie path default value docs (#1340) (Igor Adamenko <<igoradamenko@users.noreply.github.com>>)
* [[`23f7f54`](http://github.com/koajs/koa/commit/23f7f545abfe1fb6499cd61cc8ff41fd86cef4a0)] - chore: simplify variable (#1332) (kzhang <<godky@users.noreply.github.com>>)
* [[`132c9ee`](http://github.com/koajs/koa/commit/132c9ee63f92a586a120ed3bd6b7ef023badb8bb)] - docs: Clarify the format of request.headers (#1325) (Dobes Vandermeer <<dobesv@gmail.com>>)
* [[`5810f27`](http://github.com/koajs/koa/commit/5810f279a4caeda115f39e429c9671795613abf8)] - docs: Removed Document in Progress note in Koa vs Express (#1336) (Andrew Peterson <<andrew@andpeterson.com>>)
* [[`75233d9`](http://github.com/koajs/koa/commit/75233d974a30af6e3b8ab38a73e5ede67172fc1c)] - chore: Consider removing this return statement; it will be ignored. (#1322) (Vern Brandl <<tkvern@users.noreply.github.com>>)
* [[`04e07fd`](http://github.com/koajs/koa/commit/04e07fdc620841068f12b8edf36f27e6592a0a18)] - test: Buffer() is deprecated due to security and usability issues. so use the Buffer.alloc() instead (#1321) (Vern Brandl <<tkvern@users.noreply.github.com>>)
* [[`130e363`](http://github.com/koajs/koa/commit/130e363856747b487652f04b5550056d7778e43a)] - docs: use 'fs-extra' instead of 'fs-promise' (#1309) (rosald <<35028438+rosald@users.noreply.github.com>>)
* [[`2f2078b`](http://github.com/koajs/koa/commit/2f2078bf998bd3f44289ebd17eeccf5e12e4c134)] - chore: Update PR-welcome badge url (#1299) (James George <<jamesgeorge998001@gmail.com>>)
2.7.0 / 2019-01-28
==================
**features**
* [[`b7bfa71`](http://github.com/koajs/koa/commit/b7bfa7113b8d1af49a57ab767f24a599ed92044f)] - feat: change set status assert, allowing valid custom statuses (#1308) (Martin Iwanowski <<martin@iwanowski.se>>)
**others**
* [[`72f325b`](http://github.com/koajs/koa/commit/72f325b78edd0dc2aac940a76ce5f644005ce4c3)] - chore: add pr welcoming badge (#1291) (James George <<jamesgeorge998001@gmail.com>>)
* [[`b15115b`](http://github.com/koajs/koa/commit/b15115b2cbfffe15827cd5e4368267d417b72f08)] - chore: Reduce unnecessary variable declarations (#1298) (call me saisai <<1457358080@qq.com>>)
* [[`ad91ce2`](http://github.com/koajs/koa/commit/ad91ce2346cb34e5d5a49d07dd952d15f6c832a3)] - chore: license 2019 (dead-horse <<dead_horse@qq.com>>)
* [[`b25e79d`](http://github.com/koajs/koa/commit/b25e79dfb599777a38157bd419395bd28369ee86)] - Mark two examples as live for the corresponding documentation change in https://github.com/koajs/koajs.com/pull/38. (#1031) (Francisco Ryan Tolmasky I <<tolmasky@gmail.com>>)
* [[`d9ef603`](http://github.com/koajs/koa/commit/d9ef60398e88f2c2f958ab2b159d38052ffe7f8a)] - chore: Optimize array split (#1295) (Mikhail Bodrov <<connormiha1@gmail.com>>)
* [[`9be8583`](http://github.com/koajs/koa/commit/9be858312553002841725b617050aaff3c48951d)] - chore: replace ~~ with Math.trunc in res.length (option) (#1288) (jeremiG <<gendronjeremi@gmail.com>>)
* [[`7e46c20`](http://github.com/koajs/koa/commit/7e46c2058cb5994809eab5f4dbb12f21e937c72b)] - docs: add link to the license file (#1290) (James George <<jamesgeorge998001@gmail.com>>)
* [[`48993ad`](http://github.com/koajs/koa/commit/48993ade9b0831fbce28d94b3b0963a4b0dccbdd)] - docs: Document other body types (#1285) (Douglas Wade <<douglas.b.wade@gmail.com>>)
* [[`acb388b`](http://github.com/koajs/koa/commit/acb388bc0546b48fca11dce8aa7a595af2cda5e2)] - docs: Add security vulnerability disclosure instructions to the Readme (#1283) (Douglas Wade <<douglas.b.wade@gmail.com>>)
* [[`a007198`](http://github.com/koajs/koa/commit/a007198fa23c19902b1f3ffb81498629e0e9c875)] - docs: Document ctx.app.emit (#1284) (Douglas Wade <<douglas.b.wade@gmail.com>>)
* [[`f90e825`](http://github.com/koajs/koa/commit/f90e825da9d505c11b4262c50cd54553f979c300)] - docs: response.set(fields) won't overwrites previous header fields(#1282) (Douglas Wade <<douglas.b.wade@gmail.com>>)
* [[`fc93c05`](http://github.com/koajs/koa/commit/fc93c05f68398f30abc46fd16ae6c673a1eee099)] - docs: update readme to add babel 7 instructions (#1274) (Vikram Rangaraj <<vik120@icloud.com>>)
* [[`5560f72`](http://github.com/koajs/koa/commit/5560f729124f022ffed00085aafea43dded7fb03)] - chore: use the ability of `content-type` lib directly (#1276) (Jordan <<mingmingwon@gmail.com>>)
2.6.2 / 2018-11-10
==================
**fixes**
* [[`9905199`](http://github.com/koajs/koa/commit/99051992a9f45eb0dd79e062681d6f5d366deb41)] - fix: Status message is not supported on HTTP/2 (#1264) (André Cruz <<andre@cabine.org>>)
**others**
* [[`325792a`](http://github.com/koajs/koa/commit/325792aee92de0ba6fea306657933fc63dc00474)] - docs: add table of contents for guide.md (#1267) (ZYSzys <<zyszys98@gmail.com>>)
* [[`71aaa29`](http://github.com/koajs/koa/commit/71aaa29591d6681f8579486f18d32ba1ee651a5b)] - docs: fix spelling in throw docs (#1269) (Martin Iwanowski <<martin@iwanowski.se>>)
* [[`bc81ca9`](http://github.com/koajs/koa/commit/bc81ca9414296234c764b7306a19ba72b2e59b52)] - chore: use res instead of this.res (#1271) (Jordan <<mingmingwon@gmail.com>>)
* [[`0251b38`](http://github.com/koajs/koa/commit/0251b38a8405471892c5eeaba7c8d54bd7028214)] - test: node v11 on travis (#1265) (Martin Iwanowski <<martin@iwanowski.se>>)
* [[`88b92b4`](http://github.com/koajs/koa/commit/88b92b43153f21609aee71d47abcd4dc27a6586d)] - doc: updated docs for throw() to pass status as first param. (#1268) (Waleed Ashraf <<waleedashraf@outlook.com>>)
2.6.1 / 2018-10-23
==================
**fixes**
* [[`4964242`](http://github.com/koajs/koa/commit/49642428342e5f291eb9d690802e83ed830623b5)] - fix: use X-Forwarded-Host first on app.proxy present (#1263) (fengmk2 <<fengmk2@gmail.com>>)
2.6.0 / 2018-10-23
==================
**features**
* [[`9c5c58b`](http://github.com/koajs/koa/commit/9c5c58b18363494976185e7ddc790ac63de840ed)] - feat: use :authority header of http2 requests as host (#1262) (Martin Michaelis <<code@mgjm.de>>)
* [[`9146024`](http://github.com/koajs/koa/commit/9146024e1094e8bb871ab15d1b7fc556a710732f)] - feat: response.attachment append a parameter: options from contentDisposition (#1240) (小雷 <<863837949@qq.com>>)
**others**
* [[`d32623b`](http://github.com/koajs/koa/commit/d32623baa7a6273d47be67d587ad4ea0ecffc5de)] - docs: Update error-handling.md (#1239) (urugator <<j.placek@centrum.cz>>)
2.5.3 / 2018-09-11
==================
**fixes**
* [[`2ee32f5`](http://github.com/koajs/koa/commit/2ee32f50b88b383317e33cc0a4bfaa5f2eadead7)] - fix: pin debug@~3.1.0 avoid deprecated warnning (#1245) (fengmk2 <<fengmk2@gmail.com>>)
**others**
* [[`2180839`](http://github.com/koajs/koa/commit/2180839eda2cb16edcfda46ccfe24711680af850)] - docs: Update koa-vs-express.md (#1230) (Clayton Ray <<iamclaytonray@gmail.com>>)
2.5.2 / 2018-07-12
==================
* deps: upgrade all dependencies
* perf: avoid stringify when set header (#1220)
* perf: cache content type's result (#1218)
* perf: lazy init cookies and ip when first time use it (#1216)
* chore: fix comment & approve cov (#1214)
* docs: fix grammar
* test&cov: add test case (#1211)
* Lazily initialize `request.accept` and delegate `context.accept` (#1209)
* fix: use non deprecated custom inspect (#1198)
* Simplify processes in the getter `request.protocol` (#1203)
* docs: better demonstrate middleware flow (#1195)
* fix: Throw a TypeError instead of a AssertionError (#1199)
* chore: mistake in a comment (#1201)
* chore: use this.res.socket insteadof this.ctx.req.socket (#1177)
* chore: Using "listenerCount" instead of "listeners" (#1184)
2.5.1 / 2018-04-27
==================
* test: node v10 on travis (#1182)
* fix tests: remove unnecessary assert doesNotThrow and api calls (#1170)
* use this.response insteadof this.ctx.response (#1163)
* deps: remove istanbul (#1151)
* Update guide.md (#1150)
2.5.0 / 2018-02-11
==================
* feat: ignore set header/status when header sent (#1137)
* run coverage using --runInBand (#1141)
* [Update] license year to 2018 (#1130)
* docs: small grammatical fix in api docs index (#1111)
* docs: fixed typo (#1112)
* docs: capitalize K in word koa (#1126)
* Error handling: on non-error throw try to stringify if error is an object (#1113)
* Use eslint-config-koa (#1105)
* Update mgol's name in AUTHORS, add .mailmap (#1100)
* Avoid generating package locks instead of ignoring them (#1108)
* chore: update copyright year to 2017 (#1095)
2.4.1 / 2017-11-06
==================
* fix bad merge w/ 2.4.0
2.4.0 / 2017-11-06
==================
UNPUBLISHED
* update `package.engines.node` to be more strict
* update `fresh@^0.5.2`
* fix: `inspect()` no longer crashes `context`
* fix: gated `res.statusMessage` for HTTP/2
* added: `app.handleRequest()` is exposed
2.3.0 / 2017-06-20
==================
* fix: use `Buffer.from()`
* test on node 7 & 8
* add `package-lock.json` to `.gitignore`
* run `lint --fix`
* add `request.header` in addition to `request.headers`
* add IPv6 hostname support
2.2.0 / 2017-03-14
==================
* fix: drop `package.engines.node` requirement to >= 6.0.0
* this fixes `yarn`, which errors when this semver range is not satisfied
* bump `cookies@~0.7.0`
* bump `fresh@^0.5.0`
2.1.0 / 2017-03-07
==================
* added: return middleware chain promise from `callback()` #848
* added: node v7.7+ `res.getHeaderNames()` support #930
* added: `err.headerSent` in error handling #919
* added: lots of docs!
2.0.1 / 2017-02-25
==================
NOTE: we hit a versioning snafu. `v2.0.0` was previously released,
so `v2.0.1` is released as the first `v2.x` with a `latest` tag.
* upgrade mocha #900
* add names to `application`'s request and response handlers #805
* breaking: remove unused `app.name` #899
* breaking: drop official support for node < 7.6
2.0.0 / ??????????
==================
* Fix malformed content-type header causing exception on charset get (#898)
* fix: subdomains should be [] if the host is an ip (#808)
* don't pre-bound onerror [breaking change] (#800)
* fix `ctx.flushHeaders()` to use `res.flushHeaders()` instead of `res.writeHead()` (#795)
* fix(response): correct response.writable logic (#782)
* merge v1.1.2 and v1.2.0 changes
* include `koa-convert` so that generator functions still work
* NOTE: generator functions are deprecated in v2 and will be removed in v3
* improve linting
* improve docs
2.0.0-alpha.8 / 2017-02-13
==================
* Fix malformed content-type header causing exception on charset get (#898)
2.0.0-alpha.7 / 2016-09-07
==================
* fix: subdomains should be [] if the host is an ip (#808)
2.0.0-alpha.6 / 2016-08-29
==================
* don't pre-bound onerror [breaking change]
2.0.0-alpha.5 / 2016-08-10
==================
* fix `ctx.flushHeaders()` to use `res.flushHeaders()` instead of `res.writeHead()`
2.0.0-alpha.4 / 2016-07-23
==================
* fix `response.writeable` during pipelined requests
1.2.0 / 2016-03-03
==================
* add support for `err.headers` in `ctx.onerror()`
- see: https://github.com/koajs/koa/pull/668
- note: you should set these headers in your custom error handlers as well
- docs: https://github.com/koajs/koa/blob/master/docs/error-handling.md
* fix `cookies`' detection of http/https
- see: https://github.com/koajs/koa/pull/614
* deprecate `app.experimental = true`. Koa v2 does not use this signature.
* add a code of conduct
* test against the latest version of node
* add a lot of docs
1.1.2 / 2015-11-05
==================
* ensure parseurl always working as expected
* fix Application.inspect() – missing .proxy value.
2.0.0-alpha.3 / 2015-11-05
==================
* ensure parseurl always working as expected. #586
* fix Application.inspect() – missing .proxy value. Closes #563
2.0.0-alpha.2 / 2015-10-27
==================
* remove `co` and generator support completely
* improved documentation
* more refactoring into ES6
2.0.0-alpha.1 / 2015-10-22
==================
* change the middleware signature to `async (ctx, next) => await next()`
* drop node < 4 support and rewrite the codebase in ES6
1.1.1 / 2015-10-22
==================
* do not send a content-type when the type is unknown #536
1.1.0 / 2015-10-11
==================
* add `app.silent=<Boolean>` to toggle error logging @tejasmanohar #486
* add `ctx.origin` @chentsulin #480
* various refactoring
- add `use strict` everywhere
1.0.0 / 2015-08-22
==================
* add `this.req` check for `querystring()`
* don't log errors with `err.expose`
* `koa` now follows semver!
0.21.0 / 2015-05-23
==================
* empty `request.query` objects are now always the same instance
* bump `fresh@0.3.0`
0.20.0 / 2015-04-30
==================
Breaking change if you're using `this.get('ua') === undefined` etc.
For more details please checkout [#438](https://github.com/koajs/koa/pull/438).
* make sure helpers return strict string
* feat: alias response.headers to response.header
0.19.1 / 2015-04-14
==================
* non-error thrown, fixed #432
0.19.0 / 2015-04-05
==================
* `req.host` and `req.hostname` now always return a string (semi-breaking change)
* improved test coverage
0.18.1 / 2015-03-01
==================
* move babel to `devDependencies`
0.18.0 / 2015-02-14
==================
* experimental es7 async function support via `app.experimental = true`
* use `content-type` instead of `media-typer`
0.17.0 / 2015-02-05
==================
Breaking change if you're using an old version of node v0.11!
Otherwise, you should have no trouble upgrading.
* official iojs support
* drop support for node.js `>= 0.11.0 < 0.11.16`
* use `Object.setPrototypeOf()` instead of `__proto__`
* update dependencies
0.16.0 / 2015-01-27
==================
* add `res.append()`
* fix path usage for node@0.11.15
0.15.0 / 2015-01-18
==================
* add `this.href`
0.14.0 / 2014-12-15
==================
* remove `x-powered-by` response header
* fix the content type on plain-text redirects
* add ctx.state
* bump `co@4`
* bump dependencies
0.13.0 / 2014-10-17
==================
* add this.message
* custom status support via `statuses`
0.12.2 / 2014-09-28
==================
* use wider semver ranges for dependencies koa maintainers also maintain
0.12.1 / 2014-09-21
==================
* bump content-disposition
* bump statuses
0.12.0 / 2014-09-20
==================
* add this.assert()
* use content-disposition
0.11.0 / 2014-09-08
==================
* fix app.use() assertion #337
* bump a lot of dependencies
0.10.0 / 2014-08-12
==================
* add `ctx.throw(err, object)` support
* add `ctx.throw(err, status, object)` support
0.9.0 / 2014-08-07
==================
* add: do not set `err.expose` to true when err.status not a valid http status code
* add: alias `request.headers` as `request.header`
* add context.inspect(), cleanup app.inspect()
* update cookies
* fix `err.status` invalid lead to uncaughtException
* fix middleware gif, close #322
0.8.2 / 2014-07-27
==================
* bump co
* bump parseurl
0.8.1 / 2014-06-24
==================
* bump type-is
0.8.0 / 2014-06-13
==================
* add `this.response.is()``
* remove `.status=string` and `res.statusString` #298
0.7.0 / 2014-06-07
==================
* add `this.lastModified` and `this.etag` as both getters and setters for ubiquity #292.
See koajs/koa@4065bf7 for an explanation.
* refactor `this.response.vary()` to use [vary](https://github.com/expressjs/vary) #291
* remove `this.response.append()` #291
0.6.3 / 2014-06-06
==================
* fix res.type= when the extension is unknown
* assert when non-error is passed to app.onerror #287
* bump finished
0.6.2 / 2014-06-03
==================
* switch from set-type to mime-types
0.6.1 / 2014-05-11
==================
* bump type-is
* bump koa-compose
0.6.0 / 2014-05-01
==================
* add nicer error formatting
* add: assert object type in ctx.onerror
* change .status default to 404. Closes #263
* remove .outputErrors, suppress output when handled by the dev. Closes #272
* fix content-length when body is re-assigned. Closes #267
0.5.5 / 2014-04-14
==================
* fix length when .body is missing
* fix: make sure all intermediate stream bodies will be destroyed
0.5.4 / 2014-04-12
==================
* fix header stripping in a few cases
0.5.3 / 2014-04-09
==================
* change res.type= to always default charset. Closes #252
* remove ctx.inspect() implementation. Closes #164
0.5.2 / 2014-03-23
==================
* fix: inspection of `app` and `app.toJSON()`
* fix: let `this.throw`n errors provide their own status
* fix: overwriting of `content-type` w/ `HEAD` requests
* refactor: use statuses
* refactor: use escape-html
* bump dev deps
0.5.1 / 2014-03-06
==================
* add request.hostname(getter). Closes #224
* remove response.charset and ctx.charset (too confusing in relation to ctx.type) [breaking change]
* fix a debug() name
0.5.0 / 2014-02-19
==================
* add context.charset
* add context.charset=
* add request.charset
* add response.charset
* add response.charset=
* fix response.body= html content sniffing
* change ctx.length and ctx.type to always delegate to response object [breaking change]
0.4.0 / 2014-02-11
==================
* remove app.jsonSpaces settings - moved to [koa-json](https://github.com/koajs/json)
* add this.response=false to bypass koa's response handling
* fix response handling after body has been sent
* changed ctx.throw() to no longer .expose 5xx errors
* remove app.keys getter/setter, update cookies, and remove keygrip deps
* update fresh
* update koa-compose
0.3.0 / 2014-01-17
==================
* add ctx.host= delegate
* add req.host=
* add: context.throw supports Error instances
* update co
* update cookies
0.2.1 / 2013-12-30
==================
* add better 404 handling
* add check for fn._name in debug() output
* add explicit .toJSON() calls to ctx.toJSON()
0.2.0 / 2013-12-28
==================
* add support for .throw(status, msg). Closes #130
* add GeneratorFunction assertion for app.use(). Closes #120
* refactor: move `.is()` to `type-is`
* refactor: move content negotiation to "accepts"
* refactor: allow any streams with .pipe method
* remove `next` in callback for now
0.1.2 / 2013-12-21
==================
* update co, koa-compose, keygrip
* use on-socket-error
* add throw(status, msg) support
* assert middleware is GeneratorFunction
* ducktype stream checks
* remove `next` is `app.callback()`
0.1.1 / 2013-12-19
==================
* fix: cleanup socker error handler on response