Struct Cookie 

pub struct Cookie {
    pub name: String,
    pub value: String,
    pub domain: Option<String>,
    pub path: Option<String>,
    pub max_age: Option<Duration>,
    pub secure: bool,
    pub http_only: bool,
    pub same_site: Option<SameSite>,
    pub expires_at: Option<Instant>,
}

Represents a single HTTP cookie.

Fields

name: String

value: String

domain: Option<String>

path: Option<String>

max_age: Option<Duration>

Max-Age attribute stored as a Duration.

secure: bool

http_only: bool

same_site: Option<SameSite>

expires_at: Option<Instant>

Computed absolute expiry time from max_age, set at insertion.

Implementations

impl Cookie

pub fn new(name: impl Into<String>, value: impl Into<String>) -> Self

Create a new cookie with the given name and value.

pub fn name(&self) -> &str

The cookie name.

pub fn value(&self) -> &str

The cookie value.

pub fn domain(&self) -> Option<&str>

The domain attribute.

pub fn path(&self) -> Option<&str>

The path attribute.

pub fn max_age(&self) -> Option<Duration>

The max-age attribute as a Duration.

pub fn is_secure(&self) -> bool

Whether the Secure flag is set.

pub fn is_http_only(&self) -> bool

Whether the HttpOnly flag is set.

pub fn same_site(&self) -> Option<SameSite>

The SameSite attribute.

pub fn set_domain(self, domain: impl Into<String>) -> Self

Set the domain attribute.

pub fn set_path(self, path: impl Into<String>) -> Self

Set the path attribute.

pub fn set_max_age(self, seconds: u64) -> Self

Set the max-age attribute in seconds.

pub fn set_secure(self, secure: bool) -> Self

Set the Secure flag.

pub fn set_http_only(self, http_only: bool) -> Self

Set the HttpOnly flag.

pub fn set_same_site(self, same_site: SameSite) -> Self

Set the SameSite attribute.

pub fn parse_set_cookie(header: &str) -> Option<Self>

Parse a cookie from a Set-Cookie header value (RFC 6265). expires_at is left as None here; it is computed at insertion time by CookieJar.

pub fn to_cookie_header(&self) -> String

Serialize the cookie for use in a Cookie request header.

Trait Implementations

impl Clone for Cookie

fn clone(&self) -> Cookie

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Cookie

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

Formats the value using the given formatter.

impl Display for Cookie

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

Formats the value using the given formatter.

impl Eq for Cookie

impl PartialEq for Cookie

fn eq(&self, other: &Cookie) -> 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 StructuralPartialEq for Cookie