Home

time-queues

Lightweight library for asynchronous task scheduling and concurrency control in JavaScript. Works in browsers, Node.js, Deno, and Bun.

For installation, quick start, and browser notes see the README. For copy-pasteable examples see examples.

Component Reference

Queues

• Scheduler — time-based task scheduling (delays, dates, repeats)
• IdleQueue — run tasks during browser idle periods
• FrameQueue — run tasks in animation frames
• LimitedQueue — concurrency-controlled async queue
• PageWatcher — react to page lifecycle changes

Utility Functions

• sleep() — promise-based delay
• defer() — execute on next tick
• throttle() — rate-limit a function (first call wins)
• debounce() — delay until input stabilizes
• sample() — sample at regular intervals
• audit() — collect then execute after delay
• batch() — run async ops with concurrency limit

Supporting Classes

• Throttler — key-based rate limiting
• Retainer — resource lifecycle management
• Counter — track pending task counts
• CancelTaskError — cancellation error class

Base Classes

• MicroTask — base task unit
• MicroTaskQueue — abstract queue base class
• ListQueue — linked-list queue implementation

Random Utilities

• random-dist — random numbers (uniform, normal, exponential, Pareto)
• random-sleep — randomized delays from various distributions

Page Load Helpers

• whenDomLoaded() — run code when DOM is ready
• whenLoaded() — run code when page is fully loaded

For Contributors & AI Agents

• AGENTS.md — project conventions for contributors and AI coding assistants
• llms.txt — machine-readable project summary
• llms-full.txt — full API reference for LLMs