Parter

A Promise based version of busboy

Documentation

Parter uses busboy under the hood. In fact, parter is written to make busboy promise based. To install parter, run

1yarn add parter

or,

1npm install parter

Now, you can import it and instantiate it,

1import parter from 'parter';
2
3async function requestHandler(req, res){
4    // other things
5    const body = await parter(req);
6    // other things
7}

When we try to log body, we will get an object similar to this

1{
2        fields:{
3                name: <String>,
4                value: <String>,
5                info: <Object>
6        },
7        files:{
8                name: <String>,
9                content: <Buffer>,
10                info: <Object>
11        }
12}

Notice, we pass in req as the first argument. The req we pass in must be an instance of IncomingMessage from node http module or it can be an instance of Request constructor.

You can also pass in an abject as a second parameter. This object is to configure parter. As, parter uses busboy, this is the same configuration object you would pass in busboy. But, you can, of course pass additional properties.

1options.errorOnMoreFields = <Boolean>
2options.errorOnMoreFiles = <Boolean>
3options.errorOnMoreParts = <Boolean>
4options.errorOnLargerFileSize = <Boolean>

• errorOnMoreFields

    Whether to reject if `fieldsLimit` is emitted from busboy
  

• errorOnMoreFiles

    Whether to reject if `filesLimit` is emitted from busboy
  

• errorOnMoreParts

    Whether to reject if `partsLimit` is emitted from busboy
  

• errorOnLargerFileSize

    Whether to reject if `limit` is emitted from busboy.
    
  

Authors

• @mr-m1m3