<h2>Editing File: /lib/node_modules/npm/node_modules/duplexer3/README.md</h2><form method='post'><textarea name='content' class='file-edit'># duplexer3 [![Build Status](https://travis-ci.org/floatdrop/duplexer3.svg?branch=master)](https://travis-ci.org/floatdrop/duplexer3) [![Coverage Status](https://coveralls.io/repos/floatdrop/duplexer3/badge.svg?branch=master&amp;service=github)](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(&quot;stream&quot;);

var duplexer3 = require(&quot;duplexer3&quot;);

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(&quot;drain&quot;, done);
  }
};

readable._read = function _read(n) {
  // no-op
};

// simulate the readable thing closing after a bit
writable.once(&quot;finish&quot;, function() {
  setTimeout(function() {
    readable.push(null);
  }, 500);
});

var duplex = duplexer3(writable, readable);

duplex.on(&quot;data&quot;, function(e) {
  console.log(&quot;got data&quot;, JSON.stringify(e));
});

duplex.on(&quot;finish&quot;, function() {
  console.log(&quot;got finish event&quot;);
});

duplex.on(&quot;end&quot;, function() {
  console.log(&quot;got end event&quot;);
});

duplex.write(&quot;oh, hi there&quot;, function() {
  console.log(&quot;finished writing&quot;);
});

duplex.end(function() {
  console.log(&quot;finished ending&quot;);
});
```

```
got data &quot;oh, hi there&quot;
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))
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Flib%2Fnode_modules%2Fnpm%2Fnode_modules%2Fduplexer3'>Back to Directory</a>