116 lines
2.6 KiB
Markdown
116 lines
2.6 KiB
Markdown
|
# duplexer3 [](https://travis-ci.org/floatdrop/duplexer3) [](https://coveralls.io/github/floatdrop/duplexer3?branch=master)
|
||
|
|
|
||
|
|
Like [duplexer2](https://github.com/deoxxa/duplexer2) but using Streams3 without readable-stream dependency
|
||
|
|
|
||
|
|
```javascript
|
||
|
|
var stream = require("stream");
|
||
|
|
|
||
|
|
var duplexer3 = require("duplexer3");
|
||
|
|
|
||
|
|
var writable = new stream.Writable({objectMode: true}),
|
||
|
|
readable = new stream.Readable({objectMode: true});
|
||
|
|
|
||
|
|
writable._write = function _write(input, encoding, done) {
|
||
|
|
if (readable.push(input)) {
|
||
|
|
return done();
|
||
|
|
} else {
|
||
|
|
readable.once("drain", done);
|
||
|
|
}
|
||
|
|
};
|
||
|
|
|
||
|
|
readable._read = function _read(n) {
|
||
|
|
// no-op
|
||
|
|
};
|
||
|
|
|
||
|
|
// simulate the readable thing closing after a bit
|
||
|
|
writable.once("finish", function() {
|
||
|
|
setTimeout(function() {
|
||
|
|
readable.push(null);
|
||
|
|
}, 500);
|
||
|
|
});
|
||
|
|
|
||
|
|
var duplex = duplexer3(writable, readable);
|
||
|
|
|
||
|
|
duplex.on("data", function(e) {
|
||
|
|
console.log("got data", JSON.stringify(e));
|
||
|
|
});
|
||
|
|
|
||
|
|
duplex.on("finish", function() {
|
||
|
|
console.log("got finish event");
|
||
|
|
});
|
||
|
|
|
||
|
|
duplex.on("end", function() {
|
||
|
|
console.log("got end event");
|
||
|
|
});
|
||
|
|
|
||
|
|
duplex.write("oh, hi there", function() {
|
||
|
|
console.log("finished writing");
|
||
|
|
});
|
||
|
|
|
||
|
|
duplex.end(function() {
|
||
|
|
console.log("finished ending");
|
||
|
|
});
|
||
|
|
```
|
||
|
|
|
||
|
|
```
|
||
|
|
got data "oh, hi there"
|
||
|
|
finished writing
|
||
|
|
got finish event
|
||
|
|
finished ending
|
||
|
|
got end event
|
||
|
|
```
|
||
|
|
|
||
|
|
## Overview
|
||
|
|
|
||
|
|
This is a reimplementation of [duplexer](https://www.npmjs.com/package/duplexer) using the
|
||
|
|
Streams3 API which is standard in Node as of v4. Everything largely
|
||
|
|
works the same.
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
## Installation
|
||
|
|
|
||
|
|
[Available via `npm`](https://docs.npmjs.com/cli/install):
|
||
|
|
|
||
|
|
```
|
||
|
|
$ npm i duplexer3
|
||
|
|
```
|
||
|
|
|
||
|
|
## API
|
||
|
|
|
||
|
|
### duplexer3
|
||
|
|
|
||
|
|
Creates a new `DuplexWrapper` object, which is the actual class that implements
|
||
|
|
most of the fun stuff. All that fun stuff is hidden. DON'T LOOK.
|
||
|
|
|
||
|
|
```javascript
|
||
|
|
duplexer3([options], writable, readable)
|
||
|
|
```
|
||
|
|
|
||
|
|
```javascript
|
||
|
|
const duplex = duplexer3(new stream.Writable(), new stream.Readable());
|
||
|
|
```
|
||
|
|
|
||
|
|
Arguments
|
||
|
|
|
||
|
|
* __options__ - an object specifying the regular `stream.Duplex` options, as
|
||
|
|
well as the properties described below.
|
||
|
|
* __writable__ - a writable stream
|
||
|
|
* __readable__ - a readable stream
|
||
|
|
|
||
|
|
Options
|
||
|
|
|
||
|
|
* __bubbleErrors__ - a boolean value that specifies whether to bubble errors
|
||
|
|
from the underlying readable/writable streams. Default is `true`.
|
||
|
|
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
3-clause BSD. [A copy](./LICENSE) is included with the source.
|
||
|
|
|
||
|
|
## Contact
|
||
|
|
|
||
|
|
* GitHub ([deoxxa](http://github.com/deoxxa))
|
||
|
|
* Twitter ([@deoxxa](http://twitter.com/deoxxa))
|
||
|
|
* Email ([deoxxa@fknsrs.biz](mailto:deoxxa@fknsrs.biz))
|