it-reader

it-reader

Read an exact number of bytes from a binary (async) iterable

Table of contents

• Install
  • Browser <script> tag
• Usage
• API
  • reader(source)
    • Parameters
    • Returns
• Contribute
• API Docs
• License
• Contribution

Install

$ npm i it-reader

Browser <script> tag

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

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

Usage

import { reader } from 'it-reader'

const stream = reader(source) // source is any iterable or async iterable
const { value, done } = await stream.next(8)

// NOTE: value is a BufferList (https://npm.im/bl)
console.log(value.toString())

// Now read 16 more bytes:
await stream.next(16)

// or...
// Consume the rest of the stream

for await (const chunk of stream) {
  console.log(chunk.toString())
}

API

import { reader } from 'it-reader'

reader(source)

Create and return a new reader.

Parameters

• source (Iterable) - An iterable or async iterable that yields Buffer or BufferList objects.

Returns

An async iterator that yields BufferList objects.

The iterator's next method takes an optional parameter - the number of bytes to read from the source.

If the number of bytes to read are not specified, the iterator will yield any bytes remaining in the internal buffer or the next available chunk.

If the number of bytes to read exceeds the number of bytes available in the source the iterator will throw and error with a code property set to 'ERR_UNDER_READ' and a buffer property (the bytes read so far, if any), which is a BufferList instance.

Contribute

Feel free to dive in! Open an issue or submit PRs.

API Docs

• https://alanshaw.github.io/it-reader

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.

Changelog

6.0.4 (2023-04-19)

Dependencies

• dev: bump aegir from 37.12.1 to 38.1.8 (#55) (07b6b6f)