Skip to content

Latest commit

 

History

History
41 lines (26 loc) · 886 Bytes

README.md

File metadata and controls

41 lines (26 loc) · 886 Bytes

Async Read Line

This library provides a convenient way to read line-wise from streams.

Installation

yarn add async-line-reader
# or
npm i async-line-reader

Usage and Examples

Read line-wise from a stream:

const reader = new AsyncLineReader(stream)

let line: string | null

// Read each line until the stream ends.
for((line = await reader.readLine() !== null) {
  // ... do something with line.
}

Custom separator or encoding:

const reader = new AsyncLineReader(stream, ';', 'ascii')

const line = await reader.readLine()

For more detailed examples, please look into the examples and test folders.

Why should I use this?

This module is for your convienence if you want to read a stream line by line in a JS application that utilizes async/await. I did not see another library that proided a similar, convenient interface.