SkillAgentSearch skills...

Onerror

an error handler for koa, hack ctx.onerror

Install / Use

/learn @koajs/Onerror
About this skill

Quality Score

0/100

Supported Platforms

Universal

README

koa-onerror

NPM version Test coverage Known Vulnerabilities npm download Node.js Version PRs Welcome

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.

install

npm install koa-onerror

Usage

const fs = require('fs');
const Koa = require('koa');
const { onerror } = require('koa-onerror');

const app = new Koa();

onerror(app);

app.use(ctx => {
  // foo();
  ctx.body = fs.createReadStream('not exist');
});

Options

onerror(app, options);
  • all: if options.all exist, ignore negotiation
  • text: text error handler
  • json: json error handler
  • html: html error handler
  • redirect: if accept html or text, can redirect to another error page

check out default handler to write your own handler.

Status and Headers

koa-onerror will automatic set err.status as response status code, and err.headers as response headers.

License

MIT

Contributors

Contributors

Made with contributors-img.

View on GitHub
GitHub Stars141
CategoryDevelopment
Updated8mo ago
Forks19

Languages

TypeScript

Security Score

87/100

Audited on Jul 19, 2025

No findings