node-minipass/minipass-collect
zhouganqing dca77e4a71 Import Upstream version 3.1.6+~cs8.7.18 2023-02-15 11:05:41 +08:00
..
LICENSE Import Upstream version 3.1.6+~cs8.7.18 2023-02-15 11:05:41 +08:00
README.md Import Upstream version 3.1.6+~cs8.7.18 2023-02-15 11:05:41 +08:00
index.js Import Upstream version 3.1.6+~cs8.7.18 2023-02-15 11:05:41 +08:00
package.json Import Upstream version 3.1.6+~cs8.7.18 2023-02-15 11:05:41 +08:00

README.md

minipass-collect

A Minipass stream that collects all the data into a single chunk

Note that this buffers ALL data written to it, so it's only good for situations where you are sure the entire stream fits in memory.

Note: this is primarily useful for the Collect.PassThrough class, since Minipass streams already have a .collect() method which returns a promise that resolves to the array of chunks, and a .concat() method that returns the data concatenated into a single Buffer or String.

USAGE

const Collect = require('minipass-collect')

const collector = new Collect()
collector.on('data', allTheData => {
  console.log('all the data!', allTheData)
})

someSourceOfData.pipe(collector)

// note that you can also simply do:
someSourceOfData.pipe(new Minipass()).concat().then(data => ...)
// or even, if someSourceOfData is a Minipass:
someSourceOfData.concat().then(data => ...)
// but you might prefer to have it stream-shaped rather than
// Promise-shaped in some scenarios.

If you want to collect the data, but also act as a passthrough stream, then use Collect.PassThrough instead (for example to memoize streaming responses), and listen on the collect event.

const Collect = require('minipass-collect')

const collector = new Collect.PassThrough()
collector.on('collect', allTheData => {
  console.log('all the data!', allTheData)
})

someSourceOfData.pipe(collector).pipe(someOtherStream)

All minipass options are supported.