set-timeout-worker
A dedicated web-worker for the setTimeout method.
Client only. No server required.
Why?
When the current tab loses focus the browser throttles its timeouts and they become inaccurate when setting short timeout periods. This behavior is inconsistent between different browsers and the subject is not well documented.
Using a web-worker for setting timeouts eliminates this issue.
Install
$ npm install set-timeout-worker
or
$ yarn add set-timeout-worker
Usage
// import:
import { setTimeoutWorker } from 'set-timeout-worker';
// or require:
const { setTimeoutWorker } = require('set-timeout-worker');
// initialize
setTimeoutWorker.start();
const timeoutRef = setTimeoutWorker.setTimeout(() => {
// do somthing
}, 3000)
setTimeoutWorker.clearTimeout(timeoutRef);
// terminate
setTimeoutWorker.stop();
setTimeoutWorker
A singleton instance. It has the following methods:
.start().setTimeout(callback, ms).clearTimeout(timeoutRef).stop().onError(errorHandler)
.start()
Initializes a worker. Must be called in order to set timeouts.
.setTimeout(callback, ms)
.setTimeout(callback, ms[, arg1, arg2, ..., argN])
TL;DR - Same as
window.setTimeout().
Sets a timeout in the worker scope. Returns a timeout reference (number) that can be used for clearing the timeout. Accepts a callback to run after the given delay in milliseconds. Extra arguments will be passed to the callback by the same order.
Calling setTimeout before initializing a worker will throw an error. See .start() above.
setTimeoutWorker.setTimeout((a, b, c) => {
console.log(a, b, c); // 1 2 3
}, 1000, 1, 2, 3);
.clearTimeout()
TL;DR - Same as
window.clearTimeout().
Cancles an active timeout. Accept a timeout reference (returned by setTimeout).
const timeoutRef = setTimeoutWorker.setTimeout(callback, 1000);
setTimeoutWorker.clearTimeout(timeoutRef);
.stop()
Terminates the worker, clearing any active timeouts. Will not set any new timeouts until .start() is called again.
.onError(errorHandler)
Sets an error handler function to catch the worker's exceptions. The function will get called with an Error
setTimeoutWorker.onError((err) => {
console.error(err);
});
/*
Error: SetTimeoutWorker
Uncaught Error: Something Happend!
Worker: blob:null/ce72fad0-bd41-46f7-9bea-fd405ab117c5
Line: 7
Col: 15
Timestamp: 72.00000001466833
at Worker._worker.onerror (set-timeout-worker.js:58)
*/You can see the worker's code by opening the blob in a new browser tab.