Struct CrossOriginOpenerPolicy 

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

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() -> Self

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

pub fn same_origin_allow_popups() -> Self

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

pub fn same_origin() -> Self

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

pub fn noopener_allow_popups() -> Self

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

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

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

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

Formats the value using the given formatter.

impl Display for CrossOriginOpenerPolicy

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

Formats the value using the given formatter.

impl Eq for CrossOriginOpenerPolicy

impl Hash for CrossOriginOpenerPolicy

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

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: Iterator<Item = &'i HeaderValue>>( values: &mut I, ) -> Result<Self, Error>

Decode this type from an iterator of HeaderValues.

impl HeaderEncode for CrossOriginOpenerPolicy

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

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.