WebSocket QML Type

QML interface to QWebSocket. More...

Import Statement: import QtWebSockets 1.8

Properties

Signals

Methods

Detailed Description

WebSockets is a web technology providing full-duplex communications channels over a single TCP connection. The WebSocket protocol was standardized by the IETF as RFC 6455 in 2011.

Property Documentation

active : bool

When set to true, a connection is made to the server with the given url. When set to false, the connection is closed. The default value is false.


errorString : QString [read-only]

Contains a description of the last error that occurred. When no error occurrred, this string is empty.


negotiatedSubprotocol : QString [read-only, since 6.4]

The WebSocket subprotocol that has been negotiated with the server.

This property was introduced in Qt 6.4.


requestedSubprotocols : QStringList [since 6.4]

The list of WebSocket subprotocols to send in the WebSocket handshake.

This property was introduced in Qt 6.4.


status : Status [read-only]

Status of the WebSocket.

The status can have the following values:

  • WebSocket.Connecting
  • WebSocket.Open
  • WebSocket.Closing
  • WebSocket.Closed
  • WebSocket.Error

url : QUrl

Server url to connect to. The url must have one of 2 schemes: ws:// or wss://. When not supplied, then ws:// is used.


Signal Documentation

binaryMessageReceived(QString message)

This signal is emitted when a binary message is received. message contains the bytes received.

Note: The corresponding handler is onBinaryMessageReceived.


statusChanged(Status status)

This signal is emitted when the status of the WebSocket changes. The status argument provides the current status.

Note: The corresponding handler is onStatusChanged.

See also WebSocket::status.


textMessageReceived(QString message)

This signal is emitted when a text message is received. message contains the bytes received.

Note: The corresponding handler is onTextMessageReceived.


Method Documentation

void sendBinaryMessage(ArrayBuffer message)

Sends the parameter message to the server.


void sendTextMessage(string message)

Sends message to the server.