# parted

> A streaming body parser

Latest version **0.1.1** (published 2013-02-10) · 0 weekly downloads

## Install

```sh
npm install parted
pnpm add parted
yarn add parted
bun add parted
```

## Health

**Score 10/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; low quality score; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.1.1 |
| Published | 2013-02-10 |
| First published | 2011-10-29 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 62 |
| Author | Christopher Jeffrey |
| Maintainers | chjj |
| Keywords | multipart, parser, http, express, middleware |

## Links

- npm: https://www.npmjs.com/package/parted
- Repository: https://github.com/chjj/parted
- npm.io page: https://npm.io/package/parted

## Alternatives

- [babylon](https://npm.io/package/babylon.md) — 5.1M weekly downloads
- [csscolorparser](https://npm.io/package/csscolorparser.md) — 3.7M weekly downloads
- [expr-eval-fork](https://npm.io/package/expr-eval-fork.md) — 1.5M weekly downloads
- [@leeoniya/ufuzzy](https://npm.io/package/@leeoniya/ufuzzy.md) — 247.7K weekly downloads
- [xml-parser](https://npm.io/package/xml-parser.md) — 78.4K weekly downloads

## Recent versions

- 0.1.1 (latest) — 2013-02-10
- 0.1.0 — 2012-01-30
- 0.0.1 — 2011-12-08
- 0.0.2 — 2011-12-08
- 0.0.3 — 2011-12-08
- 0.0.4 — 2011-12-08
- 0.0.5 — 2011-12-08
- 0.0.6 — 2011-12-08
- 0.0.9 — 2011-12-08
- 0.0.8 — 2011-11-10
- 0.0.7 — 2011-10-29

## README

# parted

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.

## Install

``` bash
$ npm install parted
```

## As a middleware

``` js
var parted = require('parted');

app.use(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:

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

However when `multiple` is enabled, this _may_ be an array:

```js
{ images:
   [ '/tmp/bigred-pau.1319577761529.png',
     '/tmp/bigred-ico.1319577761528.png',
     '/tmp/bigred-rec.1319577761529.png',
     '/tmp/bigred-sto.1319577761529.png',
     '/tmp/bigred.1319577761529.png' ] }
```

## Usage

### The multipart parser alone

``` js
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) {
  req.destroy();
  next(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() {
  console.log(parts);
});

req.pipe(parser);
```

## Running tests

    $ node test

---
_Source: https://npm.io/package/parted · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._