Readable file stream.
Variables
path:FsPath
The path to the file the stream is reading from as specified in the first argument to Fs.createReadStream.
If path is passed as a string, then readStream.path will be a string. If path is passed as a Buffer, then readStream.path will be a Buffer.
Inherited Variables
Defined by Readable
read onlyisTTY:Bool
Terminal read streams (i.e. process.stdin) have this property set to true. It is false for any other read streams.
See also:
read onlyreadableEncoding:Null<String>
Getter for the property encoding of a given Readable stream.
The encoding property can be set using the readable.setEncoding() method.
See also:
read onlyreadableHighWaterMark:Int
read onlyreadableLength:Int
This property contains the number of bytes (or objects) in the queue ready to be read.
The value provides introspection data regarding the status of the highWaterMark.
See also:
read onlyreadableObjectMode:Bool
Inherited Methods
Defined by Readable
destroy(?error:Error):TSelf
Destroy the stream. Optionally emit an 'error' event, and emit a 'close' event unless emitClose is set in false.
After this call, the readable stream will release any internal resources and subsequent calls to push() will be ignored.
Implementors should not override this method, but instead implement readable._destroy().
See also:
isPaused():Bool
The readable.isPaused() method returns the current operating state of the Readable.
This is used primarily by the mechanism that underlies the readable.pipe() method.
In most typical cases, there will be no reason to use this method directly.
See also:
pause():TSelf
The readable.pause() method will cause a stream in flowing mode to stop emitting 'data' events,
switching out of flowing mode. Any data that becomes available will remain in the internal buffer.
See also:
pipe<T>(destination:T, ?options:{end:Null<Bool>}):T
The readable.pipe() method attaches a Writable stream to the readable,
causing it to switch automatically into flowing mode and push all of its data to the attached Writable.
The flow of data will be automatically managed so that the destination Writable stream
is not overwhelmed by a faster Readable stream.
See also:
read(?size:Int):Null<Dynamic>
The readable.read() method pulls some data out of the internal buffer and returns it.
If no data available to be read, null is returned. By default,
the data will be returned as a Buffer object unless an encoding has been specified using
the readable.setEncoding() method or the stream is operating in object mode.
See also:
resume():TSelf
The readable.resume() method causes an explicitly paused Readable stream to resume emitting 'data' events,
switching the stream into flowing mode.
See also:
setEncoding(encoding:String):TSelf
The readable.setEncoding() method sets the character encoding for data read from the Readable stream.
See also:
unpipe(?destination:IWritable):TSelf
The readable.unpipe() method detaches a Writable stream previously attached using the stream.pipe() method.
See also:
unshift(chunk:Null<Dynamic>, ?encoding:String):Void
Passing chunk as null signals the end of the stream (EOF), after which no more data can be written.
See also:
Defined by EventEmitter
addListener<T>(eventName:Event<T>, listener:T):TSelf
Alias for emitter.on(eventName, listener).
See also:
emit<T>(eventName:Event<T>, args:Rest<Dynamic>):Bool
Synchronously calls each of the listeners registered for the event named
eventName, in the order they were registered, passing the supplied arguments
to each.
See also:
eventNames():Array<EitherType<String, Symbol>>
Returns an array listing the events for which the emitter has registered
listeners. The values in the array will be strings or Symbols.
See also:
getMaxListeners():Int
Returns the current max listener value for the EventEmitter which is either
set by emitter.setMaxListeners(n) or defaults to
EventEmitter.defaultMaxListeners.
See also:
listenerCount<T>(eventName:Event<T>):Int
Returns the number of listeners listening to the event named eventName.
See also:
listeners<T>(eventName:Event<T>):Array<T>
Returns a copy of the array of listeners for the event named eventName.
See also:
on<T>(eventName:Event<T>, listener:T):TSelf
Adds the listener function to the end of the listeners array for the
event named eventName. No checks are made to see if the listener has
already been added. Multiple calls passing the same combination of eventName
and listener will result in the listener being added, and called, multiple
times.
See also:
once<T>(eventName:Event<T>, listener:T):TSelf
Adds a one-time listener function for the event named eventName. The
next time eventName is triggered, this listener is removed and then invoked.
See also:
prependListener<T>(eventName:Event<T>, listener:T):TSelf
Adds the listener function to the beginning of the listeners array for the
event named eventName. No checks are made to see if the listener has
already been added. Multiple calls passing the same combination of eventName
and listener will result in the listener being added, and called, multiple
times.
See also:
prependOnceListener<T>(eventName:Event<T>, listener:T):TSelf
Adds a one-time listener function for the event named eventName to the
beginning of the listeners array. The next time eventName is triggered, this
listener is removed, and then invoked.
See also:
rawListeners<T>(eventName:Event<T>):Array<T>
Returns a copy of the array of listeners for the event named eventName,
including any wrappers (such as those created by .once()).
See also:
removeAllListeners<T>(?eventName:Event<T>):TSelf
Removes all listeners, or those of the specified eventName.
See also:
removeListener<T>(eventName:Event<T>, listener:T):TSelf
Removes the specified listener from the listener array for the event named
eventName.
See also:
setMaxListeners(n:Int):Void
By default EventEmitters will print a warning if more than 10 listeners are
added for a particular event. This is a useful default that helps finding
memory leaks. Obviously, not all events should be limited to just 10 listeners.
The emitter.setMaxListeners() method allows the limit to be modified for this
specific EventEmitter instance. The value can be set to Infinity (or 0)
to indicate an unlimited number of listeners.
See also: