Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Nodejs module for tailing a file
CoffeeScript JavaScript Ruby
branch: master


To install:

npm install tail


Tail = require('tail').Tail;

tail = new Tail("fileToTail");

tail.on("line", function(data) {

tail.on("error", function(error) {
  console.log('ERROR: ', error);

Tail constructor accepts few parameters:

var fileToTail = "/path/to/fileToTail.txt";
var lineSeparator= "\n";
var fromBeginning = false;
var watchOptions = {}; \\ as per node documentations

new Tail(fileToTail, lineSeparator, watchOptions,fromBeginning)
  • fileToTail is the name (inclusive of the path) of the file to tail
  • lineSeparator is the line separator token (default "\n")
  • watchOptions is the full set of options that can be passed to as per node documentation (default: {})
  • fromBeginning force the tail of the file from the very beginning of it instead of from the first new line that will be appended(default: "\n")

The only mandatory one is the first, i.e. the the file you want to tail.

Tail emits two type of events:

  • line
  • error

If you simply want to stop the tail:


And to start watching again:

Want to fork ?

Tail is written in CoffeeScript.

The Cakefile generates the javascript that is then published to npm.


MIT. Please see License file for more details.

Something went wrong with that request. Please try again.