Struct Builder

pub struct Builder { /* private fields */ }

Available on crate feature h3 only.

HTTP/3 client builder

Set the configuration for a new client.

Examples

let h3_conn = h3::client::builder()
    .max_field_section_size(8192)
    .build(quic)
    .await
    .expect("Failed to build connection");

Implementations

impl Builder

pub fn max_field_section_size(&mut self, value: u64) -> &mut Builder

Set the maximum header size this client is willing to accept

See header size constraints section of the specification for details.

pub fn send_grease(&mut self, enabled: bool) -> &mut Builder

Just like in HTTP/2, HTTP/3 also uses the concept of “grease” to prevent potential interoperability issues in the future. In HTTP/3, the concept of grease is used to ensure that the protocol can evolve and accommodate future changes without breaking existing implementations.

pub fn enable_datagram(&mut self, enabled: bool) -> &mut Builder

Indicates that the client supports HTTP/3 datagrams

See: https://www.rfc-editor.org/rfc/rfc9297#section-2.1.1

pub fn enable_extended_connect(&mut self, value: bool) -> &mut Builder

Enables the extended CONNECT protocol required for various HTTP/3 extensions.

pub async fn build<C, O, B>( &mut self, quic: C, ) -> Result<(Connection<C, B>, SendRequest<O, B>), ConnectionError>

where C: Connection<B, OpenStreams = O>, O: OpenStreams<B>, B: Buf,

Create a new HTTP/3 client from a quic connection