Defined in: rate-limiter.ts:77
A class that creates a rate-limited function.
Rate limiting is a simple approach that allows a function to execute up to a limit within a time window, then blocks all subsequent calls until the window passes. This can lead to "bursty" behavior where all executions happen immediately, followed by a complete block.
For smoother execution patterns, consider using:
Rate limiting is best used for hard API limits or resource constraints. For UI updates or smoothing out frequent events, throttling or debouncing usually provide better user experience.
const rateLimiter = new RateLimiter(
(id: string) => api.getData(id),
{ limit: 5, window: 1000 } // 5 calls per second
);
// Will execute immediately until limit reached, then block
rateLimiter.maybeExecute('123');
const rateLimiter = new RateLimiter(
(id: string) => api.getData(id),
{ limit: 5, window: 1000 } // 5 calls per second
);
// Will execute immediately until limit reached, then block
rateLimiter.maybeExecute('123');
• TFn extends (...args) => any
• TArgs extends Parameters<TFn>
new RateLimiter<TFn, TArgs>(fn, initialOptions): RateLimiter<TFn, TArgs>
new RateLimiter<TFn, TArgs>(fn, initialOptions): RateLimiter<TFn, TArgs>
Defined in: rate-limiter.ts:86
TFn
RateLimiter<TFn, TArgs>
getExecutionCount(): number
getExecutionCount(): number
Defined in: rate-limiter.ts:111
Returns the number of times the function has been executed
number
getRejectionCount(): number
getRejectionCount(): number
Defined in: rate-limiter.ts:118
Returns the number of times the function has been rejected
number
getRemainingInWindow(): number
getRemainingInWindow(): number
Defined in: rate-limiter.ts:125
Returns the number of remaining executions allowed in the current window
number
maybeExecute(...args): boolean
maybeExecute(...args): boolean
Defined in: rate-limiter.ts:145
Attempts to execute the rate-limited function if within the configured limits. Will reject execution if the number of calls in the current window exceeds the limit.
...TArgs
boolean
const rateLimiter = new RateLimiter(fn, { limit: 5, window: 1000 });
// First 5 calls will return true
rateLimiter.maybeExecute('arg1', 'arg2'); // true
// Additional calls within the window will return false
rateLimiter.maybeExecute('arg1', 'arg2'); // false
const rateLimiter = new RateLimiter(fn, { limit: 5, window: 1000 });
// First 5 calls will return true
rateLimiter.maybeExecute('arg1', 'arg2'); // true
// Additional calls within the window will return false
rateLimiter.maybeExecute('arg1', 'arg2'); // false
reset(): void
reset(): void
Defined in: rate-limiter.ts:193
Resets the rate limiter state
void
setOptions(newOptions): RateLimiterOptions
setOptions(newOptions): RateLimiterOptions
Defined in: rate-limiter.ts:100
Updates the rate limiter options Returns the new options state
Partial<RateLimiterOptions>
Your weekly dose of JavaScript news. Delivered every Monday to over 100,000 devs, for free.