Streaming body parser for node.js.
Latest commit 3ae02ca Jan 29, 2015 @chjj Merge pull request #14 from hflw/master
Fixed bug where passing in invalid data would throw errors instead of passing them through next()
Failed to load latest commit information.
lib fixed bug where passing in invalid data would throw errors instead of… Jan 29, 2015
test add test for multiple values. Feb 10, 2013
.gitignore gitignore Oct 17, 2011
LICENSE license Jan 30, 2012
index.js temporary fix for json parser Oct 17, 2011
package.json v0.1.1 Feb 10, 2013


Parted is a streaming multipart, json, and urlencoded parser for node.js, written from scratch. It comes bundled with an express middleware which will use the necessary parser depending on the request mime type. Each parser is also lazily loaded, so there is no unnecessary memory usage if you only need one of them.

The middleware will leave you with a req.body object, similar to the default body parser included in express. If a file was included with a multipart request, a temporary path to the uploaded file is provided in req.body. The multipart parser will also create a req.files object specifically for files if you prefer.

Every parser handles nested fields in the same way node-querystring does.

Note; Although the JSON and qs/encoded parsers are streaming, they're disabled by default and buffering parsers are used instead. Use the stream option to enable them.


$ npm install parted

As a middleware

var parted = require('parted');

  // custom file path
  path: __dirname + '/uploads',
  // memory usage limit per request
  limit: 30 * 1024,
  // disk usage limit per request
  diskLimit: 30 * 1024 * 1024,
  // enable streaming for json/qs
  stream: true

When multiple is disabled only a single part will be present for a given name, for example:

{ image: '/tmp/bigred.1319577761529.png' }

However when multiple is enabled, this may be an array:

{ images:
   [ '/tmp/bigred-pau.1319577761529.png',
     '/tmp/bigred.1319577761529.png' ] }


The multipart parser alone

var multipart = require('parted').multipart;

var options = {
  limit: 30 * 1024,
  diskLimit: 30 * 1024 * 1024

var parser = new multipart(type, options)
  , parts = {};

parser.on('error', function(err) {

parser.on('part', function(field, part) {
  // temporary path or string
  parts[field] = part;

parser.on('data', function() {
  console.log('%d bytes written.', this.written);

parser.on('end', function() {


Running tests

$ node test