koa-bodyparser

A body parser for koa, based on co-body. support json, form and text type body.

Notice: this module doesn't support parsing multipart format data, please use @koa/multer to parse multipart format data.

Install

Usage

1const Koa = require('koa');
2const bodyParser = require('koa-bodyparser');
3
4const app = new Koa();
5app.use(bodyParser());
6
7app.use(async ctx => {
8  // the parsed body will store in ctx.request.body
9  // if nothing was parsed, body will be an empty object {}
10  ctx.body = ctx.request.body;
11});

Options

• enableTypes: parser will only parse when request type hits enableTypes, support json/form/text/xml, default is ['json', 'form'].

• encoding: requested encoding. Default is utf-8 by co-body.

• formLimit: limit of the urlencoded body. If the body ends up being larger than this limit, a 413 error code is returned. Default is 56kb.

• jsonLimit: limit of the json body. Default is 1mb.

• textLimit: limit of the text body. Default is 1mb.

• xmlLimit: limit of the xml body. Default is 1mb.

• strict: when set to true, JSON parser will only accept arrays and objects. Default is true. See strict mode in co-body. In strict mode, ctx.request.body will always be an object(or array), this avoid lots of type judging. But text body will always return string type.

• detectJSON: custom json request detect function. Default is null.

  1app.use(bodyParser({
  2  detectJSON: function (ctx) {
  3    return /\.json$/i.test(ctx.path);
  4  }
  5}));

• extendTypes: support extend types:

  1app.use(bodyParser({
  2  extendTypes: {
  3    json: ['application/x-javascript'] // will parse application/x-javascript type body as a JSON string
  4  }
  5}));

• onerror: support custom error handle, if koa-bodyparser throw an error, you can customize the response like:

  1app.use(bodyParser({
  2  onerror: function (err, ctx) {
  3    ctx.throw(422, 'body parse error');
  4  }
  5}));

• disableBodyParser: you can dynamic disable body parser by set ctx.disableBodyParser = true.

  1app.use(async (ctx, next) => {
  2  if (ctx.path === '/disable') ctx.disableBodyParser = true;
  3  await next();
  4});
  5app.use(bodyParser());

Raw Body

You can access raw request body by ctx.request.rawBody after koa-bodyparser when:

1. koa-bodyparser parsed the request body.
2. ctx.request.rawBody is not present before koa-bodyparser.

Koa 1 Support

To use koa-bodyparser with koa@1, please use bodyparser 2.x.

1npm install koa-bodyparser@2 --save

Licences

---

MIT