IoT.js-API-Stream.md

Class: Stream.Readable

Readable stream is abstraction for data for read, so you can read data out from a readable stream.

At any time a readable stream is in one of two state: flowing and paused. In paused state, readable stream emits 'readable' event for you that indicates there are data ready for read. and then you can explicitly call stream.read() to get the data form the stream. In flowing state, readable stream emits 'data' event with actual data that you can receive data as fast as possible. All streams start out in paused mode.

Events

'readable'

Readable stream emits this event when a chunk of data prepared to be read. This event only emitted when the stream is in paused state.

'data'

• chunk: Buffer | String

Readable stream emits this event when a chunk of data prepared to be read. This event only emitted when the stream is in flowing state.

Attaching a data event listener to a stream makes the stream to be switched to flowing mode.

'end'

This event is only fired when there will be no more data to read.

'close'

Emitted when the underlying resource has been closed.

Methods

readable.read([size])

readable.resume()

readable.pause()

readable.isPaused()

Class: stream.Writable

Writable stream is abstraction for target that you can write data to.

Events

'drain'

If writable.write() returns false, drain events will indicate you that the stream is ready to be written.

'finish'

After writable.end() has been called, and all data bas been flushed, this event will be fired.

'error'

• err: Error

Emitted if there were something wrong writing data.

Methods

writable.write(chunk[, callback])

• chunk: String | Buffer - The data to write
• callback: Function() - Function callback for when the chunk of data is flushed.
• Returns: Boolean

This method writes chunk of data to the underlying system, when the data is flush it calls back the callback function. If you can write right after calling this method, it will return true, otherwise, return false.

writable.end([chunk][, callback])

• chunk: String | Buffer - The data to write
• callback: Function() - Function callback for when the chunk of data is flushed.