Enum JitterPolicy 

pub enum JitterPolicy {
    None,
    Full,
    Equal,
    Decorrelated,
}

Policy controlling randomization of retry delays.

Prevents synchronized retries across multiple tasks by adding controlled randomness.

Trade-offs

• None: Predictable, but risks thundering herd
• Full: Maximum randomness, aggressive load spreading
• Equal: Balanced (recommended for most use cases)
• Decorrelated: Stateful, prevents retry correlation (requires previous delay)

Variants

None

No jitter: use exact backoff delay.

Use when:

• Only one task retrying (no herd risk)
• Predictable timing required
• Testing/debugging

Full

Full jitter: random delay in [0, backoff_delay].

Most aggressive jitter, can significantly reduce delay. Use when maximum load spreading is needed.

Equal

Equal jitter: delay/2 + random[0, delay/2].

Balances predictability with randomness (recommended default). Preserves ~75% of the original backoff on average.

Decorrelated

Decorrelated jitter: delay = random[base, prev_delay * 3], capped at max.

More sophisticated, considers the previous delay and grows independently. Requires context via apply_decorrelated.

Implementations

impl JitterPolicy

pub fn apply(&self, delay: Duration) -> Duration

Applies jitter to the given delay.

Note

For Decorrelated, this method returns the input unchanged. Use apply_decorrelated instead, as it requires additional context (previous delay, base, max).

pub fn apply_decorrelated( &self, base: Duration, prev: Duration, max: Duration, ) -> Duration

Applies decorrelated jitter with full context.

• base: minimal delay (usually the initial backoff)
• prev: previous actual delay
• max: maximum cap

Note

If called on a non-Decorrelated policy, falls back to apply(base).

Trait Implementations

impl Clone for JitterPolicy

fn clone(&self) -> JitterPolicy

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for JitterPolicy

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for JitterPolicy

fn default() -> Self

Returns JitterPolicy::None as default (backwards compatible).

impl PartialEq for JitterPolicy

fn eq(&self, other: &JitterPolicy) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for JitterPolicy

impl Eq for JitterPolicy

impl StructuralPartialEq for JitterPolicy