lil-stopwatch

A lightweight lil stopwatch ⏱

Zero-dependency stopwatch using timestamps. This does not implement intervals or "ticking", the utility simply provides the elapsed time when you need it. The rest is up to you.

Docs ↗

<div id="stopwatch">00:00:00</div>

import Stopwatch from 'lil-stopwatch';

const stopwatch = new Stopwatch();

const container = document.getElementById('stopwatch');
container.onclick = () => stopwatch.toggle();

setInterval(() => {
  container.innerText = stopwatch.display;
}, 50);

API

const stopwatch = new Stopwatch({ ...options });

name | description --- | --- constructor options | {startImmediately: boolean (default false),displayHours: boolean (default false),displaySeparator: string (default ':')displayMsPrecision: 1-3 (default 2)} play() | start the timer stop() | stop/pause the timer toggle() | toggle between stop and play reset() | clear the current state and stop the timer state | {hours, minutes, seconds, milliseconds} display | string - '00:00:00' isRunning | bool - specifies if the stopwatch is currently running isPaused | bool - specifies if the stopwatch is paused or stopped totalMilliseconds | float - total elapsed milliseconds totalSeconds | float - total elapsed seconds totalMinutes | float - total elapsed minutes totalHours | float - total elapsed hours