timer-stopwatch

A stopwatch and countdown timer for node

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
timer-stopwatch
44100.2.08 years ago10 years agoMinified + gzip package size for timer-stopwatch in KB

Readme

timer-stopwatch Codeship Status for MickCrozier/timer-stopwatch
A stopwatch and countdown clock module for node.js
Install
npm install timer-stopwatch
How to
The Gist new Stopwatch(countDownMS, options)
Basic timers
var Stopwatch = require('timer-stopwatch');

var timer = new Stopwatch(60000); // A new countdown timer with 60 seconds
var stopwatch = new Stopwatch(); // A new count up stopwatch. Starts at 0.

Event Methods

// Fires every 50ms by default. Change setting the 'refreshRateMS' options
timer.onTime(function(time) {
	console.log(time.ms); // number of milliseconds past (or remaining);
});

// Fires when the timer is done
timer.onDone(function(){
	console.log('Timer is complete');
});

// Fires when the timer is almost complete - default is 10 seconds remaining. Change with 'almostDoneMS' option
timer.onAlmostdone(function() {
	console.log('Timer is almost complete');
});

//These methods are chainable
timer.onTime(cb).onAlmostdone(cb).onDone(cb);

Timer Methods

timer.start();
timer.stop();
timer.startstop();        // Toggles the running state
timer.reset(countDownMS); // optional countDownMS to reset countdown to that many milliseconds

Properties

timer.ms;		// Number of milliseconds on the clock

Options

var options = {
	refreshRateMS: 10,		// How often the clock should be updated
	almostDoneMS: 10000, 	// When counting down - this event will fire with this many milliseconds remaining on the clock
}

var timer = new Stopwatch(60000, options);
Breaking Changes in v0.2
  • The 'forcestop' event is being depreciated in favour of 'stop'.
  • Use the onTime, onAlmostDone, onDone and onStop methods in favour of .on('eventname').
Testing
Unit and Integration tests (requires dev dependencies)
npm test
License
MIT License