koa error handler, hack ctx.onerror


an error handler for koa, hack ctx.onerror.

different with koa-error:

  • we can not just use try catch to handle all errors, steams' and events' errors are directly handle by ctx.onerror, so if we want to handle all errors in one place, the only way i can see is to hack ctx.onerror.
  • it is more customizable.
npm install koa-onerror
var fs = require('fs');
var koa = require('koa');
var onerror = require('koa-onerror');
var app = koa();
app.use(function *(){
  // foo(); 
  this.body = fs.createReadStream('not exist');
onerror(app, options);
  • all: if options.all exist, ignore negotiation
  • text: text error handler
  • json: json error handler
  • html: html error handler
  • template: default html error handler template path
  • redirect: if accepct html, can redirect to another error page

check out default handler to write your own handler.