@idio/dicer


@idio/dicer is a fork of A Very Fast Streaming Multipart Parser For Node.JS Written In ES6 And Optimised With JavaScript Compiler.

``sh
yarn add @idio/dicer
`

Table Of Contents

- Table Of Contents
- API
- class Dicer
* _idio.DicerConfig
* _idio.Dicer
- Copyright

API

The package is available by importing its default function:

`js
import Dicer from '@idio/dicer'
`

class Dicer

Dicer is a _Writable_ stream.

import('stream').WritableOptions __stream.WritableOptions__

_idio.DicerConfig extends stream.WritableOptions: Options for the program.

| Name | Type | Description | Default |
| -------------- | ---------------- | ---------------------------------------------------------------- | ------- |
| boundary | string | This is the boundary used to detect the beginning of a new part. | - |
| headerFirst | boolean | If true, preamble header parsing will be performed first. | false |
| partHwm | boolean | High watermark for parsing parts. | - |
| maxHeaderPairs | number | The maximum number of header key=>value pairs to parse. | 2000 |

_idio.Dicer

| Name | Type | Description |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| __constructor__ | new (cfg?: !_idio.DicerConfig) => _idio.Dicer | Creates a new instance. |
| __setBoundary__ | (boundary: string) => void | Sets the boundary to use for parsing and performs some initialization needed for parsing. You should only need to use this if you set headerFirst to true in the constructor and are parsing the boundary from the preamble header. |
| ___ignore__ | () => void | Ignores current part. |

`js
import Dicer from '@idio/dicer'
import { createServer } from 'http'
import { inspect } from 'util'

const RE_BOUNDARY = /^multipart\/.+?(?:; boundary=(?:(?:"(.+)")|(?:([^\s]+))))$/i,
HTML = Buffer.from('\


d.on('part', function(p) {
console.log('New part!')
p.on('header', function(header) {
for (var h in header) {
console.log('Part header: k: ' + inspect(h)
+ ', v: ' + inspect(header[h]))
}
})
p.on('data', function(data) {
console.log('Part data: ' + inspect(data.toString()))
})
p.on('end', function() {
console.log('End of part\n')
})
})
d.on('finish', function() {
console.log('End of parts')
res.writeHead(200)
res.end('Form submission successful!')
})
req.pipe(d)
} else if (req.method === 'GET' && req.url === '/') {
res.writeHead(200)
res.end(HTML)
} else {
res.writeHead(404)
res.end()
}
}).listen(PORT, function() {
console.log('Listening for requests on port ' + PORT)
this.close()
})
`
`
Listening for requests on port 8080
``

Copyright

Original Work by Brian White aka mscdex.

---

alt="Art Deco">	© Art Deco for Idio 2019		alt="Tech Nation Visa">	Tech Nation Visa Sucks