Streaming HTTP request body parser
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Corps Build Status

Streaming HTTP request body parser

npm install corps


var body = require('corps');

http.createServer(function(req, res) { {
		res.end(data.greeting + "world");
$ curl -X POST -D '{"greeting": "salutations"}' -H 'Content-type: application/json' localhost:8000

salutations world

$ curl -X POST -D 'greeting=what+ho' -H 'Content-type: application/x-www-form-urlencoded' localhost:8000

what ho world


auto :: Request → Stream Params

Sniffs Content-type and parses the request body with the appropriate parser. Knows about application/json and application/x-www-form-urlencoded to begin with. Everything else is left as raw strings. To teach it about other formats, add to mimeParsers.

json, query, raw

Individual parsers that comprise auto. Use one of these if you know what format the data will be in.

mimeParsers :: Map ContentType (Request → Stream Params)

A map of Content-types to parsers. A parser is a function that takes a request and returns a stream containing a single parameters object.

bodyParams :: (String → Stream Params) → Request → Stream Params

Lets a parser that works on strings work with request streams.

`handleError :: (String → Params) → String → Stream Params

Wraps a simple parser (that could throw errors) such as JSON.parse in a stream that handles exceptions.