Skip to main content

BackoffOptions

@rotorsoft/act-root

@rotorsoft/act-root / act/src / BackoffOptions

Type Alias: BackoffOptions

BackoffOptions = object

Defined in: libs/act/src/types/reaction.ts:195

Per-reaction retry backoff configuration. When set, the drain controller defers the next attempt at this stream until the computed delay has elapsed.

Backoff state lives in process memory on the DrainController. With N competing workers (each running its own controller), retries escalate at most N× faster than configured — the shared retry counter on the stream watermark climbs across workers, reaching the blockOnError threshold sooner. This is intentional: per-worker pacing speeds up recovery on transient per-worker faults, and poison messages still get quarantined.

Properties​

baseMs​

readonly baseMs: number

Defined in: libs/act/src/types/reaction.ts:197

Base delay (must be ≥ 0)

jitter?​

readonly optional jitter?: boolean

Defined in: libs/act/src/types/reaction.ts:199

Multiply final delay by 0.5 + random() (range [0.5, 1.5)) to avoid thundering herds when many streams retry in lockstep

maxMs?​

readonly optional maxMs?: number

Defined in: libs/act/src/types/reaction.ts:198

Optional cap; only used by exponential

strategy​

readonly strategy: BackoffStrategy

Defined in: libs/act/src/types/reaction.ts:196

BackoffStrategy