websocket_connect_async


Description:

public async WebsocketConnection websocket_connect_async (Message msg, string? origin, string[]? protocols, int io_priority, Cancellable? cancellable) throws Error

Asynchronously creates a [class@WebsocketConnection] to communicate with a remote server.

All necessary WebSocket-related headers will be added to msg, and it will then be sent and asynchronously processed normally ( including handling of redirection and HTTP authentication).

If the server returns "101 Switching Protocols", then msg's status code and response headers will be updated, and then the WebSocket handshake will be completed. On success, [method@Session.websocket_connect_finish] will return a new [class@WebsocketConnection]. On failure it will return a Error.

If the server returns a status other than "101 Switching Protocols", then msg will contain the complete response headers and body from the server's response, and [method@Session.websocket_connect_finish] will return soup_websocket_error_not_websocket.

Parameters:

this

a Session

msg

Message indicating the WebSocket server to connect to

origin

origin of the connection

protocols

a null-terminated array of protocols supported

io_priority

the I/O priority of the request

cancellable

a Cancellable

callback

the callback to invoke

user_data

data for callback