Function surf::trace[−][src]

pub fn trace(uri: impl AsRef<str>) -> RequestBuilderⓘNotable traits for RequestBuilder
impl Future for RequestBuilder    type Output = Result<Response>;

Expand description

Perform a one-off TRACE request.

About the HTTP Method

The HTTP TRACE method performs a message loop-back test along the path to the target resource, providing a useful debugging mechanism.

The final recipient of the request should reflect the message received, excluding some fields described below, back to the client as the message body of a 200 (OK) response with a Content-Type of message/http. The final recipient is either the origin server or the first server to receive a Max-Forwards value of 0 in the request.

Panics

This will panic if a malformed URL is passed.

Errors

Returns errors from the middleware, http backend, and network sockets.

Examples

let string = surf::trace("https://httpbin.org/trace").recv_string().await?;