Struct NameKeyedJar 

pub struct NameKeyedJar { /* private fields */ }

Thread-safe, name-keyed cookie store. set_cookies parses each Set-Cookie value and stores (name → value) ignoring everything after the first ; (attributes like Path, HttpOnly, Secure).

Implementations

impl NameKeyedJar

pub fn new() -> Self

Create an empty jar.

pub fn set_pairs<I, S>(&self, pairs: I)

where I: IntoIterator<Item = S>, S: AsRef<str>,

Insert raw name=value pairs, ignoring any cookie attributes. Pairs with the same name replace previous values.

pub fn clear(&self)

Drop every entry. Useful when the upstream signals a session reset.

pub fn len(&self) -> usize

Return the number of entries currently held — handy for diagnostics.

pub fn is_empty(&self) -> bool

Return true if the jar currently holds no entries.

pub fn snapshot(&self) -> Vec<(String, String)>

Snapshot of the current (name, value) pairs, sorted by name for stable diagnostic output.

Trait Implementations

impl CookieStore for NameKeyedJar

fn set_cookies( &self, cookie_headers: &mut dyn Iterator<Item = &HeaderValue>, _url: &Url, )

Store a set of Set-Cookie header values received from url

fn cookies(&self, _url: &Url) -> Option<HeaderValue>

Get any Cookie values in the store for url

impl Debug for NameKeyedJar

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

Print the cookie names and the entry count, never the values. Cookie values frequently carry secrets (JSESSIONID, OAuth tokens) and a derived Debug would leak them through every tracing::debug!(?jar) call site.

impl Default for NameKeyedJar

fn default() -> NameKeyedJar

Returns the “default value” for a type.