3.0.8 • Published 13 days ago
it-buffer-stream v3.0.8
it-buffer-stream
An async iterator that emits buffers containing bytes up to a certain length
About
Generate a stream of buffers, useful for testing purposes.
Example
import bufferStream from 'it-buffer-stream'
const totalLength = //... a big number
// all options are optional, defaults are shown
const options = {
chunkSize: 4096, // how many bytes will be in each buffer
collector: (buffer) => {
// will be called as each buffer is generated. the final buffer
// may be smaller than `chunkSize`
},
generator: async (size) => {
// return a promise that resolves to a buffer of length `size`
//
// if omitted, `Promise.resolve(crypto.randomBytes(size))` will be used
}
}
let buffers = []
for await (buf of bufferStream(totalLength, options)) {
buffers.push(buf)
}
// `buffers` is an array of Buffers the combined length of which === totalLength
Install
$ npm i it-buffer-stream
Browser <script>
tag
Loading this module through a script tag will make it's exports available as ItBufferStream
in the global namespace.
<script src="https://unpkg.com/it-buffer-stream/dist/index.min.js"></script>
API Docs
License
Licensed under either of
- Apache 2.0, (LICENSE-APACHE / http://www.apache.org/licenses/LICENSE-2.0)
- MIT (LICENSE-MIT / http://opensource.org/licenses/MIT)
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
3.0.8
13 days ago
3.0.7
14 days ago
3.0.6
5 months ago
3.0.5
6 months ago
3.0.4
9 months ago
3.0.3
1 year ago
3.0.2
1 year ago
3.0.1
1 year ago
3.0.0
2 years ago
2.0.2
3 years ago
2.0.1
3 years ago
2.0.0
3 years ago
1.0.7
3 years ago
1.0.6
3 years ago
1.0.5
4 years ago
1.0.4
4 years ago
1.0.3
4 years ago
1.0.2
4 years ago
1.0.1
4 years ago
1.0.0
4 years ago