Struct Cors

pub struct Cors { /* private fields */ }

It defines CORS instance.

Implementations

impl Cors

pub fn new() -> Self

Creates a new Cors instance.

pub fn allow_methods<I>(self, methods: I) -> Self

where I: IntoIterator, Method: TryFrom<I::Item>,

Adds multiple methods to the existing list of allowed request methods.

Panics

Panics if the provided argument is not a valid http::Method.

pub fn allow_any_origin(self) -> Self

Sets that any Origin header is allowed.

Warning

This can allow websites you didn’t intend to access this resource, it is usually better to set an explicit list.

pub fn allow_origins<I>(self, origins: I) -> Self

where I: IntoIterator, I::Item: IntoOrigin,

Add multiple origins to the existing list of allowed Origins.

Panics

Panics if the provided argument is not a valid Origin.

pub fn allow_headers<I>(self, headers: I) -> Self

where I: IntoIterator, HeaderName: TryFrom<I::Item>,

Adds multiple headers to the list of allowed request headers.

Note: These should match the values the browser sends via Access-Control-Request-Headers, e.g.content-type.

Panics

Panics if any of the headers are not a valid http::header::HeaderName.

pub fn expose_headers<I>(self, headers: I) -> Self

where I: IntoIterator, HeaderName: TryFrom<I::Item>,

Adds multiple headers to the list of exposed request headers.

Note: These should match the values the browser sends via Access-Control-Request-Headers, e.g.content-type.

Panics

Panics if any of the headers are not a valid http::header::HeaderName.

pub fn build(cors: Option<Cors>) -> Option<Configured>

Builds the Cors wrapper from the configured settings.

Trait Implementations

impl Clone for Cors

fn clone(&self) -> Cors

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Cors

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

Formats the value using the given formatter.

impl Default for Cors

fn default() -> Self

Returns the “default value” for a type.