Struct worker::Request

pub struct Request { /* private fields */ }

A Request representation for handling incoming and creating outbound HTTP requests.

Implementations

impl Request

pub fn new(uri: &str, method: Method) -> Result<Self>

Construct a new Request with an HTTP Method.

pub fn new_with_init(uri: &str, init: &RequestInit) -> Result<Self>

Construct a new Request with a RequestInit configuration.

pub async fn json<B: DeserializeOwned>(&mut self) -> Result<B>

Access this request’s body encoded as JSON.

pub async fn text(&mut self) -> Result<String>

Access this request’s body as plaintext.

pub async fn bytes(&mut self) -> Result<Vec<u8>>

Access this request’s body as raw bytes.

pub async fn form_data(&mut self) -> Result<FormData>

Access this request’s body as a form-encoded payload and pull out fields and files.

pub fn stream(&mut self) -> Result<ByteStream>

Access this request’s body as a Stream of bytes.

pub fn headers(&self) -> &Headers

Get the Headers for this request.

pub fn headers_mut(&mut self) -> Result<&mut Headers>

Get a mutable reference to this request’s Headers. Note: they can only be modified if the request was created from scratch or cloned.

pub fn cf(&self) -> Option<&Cf>

Access this request’s Cloudflare-specific properties.

Note

Request objects constructed by the user and not the runtime will not have a Cf associated.

See workerd#825

pub fn method(&self) -> Method

The HTTP Method associated with this Request.

pub fn path(&self) -> String

The URL Path of this Request.

pub fn path_mut(&mut self) -> Result<&mut String>

Get a mutable reference to this request’s path. Note: they can only be modified if the request was created from scratch or cloned.

pub fn url(&self) -> Result<Url>

The parsed url::Url of this Request.

pub fn query<Q: DeserializeOwned>(&self) -> Result<Q>

Deserialize the url query

pub fn clone(&self) -> Result<Self>

pub fn clone_mut(&self) -> Result<Self>

pub fn inner(&self) -> &Request

Trait Implementations

impl Debug for Request

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

Formats the value using the given formatter.

impl<'a> From<&'a Request> for CacheKey<'a>

fn from(request: &'a Request) -> Self

Converts to this type from the input type.

impl From<Request> for Request

fn from(req: Request) -> Self

Converts to this type from the input type.

impl TryFrom<&Request> for Request

type Error = Error

The type returned in the event of a conversion error.

fn try_from(req: &Request) -> Result<Self>

Performs the conversion.

impl<B: Body<Data = Bytes> + 'static> TryFrom<Request<B>> for Request

type Error = Error

The type returned in the event of a conversion error.

fn try_from(req: Request<B>) -> Result<Self>

Performs the conversion.

impl TryFrom<Request> for Request

type Error = Error

The type returned in the event of a conversion error.

fn try_from(req: Request) -> Result<Self>

Performs the conversion.

impl TryFrom<Request> for HttpRequest

type Error = Error

The type returned in the event of a conversion error.

fn try_from(req: Request) -> Result<Self>

Performs the conversion.

impl Send for Request

impl Sync for Request