lib/_stream_duplex.js

   1 // Copyright Joyent, Inc. and other Node contributors.
   2 //
   3 // Permission is hereby granted, free of charge, to any person obtaining a
   4 // copy of this software and associated documentation files (the
   5 // "Software"), to deal in the Software without restriction, including
   6 // without limitation the rights to use, copy, modify, merge, publish,
   7 // distribute, sublicense, and/or sell copies of the Software, and to permit
   8 // persons to whom the Software is furnished to do so, subject to the
   9 // following conditions:
  10 //
  11 // The above copyright notice and this permission notice shall be included
  12 // in all copies or substantial portions of the Software.
  13 //
  14 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  15 // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  16 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
  17 // NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
  18 // DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
  19 // OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
  20 // USE OR OTHER DEALINGS IN THE SOFTWARE.
  21
  22 // a duplex stream is just a stream that is both readable and writable.
  23 // Since JS doesn't have multiple prototypal inheritance, this class
  24 // prototypally inherits from Readable, and then parasitically from
  25 // Writable.
  26
  27 'use strict';
  28
  29 module.exports = Duplex;
  30 var util = require('util');
  31 var Readable = require('_stream_readable');
  32 var Writable = require('_stream_writable');
  33
  34 util.inherits(Duplex, Readable);
  35
  36 var keys = Object.keys(Writable.prototype);
  37 for (var v = 0; v < keys.length; v++) {
  38   var method = keys[v];
  39   if (!Duplex.prototype[method])
  40     Duplex.prototype[method] = Writable.prototype[method];
  41 }
  42
  43 function Duplex(options) {
  44   if (!(this instanceof Duplex))
  45     return new Duplex(options);
  46
  47   Readable.call(this, options);
  48   Writable.call(this, options);
  49
  50   if (options && options.readable === false)
  51     this.readable = false;
  52
  53   if (options && options.writable === false)
  54     this.writable = false;
  55
  56   this.allowHalfOpen = true;
  57   if (options && options.allowHalfOpen === false)
  58     this.allowHalfOpen = false;
  59
  60   this.once('end', onend);
  61 }
  62
  63 // the no-half-open enforcer
  64 function onend() {
  65   // if we allow half-open state, or if the writable side ended,
  66   // then we're ok.
  67   if (this.allowHalfOpen || this._writableState.ended)
  68     return;
  69
  70   // no more data can be written.
  71   // But allow more writes to happen in this tick.
  72   process.nextTick(this.end.bind(this));
  73 }