Struct CookieJar 

pub struct CookieJar {
    pub cookies: Vec<Cookie>,
}

A jar for collecting and managing cookies across requests and responses.

Fields

cookies: Vec<Cookie>

Implementations

impl CookieJar

pub fn new() -> Self

Create an empty cookie jar.

pub fn insert(&mut self, cookie: Cookie)

Add or replace a cookie in the jar (keyed by name only, for backward compat).

pub fn get(&self, name: &str) -> Option<&Cookie>

Get a cookie by name (first match).

pub fn remove(&mut self, name: &str) -> Option<Cookie>

Remove a cookie by name. Returns the removed cookie if it existed.

pub fn iter(&self) -> impl Iterator<Item = &Cookie>

Iterate over all cookies.

pub fn len(&self) -> usize

The number of cookies in the jar.

pub fn is_empty(&self) -> bool

Returns true if the jar is empty.

pub fn to_cookie_header(&self) -> String

Build a Cookie header value from all cookies in the jar.

pub fn add_from_set_cookie_headers<'a, I: IntoIterator<Item = &'a str>>( &mut self, headers: I, )

Parse cookies from multiple Set-Cookie header values and add them to the jar.

pub fn insert_for_url(&mut self, cookie: Cookie, request_url: &Uri)

Insert a cookie with URL context for default domain/path assignment and expiry computation.

pub fn cookies_for_url(&self, url: &Uri) -> Vec<&Cookie>

Returns cookies matching the given URL per RFC 6265 §5.4. Filters by domain-match, path-match, secure, and expiry. Result is sorted by path length descending.

pub fn to_cookie_header_for_url(&self, url: &Uri) -> Option<String>

Build a Cookie header value for the given URL, or None if no cookies match.

pub fn add_from_response_headers(&mut self, headers: &HeaderMap, url: &Uri)

Parse all Set-Cookie headers from an http::HeaderMap and insert them with URL context for default domain/path and expiry computation.

Trait Implementations

impl Clone for CookieJar

fn clone(&self) -> CookieJar

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CookieJar

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

Formats the value using the given formatter.

impl Default for CookieJar

fn default() -> CookieJar

Returns the “default value” for a type.