@mvaliolahi/time-tracker
v1.0.3
Published
Simple time tracker for use on the web
Readme
TimeTracker
TimeTracker is a JavaScript library designed to track time durations, specifically for managing session durations in web applications. It provides functionalities to start, pause, and resume session tracking, as well as reading the current session duration.
Features
- Start Session: Begin tracking session duration.
- Pause Session: Pause session tracking.
- Resume Session: Resume session tracking after pausing.
- Read Session Duration: Get the current session duration in milliseconds and formatted string.
Installation
npm install @mvaliolahi/time-trackerStart tracking
This code starts a tracker for the home key, and every 1 second the callback will be run with a data object containing format and milliseconds keys.
Also, the start method returns intervalId to allow stopping the updates if needed.
Note: the second argument can change interval timeout, it's proper to make the callback for sending data in long periods to the server.
Also, you can watch the pause and resume state change by passing a callback as a third argument.
TimeTracker.start("home", (data) => {
console.log(data.format, data.milliseconds)
});Pause tracking
TimeTracker.pause('sessionKey');Resume tracking
TimeTracker.resume('sessionKey');Read tracking data
const data = TimeTracker.read("about")
console.log(data.format)