Read a growing file continuously as a Stream.
Want to see pretty graphs? Log in now!
npm install tailing-stream
|11||downloads in the last week|
|36||downloads in the last month|
|Last Published By|
|Version||0.0.4 last updated a year ago|
|Keywords||grow, growing, file, tail, tailing, stream, streaming, watch|
tailing-stream is a Node.js module that provides a Stream that can read
continuously from a file that's being actively written to. This is in contrast
to the standard
method, which returns a
ReadableStream that stops reading once it gets to the
last byte that existed at the time the stream was originally opened. It supports
exactly the same interface as a Node
createReadStream method functions the same as
TailingReadableStream supports all the same methods and configuration
options as a normal
ReadableStream, so I suggest you read
the node documentation if you're
looking for a detailed description. The only difference is that a
TailingReadableStream doesn't recognize the
end option, since it wouldn't
make much sense to create one if you planned to stop reading at a predetermined
It takes one unique configuration option,
timeout. This specifies the amount
of time in milliseconds that should elapse before a file is considered to have
'finished' tailing. If omitted, it defaults to 5000ms. If set to a falsy value,
the timeout is disabled and the stream will wait indefinitely for new content to
arrive. Beware: if the timeout is set too low (say, to 1ms), the stream could
very well close files that are still being written to if 'data' events don't
come in quickly enough.
If a timeout occurs, an
end event is sent to replicate the file closing.
TailingReadableStream uses the
method to watch for file changes, and creates
ReadableStreams to read the
changed contents. If
fs.watch performs peculiarly on your platform of choice,
its foibles will be replicated in
tailing-stream is MIT licensed, so throw caution to the wind and have at it!