New TypeScript library '@alsoftworks/temporize' offers Promise-aware debounce and throttle utilities

Introduction of Temporize Library

The new TypeScript library, '@alsoftworks/temporize', has been introduced to offer strongly typed timing and concurrency utilities. This library focuses on controlling the execution frequency and timing of functions, providing tools like debounce and throttle.

Core Functionality and Features

A key feature of '@alsoftworks/temporize' is that every scheduled call returns a real Promise for the wrapped function's actual result. The library has no runtime dependencies and is distributed as both ESM and CommonJS modules. It includes functionalities for debouncing, throttling, batching, retry timing, frame scheduling, and idle scheduling.

Promise-Aware Operations

The library's debounce and throttle implementations are Promise-aware. For example, multiple coalesced calls to a debounced function each receive a separate Promise that settles with the result of the single invocation. A leading-only debounce resolves suppressed calls with the leading invocation's result. Similarly, throttling coalesces excess calls and uses the latest arguments for a trailing invocation.

Specific Utilities and Browser Compatibility

Specific utilities include `debounce`, `throttle`, `rafThrottle`, and `debounceAsync`. The `rafThrottle` utility uses `requestAnimationFrame` in browsers and falls back to a 16ms `setTimeout` in SSR environments or Node.js, ensuring safe usage where animation-frame globals are not present. `debounceAsync` supports `AbortSignal` for managing asynchronous operations.