Struct CrossOriginOpenerPolicy 

pub struct CrossOriginOpenerPolicy {
    pub value: CrossOriginOpenerPolicyValue,
    pub report_to: Option<Cow<'static, str>>,
}

Available on crate feature http only.

Cross-Origin-Opener-Policy (COOP) header.

Send same-origin (paired with a cross-origin-isolating Cross-Origin-Embedder-Policy) to opt the document into process isolation. Required for SharedArrayBuffer and other cross-origin- isolated capabilities. The browser then internally tracks the combined policy as same-origin-plus-COEP, which is not itself a header-settable value.

The optional report-to parameter names a Reporting API endpoint (defined in the Reporting-Endpoints header) where the browser posts violation reports.

Default semantics

When the header is absent the user agent applies unsafe-none. The UnsafeNone variant represents the header being present with that explicit value — both produce the same browser behaviour but the presence is distinguishable on the wire.

Example

use rama_http_headers::{CrossOriginOpenerPolicy, CrossOriginOpenerPolicyValue};

let coop = CrossOriginOpenerPolicy {
    value: CrossOriginOpenerPolicyValue::SameOrigin,
    report_to: Some("coop-endpoint".into()),
};
assert_eq!(coop.to_string(), r#"same-origin; report-to="coop-endpoint""#);

Fields

value: CrossOriginOpenerPolicyValue

report_to: Option<Cow<'static, str>>

; report-to="<endpoint>" — endpoint name defined in the Reporting-Endpoints header. Always emitted as a quoted sf-string per RFC 8941.

Implementations

impl CrossOriginOpenerPolicy

pub fn unsafe_none() -> CrossOriginOpenerPolicy

Builder shortcut: unsafe-none, no report-to.

pub fn same_origin_allow_popups() -> CrossOriginOpenerPolicy

Builder shortcut: same-origin-allow-popups, no report-to.

pub fn same_origin() -> CrossOriginOpenerPolicy

Builder shortcut: same-origin, no report-to.

pub fn noopener_allow_popups() -> CrossOriginOpenerPolicy

Builder shortcut: noopener-allow-popups, no report-to.

pub fn with_report_to( self, endpoint: impl Into<Cow<'static, str>>, ) -> CrossOriginOpenerPolicy

pub fn set_report_to( &mut self, endpoint: impl Into<Cow<'static, str>>, ) -> &mut CrossOriginOpenerPolicy

Trait Implementations

impl Clone for CrossOriginOpenerPolicy

fn clone(&self) -> CrossOriginOpenerPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CrossOriginOpenerPolicy

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

Formats the value using the given formatter.

impl Display for CrossOriginOpenerPolicy

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

Formats the value using the given formatter.

impl Eq for CrossOriginOpenerPolicy

impl Hash for CrossOriginOpenerPolicy

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 CrossOriginOpenerPolicy

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

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

Decode this type from an iterator of HeaderValues.

impl HeaderEncode for CrossOriginOpenerPolicy

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 CrossOriginOpenerPolicy

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

impl TypedHeader for CrossOriginOpenerPolicy

fn name() -> &'static HeaderName

The name of this header.