website/node_modules/get-stream/readme.md

get-stream Build Status

Get a stream as a string, buffer, or array

Install

$ npm install --save get-stream

Usage

const fs = require('fs');
const getStream = require('get-stream');
const stream = fs.createReadStream('unicorn.txt');

getStream(stream).then(str => {
    console.log(str);
    /*
                  ,,))))))));,
               __)))))))))))))),
    \|/       -\(((((''''((((((((.
    -*-==//////((''  .     `)))))),
    /|\      ))| o    ;-.    '(((((                                  ,(,
             ( `|    /  )    ;))))'                               ,_))^;(~
                |   |   |   ,))((((_     _____------~~~-.        %,;(;(>';'~
                o_);   ;    )))(((` ~---~  `::           \      %%~~)(v;(`('~
                      ;    ''''````         `:       `:::|\,__,%%    );`'; ~
                     |   _                )     /      `:|`----'     `-'
               ______/\/~    |                 /        /
             /~;;.____/;;'  /          ___--,-(   `;;;/
            / //  _;______;'------~~~~~    /;;/\    /
           //  | |                        / ;   \;;,\
          (<_  | ;                      /',/-----'  _>
           \_| ||_                     //~;~~~~~~~~~
               `\_|                   (,~~
                                       \~\
                                        ~~
    */
});

API

The methods returns a promise that resolves when the end event fires on the stream, indicating that there is no more data to be read. The stream is switched to flowing mode.

getStream(stream, [options])

Get the stream as a string.

options

encoding

Type: string Default: utf8

Encoding of the incoming stream.

maxBuffer

Type: number Default: Infinity

Maximum length of the returned string. If it exceeds this value before the stream ends, the promise will be rejected.

getStream.buffer(stream, [options])

Get the stream as a buffer.

It honors the maxBuffer option as above, but it refers to byte length rather than string length.

getStream.array(stream, [options])

Get the stream as an array of values.

It honors both the maxBuffer and encoding options. The behavior changes slightly based on the encoding chosen:

Errors

If the input stream emits an error event, the promise will be rejected with the error. The buffered data will be attached to the bufferedData property of the error.

getStream(streamThatErrorsAtTheEnd('unicorn'))
    .catch(err => {
        console.log(err.bufferedData);
        //=> 'unicorn'
    });

FAQ

How is this different from concat-stream?

This module accepts a stream instead of being one and returns a promise instead of using a callback. The API is simpler and it only supports returning a string, buffer, or array. It doesn't have a fragile type inference. You explicitly choose what you want. And it doesn't depend on the huge readable-stream package.

Related

License

MIT © Sindre Sorhus



JohnCoene/chirp documentation built on May 25, 2021, 6:33 p.m.