calculateBackoff

function calculateBackoff(
   failCount, 
   baseInterval?, 
   maxDelay?, 
   jitterFactor?): Date;

Defined in: packages/core/src/shared/utils/backoff.ts:78

Calculate the next run time using exponential backoff with jitter.

Formula: nextRunAt = now + jitter(2^failCount × baseInterval)

Jitter (±25% by default) is applied to prevent thundering-herd retries when multiple jobs fail at the same time with the same fail count.

Parameters

Parameter	Type	Default value	Description
failCount	number	undefined	Number of previous failed attempts
baseInterval	number	DEFAULT_BASE_INTERVAL	Base interval in milliseconds (default: 1000ms)
maxDelay?	number	undefined	Maximum delay in milliseconds (optional)
jitterFactor?	number	DEFAULT_JITTER_FACTOR	Jitter spread factor, 0–1 (default: 0.25 = ±25%). Set to 0 to disable.

Returns

Date

The next run date

Example

// First retry (failCount=1): ~2000ms ±25% delay
const nextRun = calculateBackoff(1);

// With no jitter (deterministic)
const nextRun = calculateBackoff(1, 1000, undefined, 0);