time-queues

time-queues is an efficient, lightweight library for organizing asynchronous multitasking and scheduled tasks in JavaScript applications. It works seamlessly in browsers and server-side environments like Node.js, Deno, and Bun.

The library provides elegant solutions for common timing and scheduling challenges, helping developers create responsive, efficient applications that follow best practices for resource management and user experience.

Key Features

• Efficient Task Scheduling: Schedule tasks to run at specific times or after delays
• Browser Performance Optimization: Execute tasks during idle periods or animation frames
• Page Lifecycle Management: Respond intelligently to page visibility and focus changes
• Resource Management: Control execution rates with throttling and debouncing
• Minimal Dependencies: Relies only on list-toolkit, a zero-dependency library

Installation

npm install time-queues

If you want to check out the source code, you can use the following command:

git clone --recurse-submodules https://github.com/uhop/time-queues.git
cd time-queues
npm install

Usage

The full documentation is available in the project's wiki. Below is a summary of the most important parts of the documentation:

Resource Management

• Scheduler: Time-based task scheduling
• Retainer: Manage resource lifecycle
• Throttler: Control execution rate based on keys

Browser-Specific Components

• IdleQueue: Execute tasks during browser idle periods
• FrameQueue: Execute tasks during animation frames
• PageWatcher: Monitor and respond to page lifecycle changes

Utility Functions

• defer(): Execute tasks in the next tick
• sleep(): Promise-based delay function
• throttle(): Limit function execution rate
• debounce(): Delay function execution until input stabilizes
• sample(): Execute function at regular intervals
• audit(): Execute function after specified delay

License

This project is licensed under the BSD-3-Clause License.

Release History

• 1.1.2 Updated dev dependencies. No need to upgrade.
• 1.1.1 Updates to TS typings.
• 1.1.0 Added Throttler, Retainer, promise-based convenience time methods.
• 1.0.5 Technical release: updated deps, more tests.
• 1.0.4 Bug fixes and code simplifications.
• 1.0.3 Updated deps (list-toolkit) to fix a minor bug.
• 1.0.2 Updated deps (list-toolkit).
• 1.0.1 Minor update in README. No need to upgrade.
• 1.0.0 Initial release.