multipart.js

Multipart

Simple and lite of multipart/form-data implementation, most similar to form-data.

Kind: global class
Since: v0.7.0

• Multipart
  • new Multipart()
  • .mimeTypes
  • .dashDash
  • .boundary
  • .EMPTY
  • .CRLF
  • .data
  • .indices
  • .getBuffer() ⇒ Buffer
  • .getHeaders() ⇒ object.<string, string>
  • .appendMimeTypes(things) ⇒ this
  • .append(name, value, [filename]) ⇒ this
  • .formed(name, value, [filename]) ⇒ Array.<(Buffer|ReadStream)>
  • .set(name, value, [filename]) ⇒ this
  • .delete(name) ⇒ this
  • .get(name) ⇒ Buffer | ReadStream | undefined
  • .getAll(name) ⇒ Array.<(Buffer|ReadStream)>
  • .has(name) ⇒ boolean
  • .entries() ⇒ Iterator.<Array.<EntryTuple.<(string|undefined), (Buffer|ReadStream)>>>
  • .keys() ⇒ Iterator.<(string|undefined)>
  • .values() ⇒ Iterator.<(Buffer|ReadStream)>
  • .toJSON() ⇒ object.<string, string> | null
  • .toString() ⇒ string
  • .flowing([end]) ⇒ Promise.<this>
  • .pipe(destination, [options]) ⇒ stream.Writable
  • .IndexTuple : array
  • .EntryTuple : array

new Multipart()

Create a multipart/form-data buffer container for the media(image/video) file uploading.

Example

// buffer style(Synchronous)
(new Multipart())
  .append('a', 1)
  .append('b', '2')
  .append('c', Buffer.from('31'))
  .append('d', JSON.stringify({}), 'any.json')
  .append('e', require('fs').readFileSync('/path/your/file.jpg'), 'file.jpg')
  .getBuffer();
// stream style(Asynchronous)
(new Multipart())
  .append('f', require('fs').createReadStream('/path/your/file2.jpg'), 'file2.jpg')
  .pipe(require('fs').createWriteStream('./file3.jpg'));

multipart.mimeTypes

Kind: instance property of Multipart
Access: protected
Properties

Name	Type	Description
mimeTypes	object.<string, string>	Built-in mime-type mapping

multipart.dashDash

Deprecated

Kind: instance property of Multipart
Read only: true
Properties

Name	Type	Description
dashDash	Buffer	Double dash buffer

multipart.boundary

Kind: instance property of Multipart
Read only: true
Properties

Name	Type	Description
boundary	Buffer	The boundary buffer.

multipart.EMPTY

Deprecated

Kind: instance property of Multipart
Read only: true
Properties

Name	Type	Description
EMPTY	Buffer	An empty buffer

multipart.CRLF

Deprecated

Kind: instance property of Multipart
Read only: true
Properties

Name	Type	Description
CRLF	Buffer	The CRLF characters buffer

multipart.data

Kind: instance property of Multipart
Access: protected
Properties

Name	Type	Description
data	Array.<(Buffer|ReadStream)>	The Multipart's instance data storage

multipart.indices

Kind: instance property of Multipart
Access: protected
Properties

Name	Type	Description
indices	Array.<IndexTuple.<(string|undefined), number>>	The entities' value indices whose were in data

multipart.getBuffer() ⇒ Buffer

To retrieve the Miltipart#data buffer

Kind: instance method of Multipart
Returns: Buffer - - The payload buffer

multipart.getHeaders() ⇒ object.<string, string>

To retrieve the Content-Type multipart/form-data header

Kind: instance method of Multipart
Returns: object.<string, string> - - The Content-Type header With boundary

multipart.appendMimeTypes(things) ⇒ this

Append a customized Multipart#mimeType

Kind: instance method of Multipart
Returns: this - - The Multipart class instance self

Param	Type	Description
things	object.<string, string>	The mime-type

Example

.appendMimeTypes({p12: 'application/x-pkcs12'})
.appendMimeTypes({txt: 'text/plain'})

multipart.append(name, value, [filename]) ⇒ this

Append data wrapped by boundary

Kind: instance method of Multipart
Returns: this - - The Multipart class instance self

Param	Type	Description
name	string	The field name
value	string | Buffer | ReadStream	The value
[filename]	string	Optional filename, when provided, then append the Content-Type after of the Content-Disposition

multipart.formed(name, value, [filename]) ⇒ Array.<(Buffer|ReadStream)>

Formed a named value, a filename reported to the server, when a Buffer or FileStream is passed as the second parameter.

Kind: instance method of Multipart
Returns: Array.<(Buffer|ReadStream)> - - The part of data

Param	Type	Description
name	string	The field name
value	string | Buffer | ReadStream	The value
[filename]	string	Optional filename, when provided, then append the Content-Type after of the Content-Disposition

multipart.set(name, value, [filename]) ⇒ this

Sets a new value for an existing key inside a data instance, or adds the key/value if it does not already exist.

Kind: instance method of Multipart
Returns: this - - The Multipart instance

Param	Type	Description
name	string	The field name
value	string | Buffer | ReadStream	The value
[filename]	string	Optional filename, when provided, then append the Content-Type after of the Content-Disposition

multipart.delete(name) ⇒ this

Deletes a key and its value(s) from a data instance

Kind: instance method of Multipart
Returns: this - - The Multipart instance

Param	Type	Description
name	string	The field name

multipart.get(name) ⇒ Buffer | ReadStream | undefined

Returns the first value associated with a given key from within a data instance

Kind: instance method of Multipart
Returns: Buffer | ReadStream | undefined - value - The value, undefined means none named key exists

Param	Type	Description
name	string	The field name

multipart.getAll(name) ⇒ Array.<(Buffer|ReadStream)>

Returns all values associated with a given key from within a data instance

Kind: instance method of Multipart
Returns: Array.<(Buffer|ReadStream)> - value(s) - The value(s)

Param	Type	Description
name	string	The field name

multipart.has(name) ⇒ boolean

Returns a boolean stating whether a data instance contains a certain key.

Kind: instance method of Multipart
Returns: boolean - - True for contains

Param	Type	Description
name	string	The field name

multipart.entries() ⇒ Iterator.<Array.<EntryTuple.<(string|undefined), (Buffer|ReadStream)>>>

To go through all key/value pairs contained in this data instance

Kind: instance method of Multipart
Returns: Iterator.<Array.<EntryTuple.<(string|undefined), (Buffer|ReadStream)>>> - - An Array Iterator key/value pairs.

multipart.keys() ⇒ Iterator.<(string|undefined)>

To go through all keys contained in data instance

Kind: instance method of Multipart
Returns: Iterator.<(string|undefined)> - - An Array Iterator key pairs.

multipart.values() ⇒ Iterator.<(Buffer|ReadStream)>

To go through all values contained in data instance

Kind: instance method of Multipart
Returns: Iterator.<(Buffer|ReadStream)> - - An Array Iterator value pairs.

multipart.toJSON() ⇒ object.<string, string> | null

The WeChatPay APIv3' specific, the meta JSON

Kind: instance method of Multipart
Returns: object.<string, string> | null - - The meta{filename,sha1} information.

multipart.toString() ⇒ string

Kind: instance method of Multipart
Returns: string - - FormData string

multipart.flowing([end]) ⇒ Promise.<this>

Pushing data into the readable BufferList

Kind: instance method of Multipart
Returns: Promise.<this> - - The Multipart instance

Param	Type	Default	Description
[end]	boolean	true	End the writer when the reader ends. Default: true. Available {@since v0.8.0}

multipart.pipe(destination, [options]) ⇒ stream.Writable

Attaches a Writable stream to the Multipart instance

Kind: instance method of Multipart
Returns: stream.Writable - - The destination, allowing for a chain of pipes

Param	Type	Default	Description
destination	stream.Writable		The destination for writing data
[options]	object		Pipe options
[options.end]	boolean	true	End the writer when the reader ends. Default: true.

multipart.IndexTuple : array

• two element array

Kind: instance typedef of Multipart
Access: protected
Properties

Type	Description
0	string
1	number

multipart.EntryTuple : array

• two element array

Kind: instance typedef of Multipart
Access: protected
Properties

Type	Description
0	string
1	Buffer