Struct gloo_net::http::Request

pub struct Request { /* private fields */ }

This is supported on crate feature http only.

A wrapper round web_sys::Request: an http request to be used with the fetch API.

Implementations

impl Request

pub fn new(url: &str) -> Self

Creates a new request that will be sent to url.

Uses GET by default. url can be a String, a &str, or a Cow<'a, str>.

pub fn body(self, body: impl Into<JsValue>) -> Self

Set the body for this request.

pub fn cache(self, cache: RequestCache) -> Self

A string indicating how the request will interact with the browser’s HTTP cache.

pub fn credentials(self, credentials: RequestCredentials) -> Self

Controls what browsers do with credentials (cookies, HTTP authentication entries, and TLS client certificates).

pub fn headers(self, headers: Headers) -> Self

Replace all the headers.

pub fn header(self, key: &str, value: &str) -> Self

Sets a header.

pub fn integrity(self, integrity: &str) -> Self

The subresource integrity value of the request (e.g., sha256-BpfBw7ivV8q2jLiT13fxDYAe2tJllusRSZ273h2nFSE=).

pub fn method(self, method: Method) -> Self

The request method, e.g., GET, POST.

Note that the Origin header is not set on Fetch requests with a method of HEAD or GET.

pub fn mode(self, mode: RequestMode) -> Self

The mode you want to use for the request.

pub fn observe(self, observe: &ObserverCallback) -> Self

Sets the observer callback.

pub fn redirect(self, redirect: RequestRedirect) -> Self

How to handle a redirect response:

• follow: Automatically follow redirects. Unless otherwise stated the redirect mode is set to follow
• error: Abort with an error if a redirect occurs.
• manual: Caller intends to process the response in another context. See WHATWG fetch standard for more information.

pub fn referrer(self, referrer: &str) -> Self

The referrer of the request.

This can be a same-origin URL, about:client, or an empty string.

pub fn referrer_policy(self, referrer_policy: ReferrerPolicy) -> Self

Specifies the referrer policy to use for the request.

pub fn abort_signal(self, signal: Option<&AbortSignal>) -> Self

Sets the request abort signal.

pub async fn send(self) -> Result<Response, Error>

Executes the request.

pub fn get(url: &str) -> Self

Creates a new GET Request with url.

pub fn post(url: &str) -> Self

Creates a new POST Request with url.

pub fn put(url: &str) -> Self

Creates a new PUT Request with url.

pub fn delete(url: &str) -> Self

Creates a new DELETE Request with url.

pub fn patch(url: &str) -> Self

Creates a new PATCH Request with url.

Trait Implementations

impl Debug for Request

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

Formats the value using the given formatter.