app.on('error', (err, ctx) => {
  log.error('server error', err, ctx)
});

默認(rèn)情況下 Koa 會(huì)將所有錯(cuò)誤信息輸出到 stderr， 除非 app.silent 是 true。當(dāng) err.status 是 404 或者 err.expose 時(shí)，默認(rèn)錯(cuò)誤處理程序也不會(huì)輸出錯(cuò)誤

app.use(async ctx => {
  ctx; // 這是上下文 Context
  ctx.request;  // 這是 koa Request
  ctx.response; // 這是 koa Response
});

ctx.throw(400);
ctx.throw(400, 'name required');
ctx.throw(400, 'name required', { user: user });

this.throw('name required', 400) 等價(jià)于

const err = new Error('name required');
err.status = 400;
err.expose = true;
throw err;

ctx.assert(
  ctx.state.user,
  401,
  'User not found. Please login!'
);

以下訪問(wèn)器和別名與 Request 等價(jià)：

• ctx.header
• ctx.headers
• ctx.method
• ctx.method=
• ctx.url
• ctx.url=
• ctx.originalUrl
• ctx.origin
• ctx.href
• ctx.path
• ctx.path=
• ctx.query
• ctx.query=
• ctx.querystring
• ctx.querystring=
• ctx.host
• ctx.hostname
• ctx.fresh
• ctx.stale
• ctx.socket
• ctx.protocol
• ctx.secure
• ctx.ip
• ctx.ips
• ctx.subdomains
• ctx.is()
• ctx.accepts()
• ctx.acceptsEncodings()
• ctx.acceptsCharsets()
• ctx.acceptsLanguages()
• ctx.get()

以下訪問(wèn)器和別名與 Response 等價(jià)：

• ctx.body
• ctx.body=
• ctx.status
• ctx.status=
• ctx.message
• ctx.message=
• ctx.length=
• ctx.length
• ctx.type=
• ctx.type
• ctx.headerSent
• ctx.redirect()
• ctx.attachment()
• ctx.set()
• ctx.append()
• ctx.remove()
• ctx.lastModified=
• ctx.etag=

// freshness 檢查需要狀態(tài) 20x 或 304
ctx.status = 200;
ctx.set('ETag', '123');

// 緩存正常
if (ctx.fresh) {
  ctx.status = 304;
  return;
}

// 緩存已過(guò)時(shí)
// 獲取新數(shù)據(jù)
ctx.body = await db.find('something');

// Content-Type: text/html; charset=utf-8
ctx.is('html'); // => 'html'
ctx.is('text/html'); // => 'text/html'
ctx.is('text/*', 'text/html');
// => 'text/html'
// 當(dāng) Content-Type 為 application/json 時(shí)
ctx.is('json', 'urlencoded'); // => 'json'
ctx.is('application/json');
// => 'application/json'
ctx.is('html', 'application/*');
// => 'application/json'

ctx.is('html'); // => false

// 接受: text/*, application/json
ctx.accepts('html');
// => "html"
ctx.accepts('text/html');
// => "text/html"
ctx.accepts('json', 'text');
// => "json"
ctx.accepts('application/json');
// => "application/json"

// Accept-Charset: utf-8, iso-8859-1;q=0.2, utf-7;q=0.5
ctx.acceptsCharsets('utf-8', 'utf-7');
// => "utf-8"

ctx.acceptsCharsets(['utf-7', 'utf-8']);
// => "utf-8"

檢查 charsets 是否可以被接受，如果為 true 則返回最佳匹配， 否則返回 false

ctx.set({
  'Etag': '1234',
  'Last-Modified': date
});

使用對(duì)象同時(shí)設(shè)置 response header 中多個(gè)字段的值

const ct = ctx.type;
// => "image/png"

獲取 response Content-Type，不包含像"charset"這樣的參數(shù)