pub fn connect(uri: impl AsRef<str>) -> RequestBuilder ⓘExpand description
Perform a one-off CONNECT request.
§About the HTTP Method
The HTTP CONNECT method method starts two-way communications with the requested resource. It can be used to open a tunnel.
For example, the CONNECT method can be used to access websites that use SSL (HTTPS). The client asks an HTTP Proxy server to tunnel the TCP connection to the desired destination. The server then proceeds to make the connection on behalf of the client. Once the connection has been established by the server, the Proxy server continues to proxy the TCP stream to and from the client.
CONNECT is a hop-by-hop method.
§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::connect("https://httpbin.org/connect").recv_string().await?;