Struct IdleTimeout 

pub struct IdleTimeout {
    pub first_request: Duration,
    pub idle: Duration,
}

Available on crate features http-backend and http and std only.

Budget for a connection without open requests before it is closed.

A connection is idle while it has no open request, no request head in progress and no tunnel; a WebSocket, a CONNECT tunnel or a streamed response keeps its request open, even while no bytes are transferred. HTTP/2 PINGs and other connection-level control traffic do not restart this HTTP idle budget. Transport timeouts (including QUIC’s idle timeout) apply independently.

A connection that never received a complete request head gets one first_request window, counted from when it first went idle: requests and heads in progress pause it but never restart it. Once a complete head arrived, the connection earns the full idle budget whenever it becomes idle again. This allows a client to reuse the connection between requests, including through an HTTP interception proxy.

HTTP/1 closes the connection; HTTP/2 and HTTP/3 send a graceful GOAWAY and close once requests that raced it are done.

Fields

first_request: Duration

Window for a connection that has not received a complete request head yet.

Extended by four round trips, at most doubled, when the connection measured its round-trip time.

idle: Duration

Budget while idle after at least one complete request head was received.

Starts when no request, response, tunnel or request head remains open, rather than when the last byte was transferred. Defaults to 90 seconds. Increase this for clients with longer gaps between requests using, for example, IdleTimeout { idle: Duration::from_secs(300), ..IdleTimeout::DEFAULT }.

Implementations

impl IdleTimeout

pub const DEFAULT: IdleTimeout

10 s before the first request and 90 s idle after receiving a request head.

The shorter initial window limits unused connections. The longer window allows reuse across minute-spaced requests, reducing reconnects and TLS handshakes for clients and HTTP interception proxies.

Trait Implementations

impl Clone for IdleTimeout

fn clone(&self) -> IdleTimeout

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for IdleTimeout

impl Debug for IdleTimeout

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

Formats the value using the given formatter.

impl Default for IdleTimeout

fn default() -> IdleTimeout

Returns the “default value” for a type.

impl Eq for IdleTimeout

impl PartialEq for IdleTimeout

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for IdleTimeout