async-iterable-stream v4.0.0

async-iterable-stream

A readable stream which can be iterated over using a for-await-of loop or using a while loop with await inside.

The AsyncIterableStream constructor is an abstract class which must be subclassed. Its next() and createAsyncIterator() methods must be overriden.

For a concrete subclass of AsyncIterableStream, see WritableAsyncIterableStream: https://github.com/SocketCluster/writable-async-iterable-stream

Installation

npm install async-iterable-stream

Usage

The AsyncIterableStream class exposes the following methods:

• [Symbol.asyncIterator]: Makes the instance iterable using a for-await-of loop.
• next: Returns a Promise which will resolve an object in the form {value: data, done: boolean} whenever some data is received or when the stream ends.
• once: Similar to next() except that the resolved value will be the raw data and it will not resolve when the stream ends. Note that once once() is called, it cannot be cancelled; the affected closure will stay in memory until either once() resolves or until the stream is ended or garbage collected.

// Consume data objects from asyncIterableStream as they are written to the stream.
(async () => {
  for await (let data of asyncIterableStream) {
    console.log(data);
  }
})();

// Consume only the next data object which is written to the stream.
(async () => {
  let data = await asyncIterableStream.once();
  console.log(data);
})();