Initiate a WebSocket connection to a remote host.
Calling connect will block the VU finalization until the WebSocket connection is closed. Instead of continuously looping the main function (export default function() { ... }) over an over, each VU will be halted listening to async events and executing their event handlers until the connection is closed.
The following events can close the connection:
- remote host close event.
- Socket.close().
- k6 VU interruption based on test configuration or CLI commands.
Parameter | Type | Description |
---|---|---|
url | string | Request URL (e.g. "ws://echo.websocket.org"). |
params | object | Params object containing additional request parameters. |
callback | function | The callback function that will be called when the WebSocket connection is initiated. A Socket object will be passed to the function, and this object can be used to set up callbacks etc when things happen on the WebSocket connection |
Returns
Type | Description |
---|---|
Response | HTTP Response object. |