Enum CrossOriginResourcePolicy 

pub enum CrossOriginResourcePolicy {
    SameSite,
    SameOrigin,
    CrossOrigin,
    Unknown(String),
}

Available on crate feature http only.

Cross-Origin-Resource-Policy (CORP) header, defined by Fetch § cross-origin-resource-policy-header.

Lets a server opt resources out of being embedded by cross- origin / cross-site documents. Single token, no parameters, no report-only variant.

Default semantics

When the header is absent the user agent applies its default embedding policy (effectively cross-origin for legacy backwards compatibility). The typed value here represents the header being present. The auto-generated Unknown variant is reachable only if a caller constructs it directly — the HeaderDecode impl uses strict parsing and rejects any unknown token.

Example values

• same-origin
• same-site
• cross-origin

Example

use rama_http_headers::CrossOriginResourcePolicy;

let corp = CrossOriginResourcePolicy::SameOrigin;
assert_eq!(corp.to_string(), "same-origin");

Variants

SameSite

same-site — only documents from the same registrable site may embed the resource.

SameOrigin

same-origin — only same-origin documents may embed.

CrossOrigin

cross-origin — any document may embed. Matches the legacy default but makes the intent explicit on the wire.

Unknown(String)

Implementations

impl CrossOriginResourcePolicy

pub fn as_str(&self) -> &str

pub fn as_smol_str(&self) -> SmolStr

impl CrossOriginResourcePolicy

pub fn strict_parse(s: &str) -> Option<CrossOriginResourcePolicy>

Same as FromStr or From<&str> but returning None for unknown values

Trait Implementations

impl Clone for CrossOriginResourcePolicy

fn clone(&self) -> CrossOriginResourcePolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CrossOriginResourcePolicy

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CrossOriginResourcePolicy

fn deserialize<D>( deserializer: D, ) -> Result<CrossOriginResourcePolicy, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for CrossOriginResourcePolicy

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

Formats the value using the given formatter.

impl Eq for CrossOriginResourcePolicy

impl<'a> From<&'a str> for CrossOriginResourcePolicy

fn from(s: &'a str) -> CrossOriginResourcePolicy

Converts to this type from the input type.

impl From<String> for CrossOriginResourcePolicy

fn from(s: String) -> CrossOriginResourcePolicy

Converts to this type from the input type.

impl FromStr for CrossOriginResourcePolicy

type Err = Infallible

The associated error which can be returned from parsing.

fn from_str( s: &str, ) -> Result<CrossOriginResourcePolicy, <CrossOriginResourcePolicy as FromStr>::Err>

Parses a string s to return a value of this type.

impl Hash for CrossOriginResourcePolicy

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl HeaderDecode for CrossOriginResourcePolicy

fn decode<'i, I>(values: &mut I) -> Result<CrossOriginResourcePolicy, Error>

where I: Iterator<Item = &'i HeaderValue>,

Decode this type from an iterator of HeaderValues.

impl HeaderEncode for CrossOriginResourcePolicy

fn encode<E>(&self, values: &mut E)

where E: Extend<HeaderValue>,

Encode this type to a HeaderValue, and add it to a container which has HeaderValue type as each element.

fn encode_to_value(&self) -> Option<HeaderValue>

Encode this header to HeaderValue.

impl PartialEq for CrossOriginResourcePolicy

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

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for CrossOriginResourcePolicy

impl TypedHeader for CrossOriginResourcePolicy

fn name() -> &'static HeaderName

The name of this header.