fs.createReadStream that supports ongoing tailing of files

Downloads in past


1.1.06 years ago6 years agoMinified + gzip package size for fs-tail-stream in KB


fs.createReadStream that supports ongoing tailing of files
build status
The built in fs.createReadStream function stops streaming once the file has come to an end.
If you want to tail the file so that it keeps streaming data when the file grows then you're out of luck.
This module adds a { tail: true } option to the options which will keep streaming data as data is added to the file, or until the .close() method is called on the read stream.
Because this module wraps the underlying fs.createReadStream function all the options work as expected.


This module is installed via npm:
$ npm install fs-tail-stream

Example Usage

var fst = require('fs-tail-stream');
var fs = require('fs');
var ws = fs.createWriteStream(tmpFile, { flags: 'a' });

// file with the text 'hello' in it
var tmpFile = '/tmp/my-temp-file.txt';

// same parameters as `fs.createReadStream`, but pass through `tail: true`
fst.createReadStream(tmpFile, { encoding: 'utf8', start: 80, tail: true })
  .on('sync', function () {
    // called when at the end of the file
    var self = this;
    // write some new data to the file
    ws.write('world', 'utf8', function (err) {
      // stop watching for files, and let the file stream end
      // otherwise the file watching will be indefinite and the process
      // won't' exit
  // will print out both the existing contents of the file, plus the
  // newly added data
  .on('data', console.log);
  // prints out:
  //   hello
  //   world