Function surf::trace

Important traits for Request<C>

impl<C: HttpClient> Future for Request<C> type Output = Result<Response, Exception>;

pub fn trace(uri: impl AsRef<str>) -> Request<NativeClient>

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.

Read more on MDN

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?;