https://github.com/chrisguttandin/audio-context-timers
A replacement for setInterval() and setTimeout() which works in unfocused windows.
https://github.com/chrisguttandin/audio-context-timers
clearinterval cleartimeout interval setinterval settimeout web-audio window-timers
Last synced: 5 months ago
JSON representation
A replacement for setInterval() and setTimeout() which works in unfocused windows.
- Host: GitHub
- URL: https://github.com/chrisguttandin/audio-context-timers
- Owner: chrisguttandin
- License: mit
- Created: 2016-11-22T00:01:42.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-04-27T20:15:08.000Z (about 1 year ago)
- Last Synced: 2024-05-01T23:22:14.480Z (about 1 year ago)
- Topics: clearinterval, cleartimeout, interval, setinterval, settimeout, web-audio, window-timers
- Language: JavaScript
- Size: 13.6 MB
- Stars: 15
- Watchers: 3
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# audio-context-timers
**A replacement for setInterval() and setTimeout() which works in unfocused windows.**
[](https://www.npmjs.com/package/audio-context-timers)
## Motivation
For scripts that rely on [WindowTimers](http://www.w3.org/TR/html5/webappapis.html#timers) like setInterval() or setTimeout() things get confusing when the site which the script is running on loses focus. Chrome, Firefox and maybe others throttle the frequency at which they invoke those timers to a maximum of once per second in such a situation. However it is possible to schedule [AudioBufferSourceNodes](https://webaudio.github.io/web-audio-api/#AudioBufferSourceNode) and listen for their [`onended`](https://webaudio.github.io/web-audio-api/#widl-AudioScheduledSourceNode-onended) event to achieve a similar result. This makes it possible to avoid the throttling.
## Getting Started
`audio-context-timers` is available as a package on [npm](https://www.npmjs.org/package/audio-context-timers). Run the following command to install it:
```shell
npm install audio-context-timers
```
You can then import the exported functions in your code like this:
```js
import { clearInterval, clearTimeout, setInterval, setTimeout } from 'audio-context-timers';
```
The usage is exactly the same as with the corresponding functions on the global scope.
```js
var intervalId = setInterval(() => {
// do something many times
}, 100);
clearInterval(intervalId);
var timeoutId = setTimeout(() => {
// do something once
}, 100);
clearTimeout(timeoutId);
```
However there are some subtle differences between `audio-context-timers` and WindowTimers which are the same those of the [`worker-timers`](https://github.com/chrisguttandin/worker-timers) package.