busboy-body-parser
Body parsing for multipart/form-data forms in Express.
Last updated 9 months ago by lennym .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install busboy-body-parser 
SYNC missed versions from official npm registry.

busboy-body-parser

Body parsing for multipart/form-data forms in Express.

It will add regular fields to req.body as per body-parser but will also add uploaded files to req.files.

Install

npm install busboy-body-parser

Usage

Basic usage

const busboyBodyParser = require('busboy-body-parser');
app.use(busboyBodyParser());

Define a file-size limit

This is defined similarly to the limit option in body-parser but is applied to individual files rather than the total body size.

const busboyBodyParser = require('busboy-body-parser');
app.use(busboyBodyParser({ limit: '5mb' }));

This limit can be defined as either a number of bytes, or any string supported by bytes - eg. '5mb', '500kb'.

Uploading multiple files with the same key

The upload of multiple files with the same key is not enabled by default. If you wish to support this you will need to set the multi option to true.

const busboyBodyParser = require('busboy-body-parser');
app.use(busboyBodyParser({ multi: true }));

Important note: if multi is set to true, then all req.files[key] will always be an array, irrespective of the nuber of files associated with that key.

Output

The middleware will add files to req.files in the following form:

// req.files:
{
    fieldName: {
        data: Buffer("raw file data"),
        name: "upload.txt",
        encoding: "utf8",
        mimetype: "text/plain",
        truncated: false
    }
}

If a file has exceeded the file-size limit defined above it will have data: null and truncated: true:

// req.files:
{
    fieldName: {
        data: null,
        name: "largefile.txt",
        encoding: "utf8",
        mimetype: "text/plain",
        truncated: true
    }
}

If the multi property is set:

// req.files:
{
    fieldName: [{
        data: Buffer("raw file data"),
        name: "upload.txt",
        encoding: "utf8",
        mimetype: "text/plain",
        truncated: false
    }]
}

Tests

npm test

Current Tags

  • 0.3.2                                ...           latest (9 months ago)

15 Versions

  • 0.3.2                                ...           9 months ago
  • 0.3.1                                ...           a year ago
  • 0.3.0                                ...           2 years ago
  • 0.2.0                                ...           2 years ago
  • 0.1.0                                ...           2 years ago
  • 0.0.10                                ...           3 years ago
  • 0.0.9                                ...           4 years ago
  • 0.0.8                                ...           4 years ago
  • 0.0.7                                ...           4 years ago
  • 0.0.6                                ...           4 years ago
  • 0.0.5                                ...           4 years ago
  • 0.0.4                                ...           4 years ago
  • 0.0.3                                ...           4 years ago
  • 0.0.2                                ...           4 years ago
  • 0.0.1                                ...           4 years ago
Maintainers (1)
Downloads
Today 0
This Week 2
This Month 32
Last Day 1
Last Week 15
Last Month 18
Dependencies (4)
Dev Dependencies (5)

Copyright 2014 - 2016 © taobao.org |