npm

npm’s 2019 JavaScript ecosystem survey analysis is now available!Get your copy here »

promise-duplex

4.0.2 • Public • Published

promise-duplex

Build Status Coverage Status npm

This module allows to convert Duplex stream into its promisified version, which returns Promise object fulfilled when stream's events occurred.

The module combines promise-readable and promise-writable in one.

Requirements

This module requires Node >= 6.

Installation

npm install promise-duplex

Usage

constructor

const promiseDuplex = new PromiseDuplex(stream)

PromiseDuplex object requires Duplex object to work.

Example:

const net = require('net')
const {PromiseDuplex} = require('promise-duplex')
 
const stream = new net.Socket()
 
const promiseDuplex = new PromiseDuplex(stream)

Typescript:

import net from 'net'
import PromiseDuplex from 'promise-duplex'
 
const stream = new net.Socket()
 
const promiseDuplex = new PromiseDuplex(stream)

stream

const stream = promiseDuplex.stream

Original stream object.

Example:

console.log(promiseDuplex.stream.localAddress)

read

const chunk = await promiseDuplex.read(chunkSize)

Check PromiseReadable.read for details.

readAll

const content = await promiseDuplex.readAll()

Check PromiseReadable.readAll for details.

setEncoding

promiseDuplex = await promiseDuplex.setEncoding(encoding)

Check PromiseReadable.setEncoding for details.

write

await promiseDuplex.write(chunk)

Check PromiseWritable.write for details.

writeAll

await promiseDuplex.writeAll(content, chunkSize)

Check PromiseWritable.writeAll for details.

end

await promiseDuplex.end()

Check PromiseWritable.once for details.

once

const result = await promiseDuplex.once(event)

Check PromiseReadable.once and PromiseWritable.once for details.

destroy

promiseDuplex.destroy()

This method calls destroy method on stream and cleans up all own handlers.

See also

PromiseReadable, PromiseWritable, PromiseSocket, PromisePiping.

License

Copyright (c) 2017-2019 Piotr Roszatycki piotr.roszatycki@gmail.com

MIT

install

npm i promise-duplex

Downloadsweekly downloads

178

version

4.0.2

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability