co-body

Parse request bodies with generators inspired by Raynos/body.

Installation

1$ npm install co-body

Options

• limit number or string representing the request size limit (1mb for json and 56kb for form-urlencoded)
• strict when set to true, JSON parser will only accept arrays and objects; when false will accept anything JSON.parse accepts. Defaults to true. (also strict mode will always return object).
• onProtoPoisoning Defines what action the co-body lib must take when parsing a JSON object with __proto__. This functionality is provided by bourne. See Prototype-Poisoning for more details about prototype poisoning attacks. Possible values are 'error', 'remove' and 'ignore'. Default to 'error', it will throw a SyntaxError when Prototype-Poisoning happen.
• queryString an object of options when parsing query strings and form data. See qs for more information.
• returnRawBody when set to true, the return value of co-body will be an object with two properties: { parsed: /* parsed value */, raw: /* raw body */}.
• jsonTypes is used to determine what media type co-body will parse as json, this option is passed directly to the type-is library.
• formTypes is used to determine what media type co-body will parse as form, this option is passed directly to the type-is library.
• textTypes is used to determine what media type co-body will parse as text, this option is passed directly to the type-is library.

more options available via raw-body:

Example

1// application/json
2var body = await parse.json(req);
3
4// explicit limit
5var body = await parse.json(req, { limit: '10kb' });
6
7// application/x-www-form-urlencoded
8var body = await parse.form(req);
9
10// text/plain
11var body = await parse.text(req);
12
13// either
14var body = await parse(req);
15
16// custom type
17var body = await parse(req, { textTypes: ['text', 'html'] });

Koa

This lib also supports ctx.req in Koa (or other libraries), so that you may simply use this instead of this.req.

1// application/json
2var body = await parse.json(this);
3
4// application/x-www-form-urlencoded
5var body = await parse.form(this);
6
7// text/plain
8var body = await parse.text(this);
9
10// either
11var body = await parse(this);

License

MIT