async/retry_policy_utils library

Retry policy (fixed, backoff, jitter) — roadmap #656.

Constants

retryPolicyDefaultBackoffBase → const Duration

Default base delay for exponential backoff in retryWithJitter. Audited: 2026-06-12 11:26 EDT

retryPolicyDefaultBackoffJitter → const Duration

Default jitter range for retryWithJitter. Audited: 2026-06-12 11:26 EDT

retryPolicyDefaultDelay → const Duration

Default delay between retry attempts. Audited: 2026-06-12 11:26 EDT

Functions

retryWithJitter<T>(Future<T> fn(), {int maxAttempts = 3, Duration base = retryPolicyDefaultBackoffBase, Duration jitter = retryPolicyDefaultBackoffJitter, Random? random}) → Future<T>

Exponential backoff with jitter: delay = base * 2^attempt + random(0, jitter). Audited: 2026-06-12 11:26 EDT

retryWithPolicy<T>(Future<T> fn(), {int maxAttempts = 3, Duration delay = retryPolicyDefaultDelay, bool retryIf(Object error)?, void onRetry(Object error, int attempt)?}) → Future<T>

Retries fn up to maxAttempts with delay between attempts.