it-batched-bytes

Takes an async iterator that emits byte arrays and emits them as fixed size batches

About

The final batch may be smaller than the max.

Example

import batch from 'it-batched-bytes'
import all from 'it-all'

// This can also be an iterator, generator, etc
const values = [
  Uint8Array.from([0]),
  Uint8Array.from([1]),
  Uint8Array.from([2]),
  Uint8Array.from([3]),
  Uint8Array.from([4])
]
const batchSize = 2

const result = all(batch(values, { size: batchSize }))

console.info(result) // [0, 1], [2, 3], [4]

Async sources must be awaited:

import batch from 'it-batched-bytes'
import all from 'it-all'

const values = async function * () {
  yield Uint8Array.from([0])
  yield Uint8Array.from([1])
  yield Uint8Array.from([2])
  yield Uint8Array.from([3])
  yield Uint8Array.from([4])
}
const batchSize = 2

const result = await all(batch(values, { size: batchSize }))

console.info(result) // [0, 1], [2, 3], [4]

Install

$ npm i it-batched-bytes

Browser `<script>` tag

Loading this module through a script tag will make it's exports available as ItBatchedBytes in the global namespace.

<script src="https://unpkg.com/it-batched-bytes/dist/index.min.js"></script>

API Docs

https://achingbrain.github.io/it/modules/it_batched_bytes.html

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.

Current Tags

2.0.7 ... latest (7 months ago)