|
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354 |
- # end-of-stream
-
- A node module that calls a callback when a readable/writable/duplex stream has completed or failed.
-
- npm install end-of-stream
-
- [![Build status](https://travis-ci.org/mafintosh/end-of-stream.svg?branch=master)](https://travis-ci.org/mafintosh/end-of-stream)
-
- ## Usage
-
- Simply pass a stream and a callback to the `eos`.
- Both legacy streams, streams2 and stream3 are supported.
-
- ``` js
- var eos = require('end-of-stream');
-
- eos(readableStream, function(err) {
- // this will be set to the stream instance
- if (err) return console.log('stream had an error or closed early');
- console.log('stream has ended', this === readableStream);
- });
-
- eos(writableStream, function(err) {
- if (err) return console.log('stream had an error or closed early');
- console.log('stream has finished', this === writableStream);
- });
-
- eos(duplexStream, function(err) {
- if (err) return console.log('stream had an error or closed early');
- console.log('stream has ended and finished', this === duplexStream);
- });
-
- eos(duplexStream, {readable:false}, function(err) {
- if (err) return console.log('stream had an error or closed early');
- console.log('stream has finished but might still be readable');
- });
-
- eos(duplexStream, {writable:false}, function(err) {
- if (err) return console.log('stream had an error or closed early');
- console.log('stream has ended but might still be writable');
- });
-
- eos(readableStream, {error:false}, function(err) {
- // do not treat emit('error', err) as a end-of-stream
- });
- ```
-
- ## License
-
- MIT
-
- ## Related
-
- `end-of-stream` is part of the [mississippi stream utility collection](https://github.com/maxogden/mississippi) which includes more useful stream modules similar to this one.
|