### Add QML WebSocket Client Example

Source: https://github.com/qt/qtwebsockets/blob/dev/examples/websockets/CMakeLists.txt

Adds the qmlwebsocketclient example. This example demonstrates how to use Qt WebSockets with QML.

```cmake
qt_internal_add_example(qmlwebsocketclient)
```

--------------------------------

### Add QML WebSocket Server Example

Source: https://github.com/qt/qtwebsockets/blob/dev/examples/websockets/CMakeLists.txt

Adds the qmlwebsocketserver example. This example demonstrates how to create a WebSocket server using Qt WebSockets and QML.

```cmake
qt_internal_add_example(qmlwebsocketserver)
```

--------------------------------

### Add SSL Echo Server Example

Source: https://github.com/qt/qtwebsockets/blob/dev/examples/websockets/CMakeLists.txt

Adds the sslechoserver example. This example demonstrates a WebSocket server with SSL/TLS support.

```cmake
qt_internal_add_example(sslechoserver)
```

--------------------------------

### Add SSL Echo Client Example

Source: https://github.com/qt/qtwebsockets/blob/dev/examples/websockets/CMakeLists.txt

Adds the sslechoclient example. This example demonstrates a WebSocket client with SSL/TLS support.

```cmake
qt_internal_add_example(sslechoclient)
```

--------------------------------

### Add Simple Chat Example

Source: https://github.com/qt/qtwebsockets/blob/dev/examples/websockets/CMakeLists.txt

Adds the simplechat example. This example demonstrates a multi-client chat application using Qt WebSockets.

```cmake
qt_internal_add_example(simplechat)
```

--------------------------------

### Add Echo Client Example

Source: https://github.com/qt/qtwebsockets/blob/dev/examples/websockets/CMakeLists.txt

Adds the echoclient example. This example demonstrates a basic WebSocket client that echoes messages.

```cmake
qt_internal_add_example(echoclient)
```

--------------------------------

### Add Echo Server Example

Source: https://github.com/qt/qtwebsockets/blob/dev/examples/websockets/CMakeLists.txt

Adds the echoserver example. This example demonstrates a basic WebSocket server that echoes received messages.

```cmake
qt_internal_add_example(echoserver)
```

--------------------------------

### CMakeLists.txt for Simple Chat Server

Source: https://github.com/qt/qtwebsockets/blob/dev/examples/websockets/simplechat/CMakeLists.txt

This CMakeLists.txt file configures the build for a Qt WebSockets chat server. It sets up the project, finds the WebSockets module, defines the executable, and specifies installation rules. Ensure Qt6 is installed and configured for CMake.

```cmake
cmake_minimum_required(VERSION 3.16)
project(simplechatserver LANGUAGES CXX)

if (ANDROID)
    message(FATAL_ERROR "This project cannot be built on Android.")
endif()

set(CMAKE_AUTOMOC ON)

if(NOT DEFINED INSTALL_EXAMPLESDIR)
    set(INSTALL_EXAMPLESDIR "examples")
endif()

set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/websockets/simplechat")

find_package(Qt6 REQUIRED COMPONENTS WebSockets)

qt_add_executable(simplechatserver
    chatserver.cpp chatserver.h
    main.cpp
)

set_target_properties(simplechatserver PROPERTIES
    WIN32_EXECUTABLE FALSE
    MACOSX_BUNDLE FALSE
)

target_link_libraries(simplechatserver PUBLIC
    Qt::WebSockets
)

install(TARGETS simplechatserver
    RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}"
    BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}"
    LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}"
)
```

--------------------------------

### QML WebSocketServer Example

Source: https://context7.com/qt/qtwebsockets/llms.txt

Declarative QML interface for creating WebSocket servers. Handles client connections, message reception, and status changes. Supports subprotocols from Qt 6.4.

```qml
import QtQuick
import QtWebSockets

Rectangle {
    width: 400
    height: 400

    WebSocketServer {
        id: server
        port: 8080
        host: "0.0.0.0"
        name: "QML Chat Server"
        listen: true
        accept: true

        // Supported subprotocols (Qt 6.4+)
        supportedSubprotocols: ["chat", "json-rpc"]

        onClientConnected: function(webSocket) {
            console.log("Client connected from:", webSocket.url)
            clientList.model.append({ socket: webSocket })

            // Handle messages from this client
            webSocket.onTextMessageReceived.connect(function(message) {
                console.log("Message from client:", message)
                messageLog.text += "\nClient: " + message

                // Echo back or broadcast to all clients
                webSocket.sendTextMessage("Server received: " + message)
            })

            webSocket.onStatusChanged.connect(function() {
                if (webSocket.status === WebSocket.Closed) {
                    console.log("Client disconnected")
                }
            })
        }

        onErrorStringChanged: {
            console.log("Server error:", errorString)
        }
    }

    Column {
        anchors.fill: parent
        anchors.margins: 10
        spacing: 10

        Text {
            text: server.listen ? "Server URL: " + server.url : "Server stopped"
            font.bold: true
        }

        Text {
            id: messageLog
            text: "Messages:"
            width: parent.width
            wrapMode: Text.Wrap
        }

        Row {
            spacing: 10

            Rectangle {
                width: 120; height: 40
                color: server.listen ? "lightcoral" : "lightgreen"
                Text {
                    anchors.centerIn: parent
                    text: server.listen ? "Stop Server" : "Start Server"
                }
                MouseArea {
                    anchors.fill: parent
                    onClicked: server.listen = !server.listen
                }
            }

            Rectangle {
                width: 120; height: 40
                color: server.accept ? "lightgreen" : "lightgray"
                Text {
                    anchors.centerIn: parent
                    text: server.accept ? "Accepting" : "Paused"
                }
                MouseArea {
                    anchors.fill: parent
                    onClicked: server.accept = !server.accept
                }
            }
        }

        ListView {
            id: clientList
            width: parent.width
            height: 100
            model: ListModel {}
            delegate: Text {
                text: "Connected client"
            }
        }
    }
}
```

--------------------------------

### Configure CMake for Echo Client

Source: https://github.com/qt/qtwebsockets/blob/dev/examples/websockets/echoclient/CMakeLists.txt

This CMakeLists.txt file sets up the build environment for the Qt WebSockets echo client. It requires a minimum CMake version, defines the project, finds the necessary Qt6 modules (Core and WebSockets), and configures the executable and installation paths.

```cmake
cmake_minimum_required(VERSION 3.16)
project(echoclient LANGUAGES CXX)

if (ANDROID)
    message(FATAL_ERROR "This project cannot be built on Android.")
endif()

set(CMAKE_AUTOMOC ON)

if(NOT DEFINED INSTALL_EXAMPLESDIR)
    set(INSTALL_EXAMPLESDIR "examples")
endif()

set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/websockets/echoclient")

find_package(Qt6 REQUIRED COMPONENTS Core WebSockets)

qt_add_executable(echoclient
    echoclient.cpp echoclient.h
    main.cpp
)

set_target_properties(echoclient PROPERTIES
    WIN32_EXECUTABLE FALSE
    MACOSX_BUNDLE FALSE
)

target_link_libraries(echoclient PUBLIC
    Qt::Core
    Qt::WebSockets
)

install(TARGETS echoclient
    RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}"
    BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}"
    LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}"
)
```

--------------------------------

### CMake configuration for sslechoclient

Source: https://github.com/qt/qtwebsockets/blob/dev/examples/websockets/sslechoclient/CMakeLists.txt

Defines the project structure, dependencies, and installation rules for the SSL echo client.

```cmake
# Copyright (C) 2022 The Qt Company Ltd.
# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause

cmake_minimum_required(VERSION 3.16)
project(sslechoclient LANGUAGES CXX)

if (ANDROID)
    message(FATAL_ERROR "This project cannot be built on Android.")
endif()

set(CMAKE_AUTOMOC ON)

if(NOT DEFINED INSTALL_EXAMPLESDIR)
    set(INSTALL_EXAMPLESDIR "examples")
endif()

set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/websockets/sslechoclient")

find_package(Qt6 REQUIRED COMPONENTS WebSockets)

qt_add_executable(sslechoclient
    main.cpp
    sslechoclient.cpp sslechoclient.h
)

qt_add_resources(sslechoclient "cert"
    BASE ../sslechoserver
    FILES ../sslechoserver/localhost.cert
)

set_target_properties(sslechoclient PROPERTIES
    WIN32_EXECUTABLE FALSE
    MACOSX_BUNDLE FALSE
)

target_link_libraries(sslechoclient PUBLIC
    Qt::WebSockets
)

install(TARGETS sslechoclient
    RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}"
    BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}"
    LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}"
)
```

--------------------------------

### CMake Build Configuration for QML WebSocket Client

Source: https://github.com/qt/qtwebsockets/blob/dev/examples/websockets/qmlwebsocketclient/CMakeLists.txt

This CMakeLists.txt file configures the build for a QML WebSocket client. It finds necessary Qt modules, defines the executable, and sets up installation rules. Ensure Qt 6 and its WebSockets module are available.

```cmake
cmake_minimum_required(VERSION 3.16)
project(qmlwebsocketclient LANGUAGES CXX)

set(CMAKE_AUTOMOC ON)

if(NOT DEFINED INSTALL_EXAMPLESDIR)
    set(INSTALL_EXAMPLESDIR "examples")
endif()

set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/websockets/qmlwebsocketclient")

find_package(Qt6 REQUIRED COMPONENTS Core Gui Quick WebSockets)

qt_add_executable(qmlwebsocketclient
    main.cpp
)

set_target_properties(qmlwebsocketclient PROPERTIES
    WIN32_EXECUTABLE TRUE
    MACOSX_BUNDLE FALSE
)

target_link_libraries(qmlwebsocketclient PUBLIC
    Qt::Core
    Qt::Gui
    Qt::Quick
    Qt::WebSockets
)

# Resources:
set(data_resource_files
    "qml/qmlwebsocketclient/main.qml"
)

qt6_add_resources(qmlwebsocketclient "data"
    PREFIX
        "/"
    FILES
        ${data_resource_files}
)

install(TARGETS qmlwebsocketclient
    RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}"
    BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}"
    LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}"
)
```

--------------------------------

### Open WebSocket Connections

Source: https://context7.com/qt/qtwebsockets/llms.txt

Demonstrates opening WebSocket connections using a simple URL, QNetworkRequest with custom headers, and QWebSocketHandshakeOptions for subprotocol negotiation. Includes checking the negotiated subprotocol after connection.

```cpp
#include <QtWebSockets/QWebSocket>
#include <QtWebSockets/QWebSocketHandshakeOptions>
#include <QtNetwork/QNetworkRequest>

QWebSocket socket;

// Simple URL-based connection
socket.open(QUrl(QStringLiteral("ws://echo.websocket.org")));

// Connection with custom headers via QNetworkRequest
QNetworkRequest request(QUrl(QStringLiteral("ws://api.example.com/ws")));
request.setRawHeader("Authorization", "Bearer token123");
request.setRawHeader("X-Custom-Header", "custom-value");
socket.open(request);

// Connection with subprotocol negotiation
QWebSocketHandshakeOptions options;
options.setSubprotocols(QStringList() << "graphql-ws" << "subscriptions-transport-ws");
socket.open(QUrl(QStringLiteral("ws://graphql.example.com/subscriptions")), options);

// Check negotiated subprotocol after connection
QObject::connect(&socket, &QWebSocket::connected, [&socket]() {
    qDebug() << "Connected with subprotocol:" << socket.subprotocol();
    qDebug() << "Request URL:" << socket.requestUrl();
    qDebug() << "Origin:" << socket.origin();
});
```

--------------------------------

### Implement a WebSocket Client with QWebSocket

Source: https://context7.com/qt/qtwebsockets/llms.txt

Demonstrates establishing a connection, handling lifecycle signals, and sending/receiving text and binary messages.

```cpp
#include <QtCore/QCoreApplication>
#include <QtWebSockets/QWebSocket>
#include <QtCore/QDebug>

class WebSocketClient : public QObject
{
    Q_OBJECT
public:
    explicit WebSocketClient(const QUrl &url, QObject *parent = nullptr)
        : QObject(parent)
    {
        // Connect signals for connection lifecycle
        connect(&m_webSocket, &QWebSocket::connected, this, &WebSocketClient::onConnected);
        connect(&m_webSocket, &QWebSocket::disconnected, this, &WebSocketClient::onDisconnected);
        connect(&m_webSocket, &QWebSocket::textMessageReceived, this, &WebSocketClient::onTextMessageReceived);
        connect(&m_webSocket, &QWebSocket::binaryMessageReceived, this, &WebSocketClient::onBinaryMessageReceived);
        connect(&m_webSocket, &QWebSocket::errorOccurred, this, &WebSocketClient::onError);
        connect(&m_webSocket, &QWebSocket::pong, this, &WebSocketClient::onPong);

        // Open connection to the WebSocket server
        m_webSocket.open(url);
    }

private slots:
    void onConnected()
    {
        qDebug() << "WebSocket connected to" << m_webSocket.requestUrl();
        qDebug() << "Protocol version:" << m_webSocket.version();

        // Send a text message
        qint64 bytesSent = m_webSocket.sendTextMessage(QStringLiteral("Hello, server!"));
        qDebug() << "Sent" << bytesSent << "bytes";

        // Send a binary message
        QByteArray binaryData = QByteArrayLiteral("\x00\x01\x02\x03");
        m_webSocket.sendBinaryMessage(binaryData);

        // Send a ping to measure latency
        m_webSocket.ping(QByteArrayLiteral("ping-payload"));
    }

    void onTextMessageReceived(const QString &message)
    {
        qDebug() << "Text message received:" << message;
    }

    void onBinaryMessageReceived(const QByteArray &message)
    {
        qDebug() << "Binary message received, size:" << message.size();
    }

    void onPong(quint64 elapsedTime, const QByteArray &payload)
    {
        qDebug() << "Pong received! Round-trip time:" << elapsedTime << "ms";
    }

    void onDisconnected()
    {
        qDebug() << "Disconnected. Close code:" << m_webSocket.closeCode()
                 << "Reason:" << m_webSocket.closeReason();
    }

    void onError(QAbstractSocket::SocketError error)
    {
        qDebug() << "Error:" << error << "-" << m_webSocket.errorString();
    }

private:
    QWebSocket m_webSocket;
};

// Usage
int main(int argc, char *argv[])
{
    QCoreApplication app(argc, argv);
    WebSocketClient client(QUrl(QStringLiteral("ws://localhost:1234")));
    return app.exec();
}
```

--------------------------------

### Implement an Echo WebSocket Server in C++

Source: https://context7.com/qt/qtwebsockets/llms.txt

Demonstrates creating a server that listens for connections and echoes received text or binary messages back to the client.

```cpp
#include <QtCore/QCoreApplication>
#include <QtWebSockets/QWebSocketServer>
#include <QtWebSockets/QWebSocket>
#include <QtCore/QList>
#include <QtCore/QDebug>

class EchoServer : public QObject
{
    Q_OBJECT
public:
    explicit EchoServer(quint16 port, QObject *parent = nullptr)
        : QObject(parent)
        , m_server(new QWebSocketServer(QStringLiteral("Echo Server"),
                                        QWebSocketServer::NonSecureMode, this))
    {
        if (m_server->listen(QHostAddress::Any, port)) {
            qDebug() << "Server listening on port" << port;
            qDebug() << "Server URL:" << m_server->serverUrl();

            connect(m_server, &QWebSocketServer::newConnection,
                    this, &EchoServer::onNewConnection);
            connect(m_server, &QWebSocketServer::closed,
                    this, &EchoServer::closed);
            connect(m_server, &QWebSocketServer::serverError,
                    this, &EchoServer::onServerError);
        } else {
            qDebug() << "Failed to start server:" << m_server->errorString();
        }
    }

    ~EchoServer()
    {
        m_server->close();
        qDeleteAll(m_clients);
    }

Q_SIGNALS:
    void closed();

private Q_SLOTS:
    void onNewConnection()
    {
        QWebSocket *socket = m_server->nextPendingConnection();

        qDebug() << "New client connected from" << socket->peerAddress().toString()
                 << ":" << socket->peerPort();

        connect(socket, &QWebSocket::textMessageReceived,
                this, &EchoServer::processTextMessage);
        connect(socket, &QWebSocket::binaryMessageReceived,
                this, &EchoServer::processBinaryMessage);
        connect(socket, &QWebSocket::disconnected,
                this, &EchoServer::socketDisconnected);

        m_clients << socket;
    }

    void processTextMessage(const QString &message)
    {
        QWebSocket *client = qobject_cast<QWebSocket *>(sender());
        if (client) {
            qDebug() << "Received from" << client->peerAddress() << ":" << message;
            client->sendTextMessage(message);  // Echo back
        }
    }

    void processBinaryMessage(const QByteArray &message)
    {
        QWebSocket *client = qobject_cast<QWebSocket *>(sender());
        if (client) {
            qDebug() << "Received binary data, size:" << message.size();
            client->sendBinaryMessage(message);  // Echo back
        }
    }

    void socketDisconnected()
    {
        QWebSocket *client = qobject_cast<QWebSocket *>(sender());
        if (client) {
            qDebug() << "Client disconnected:" << client->peerAddress();
            m_clients.removeAll(client);
            client->deleteLater();
        }
    }

    void onServerError(QWebSocketProtocol::CloseCode closeCode)
    {
        qDebug() << "Server error:" << closeCode << m_server->errorString();
    }

private:
    QWebSocketServer *m_server;
    QList<QWebSocket *> m_clients;
};

// Usage
int main(int argc, char *argv[])
{
    QCoreApplication app(argc, argv);
    EchoServer server(1234);
    return app.exec();
}
```

--------------------------------

### QWebSocket::open() - Opening Connections

Source: https://context7.com/qt/qtwebsockets/llms.txt

Demonstrates how to open a WebSocket connection using a URL or QNetworkRequest, including options for subprotocol negotiation and custom headers.

```APIDOC
## QWebSocket::open()

### Description
Opens a WebSocket connection to a server using a URL or QNetworkRequest, optionally with handshake options for subprotocol negotiation and custom headers.

### Method
POST (implicitly, for establishing connection)

### Endpoint
`ws://<server_address>` or `wss://<server_address>`

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None (connection details are in URL or QNetworkRequest)

### Request Example
```cpp
#include <QtWebSockets/QWebSocket>
#include <QtWebSockets/QWebSocketHandshakeOptions>
#include <QtNetwork/QNetworkRequest>

QWebSocket socket;

// Simple URL-based connection
socket.open(QUrl(QStringLiteral("ws://echo.websocket.org")));

// Connection with custom headers via QNetworkRequest
QNetworkRequest request(QUrl(QStringLiteral("ws://api.example.com/ws")));
request.setRawHeader("Authorization", "Bearer token123");
request.setRawHeader("X-Custom-Header", "custom-value");
socket.open(request);

// Connection with subprotocol negotiation
QWebSocketHandshakeOptions options;
options.setSubprotocols(QStringList() << "graphql-ws" << "subscriptions-transport-ws");
socket.open(QUrl(QStringLiteral("ws://graphql.example.com/subscriptions")), options);
```

### Response
#### Success Response (200)
Connection established. The `connected()` signal is emitted.

#### Response Example
```cpp
QObject::connect(&socket, &QWebSocket::connected, [&socket]() {
    qDebug() << "Connected with subprotocol:" << socket.subprotocol();
    qDebug() << "Request URL:" << socket.requestUrl();
    qDebug() << "Origin:" << socket.origin();
});
```
```

--------------------------------

### QState Class Documentation

Source: https://github.com/qt/qtwebsockets/blob/dev/tests/auto/bic/data/QtWebSockets.5.12.0.linux-gcc-amd64.txt

Details about the QState class, its size, alignment, and inheritance hierarchy.

```APIDOC
## QState Class

### Description
Represents a state in a state machine. It inherits from QAbstractState and QObject.

### Size and Alignment
- Size: 16 bytes
- Alignment: 8 bytes

### Inheritance
- `QAbstractState`
- `QObject`

### Vtable for QState

- **Entries**: 16
- **Details**: Contains pointers to metaObject, qt_metacast, qt_metacall, destructor, event, eventFilter, timerEvent, childEvent, customEvent, connectNotify, disconnectNotify, onEntry, and onExit.
```

--------------------------------

### Initialize and Manage WebSocket Connection

Source: https://github.com/qt/qtwebsockets/blob/dev/examples/websockets/simplechat/chatclient.html

Sets up the WebSocket connection, handles connection events (open, close, message, error), and provides functions to connect, disconnect, and check the socket state. Ensure the WebSocket API is available in the browser.

```javascript
var debugTextArea = document.getElementById("debugTextArea"); function debug(message) { debugTextArea.value += message + "\n"; debugTextArea.scrollTop = debugTextArea.scrollHeight; } function sendMessage() { var nickname = document.getElementById("inputNick").value; var msg = document.getElementById("inputText").value; var strToSend = nickname + ": " + msg; if ( websocket != null ) { document.getElementById("inputText").value = ""; websocket.send( strToSend ); console.log( "string sent :", '"'+strToSend+'"' ); debug(strToSend); } } var websocket = null; function initWebSocket() { try { if (typeof MozWebSocket == 'function') WebSocket = MozWebSocket; if ( websocket && websocket.readyState == 1 ) websocket.close(); var wsUri = "ws://" + document.getElementById("webSocketHost").value; websocket = new WebSocket( wsUri ); websocket.onopen = function (evt) { debug("CONNECTED"); document.getElementById("disconnectButton").disabled = false; document.getElementById("sendButton").disabled = false; }; websocket.onclose = function (evt) { debug("DISCONNECTED"); document.getElementById("disconnectButton").disabled = true; document.getElementById("sendButton").disabled = true; }; websocket.onmessage = function (evt) { console.log( "Message received :", evt.data ); debug( evt.data ); }; websocket.onerror = function (evt) { debug('ERROR: ' + evt.data); }; } catch (exception) { debug('ERROR: ' + exception); } } function stopWebSocket() { if (websocket) websocket.close(); } function checkSocket() { if (websocket != null) { var stateStr; switch (websocket.readyState) { case 0: { stateStr = "CONNECTING"; break; } case 1: { stateStr = "OPEN"; break; } case 2: { stateStr = "CLOSING"; break; } case 3: { stateStr = "CLOSED"; break; } default: { stateStr = "UNKNOW"; break; } } debug("WebSocket state = " + websocket.readyState + " ( " + stateStr + " )"); } else { debug("WebSocket is null"); } }
```

--------------------------------

### Configure HTTP Proxy for QWebSocket

Source: https://context7.com/qt/qtwebsockets/llms.txt

Sets up an HTTP proxy for WebSocket connections using QNetworkProxy. Handles proxy authentication dynamically.

```cpp
#include <QtWebSockets/QWebSocket>
#include <QtNetwork/QNetworkProxy>
#include <QtNetwork/QAuthenticator>

QWebSocket socket;

// Configure HTTP proxy
QNetworkProxy proxy;
proxy.setType(QNetworkProxy::HttpProxy);
proxy.setHostName("proxy.example.com");
proxy.setPort(8080);
proxy.setUser("proxyuser");
proxy.setPassword("proxypass");
socket.setProxy(proxy);

// Handle proxy authentication dynamically
QObject::connect(&socket, &QWebSocket::proxyAuthenticationRequired,
                 [](const QNetworkProxy &proxy, QAuthenticator *authenticator) {
    qDebug() << "Proxy authentication required for:" << proxy.hostName();
    authenticator->setUser("username");
    authenticator->setPassword("password");
});

// Use system proxy settings
socket.setProxy(QNetworkProxy::applicationProxy());

// Disable proxy (direct connection)
socket.setProxy(QNetworkProxy::NoProxy);

socket.open(QUrl(QStringLiteral("ws://target.example.com/ws")));
```

--------------------------------

### Geometry Classes (QPoint, QPointF, QLine, QLineF)

Source: https://github.com/qt/qtwebsockets/blob/dev/tests/auto/bic/data/QtWebSockets.5.13.0.linux-gcc-amd64.txt

Documentation for various geometry-related classes in Qt.

```APIDOC
## QPoint

### Description
Represents a point in 2D space with integer coordinates.

### Size and Alignment
- Size: 8 bytes
- Alignment: 4 bytes

### Base Class Information
- Base Size: 8 bytes
- Base Alignment: 4 bytes

## QPointF

### Description
Represents a point in 2D space with floating-point coordinates.

### Size and Alignment
- Size: 16 bytes
- Alignment: 8 bytes

### Base Class Information
- Base Size: 16 bytes
- Base Alignment: 8 bytes

## QLine

### Description
Represents a line segment in 2D space with integer coordinates.

### Size and Alignment
- Size: 16 bytes
- Alignment: 4 bytes

### Base Class Information
- Base Size: 16 bytes
- Base Alignment: 4 bytes

## QLineF

### Description
Represents a line segment in 2D space with floating-point coordinates.

### Size and Alignment
- Size: 32 bytes
- Alignment: 8 bytes

### Base Class Information
- Base Size: 32 bytes
- Base Alignment: 8 bytes
```

--------------------------------

### Meta Information Classes (QMetaMethod, QMetaEnum, QMetaProperty, QMetaClassInfo)

Source: https://github.com/qt/qtwebsockets/blob/dev/tests/auto/bic/data/QtWebSockets.5.13.0.linux-gcc-amd64.txt

Documentation for classes related to Qt's meta-object system.

```APIDOC
## QMetaMethod

### Description
Represents a meta-method in Qt's meta-object system.

### Size and Alignment
- Size: 16 bytes
- Alignment: 8 bytes

### Base Class Information
- Base Size: 12 bytes
- Base Alignment: 8 bytes

## QMetaEnum

### Description
Represents a meta-enum in Qt's meta-object system.

### Size and Alignment
- Size: 16 bytes
- Alignment: 8 bytes

### Base Class Information
- Base Size: 12 bytes
- Base Alignment: 8 bytes

## QMetaProperty

### Description
Represents a meta-property in Qt's meta-object system.

### Size and Alignment
- Size: 32 bytes
- Alignment: 8 bytes

### Base Class Information
- Base Size: 32 bytes
- Base Alignment: 8 bytes

## QMetaClassInfo

### Description
Represents meta information about a class in Qt's meta-object system.

### Size and Alignment
- Size: 16 bytes
- Alignment: 8 bytes

### Base Class Information
- Base Size: 12 bytes
- Base Alignment: 8 bytes
```

--------------------------------

### Configure Server Connection Limits and Timeouts

Source: https://context7.com/qt/qtwebsockets/llms.txt

This C++ code demonstrates advanced server configuration for Qt WebSockets, including setting maximum pending connections, handshake timeouts, and managing connection flow control. It requires Qt WebSockets and QtCore libraries.

```cpp
#include <QtWebSockets/QWebSocketServer>
#include <QtWebSockets/QWebSocket>
#include <chrono>

QWebSocketServer server(QStringLiteral("Managed Server"), QWebSocketServer::NonSecureMode);

// Configure connection limits
server.setMaxPendingConnections(100);
qDebug() << "Max pending connections:" << server.maxPendingConnections();

// Set handshake timeout (Qt 6+)
server.setHandshakeTimeout(std::chrono::milliseconds(5000));
// Or using integer milliseconds:
server.setHandshakeTimeout(5000);
qDebug() << "Handshake timeout:" << server.handshakeTimeoutMS() << "ms";

// Flow control for accepting connections
QObject::connect(&server, &QWebSocketServer::newConnection, [&server]() {
    while (server.hasPendingConnections()) {
        QWebSocket *socket = server.nextPendingConnection();
        qDebug() << "Processing connection from:" << socket->peerAddress();
        // Handle socket...
    }
});

// Pause/resume accepting new connections
server.pauseAccepting();
qDebug() << "Server paused accepting connections";
// ... do maintenance ...
server.resumeAccepting();
qDebug() << "Server resumed accepting connections";

// Handle existing TCP socket upgrade
QTcpSocket *existingTcpSocket = /* from QTcpServer */;
server.handleConnection(existingTcpSocket);

// Server information
if (server.listen(QHostAddress::Any, 8080)) {
    qDebug() << "Server address:" << server.serverAddress();
    qDebug() << "Server port:" << server.serverPort();
    qDebug() << "Server URL:" << server.serverUrl();
    qDebug() << "Secure mode:" << server.secureMode();
    qDebug() << "Supported versions:" << server.supportedVersions();
}

```

--------------------------------

### Set up Qt WebSockets SSL Echo Server Project

Source: https://github.com/qt/qtwebsockets/blob/dev/examples/websockets/sslechoserver/CMakeLists.txt

Configures the CMake build for a Qt WebSockets SSL echo server. Ensure Qt6 WebSockets module is available.

```cmake
cmake_minimum_required(VERSION 3.16)
project(sslechoserver LANGUAGES CXX)

if (ANDROID)
    message(FATAL_ERROR "This project cannot be built on Android.")
endif()

set(CMAKE_AUTOMOC ON)

if(NOT DEFINED INSTALL_EXAMPLESDIR)
    set(INSTALL_EXAMPLESDIR "examples")
endif()

set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/websockets/sslechoserver")

find_package(Qt6 REQUIRED COMPONENTS WebSockets)

qt_add_executable(sslechoserver
    main.cpp
    sslechoserver.cpp sslechoserver.h
)

set_target_properties(sslechoserver PROPERTIES
    WIN32_EXECUTABLE FALSE
    MACOSX_BUNDLE FALSE
)

target_link_libraries(sslechoserver PUBLIC
    Qt::WebSockets
)

# Resources:
set(securesocketclient_resource_files
    "localhost.cert"
    "localhost.key"
)

qt6_add_resources(sslechoserver "securesocketclient"
    PREFIX
        "/"
    FILES
        ${securesocketclient_resource_files}
)

install(TARGETS sslechoserver
    RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}"
    BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}"
    LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}"
)
```

--------------------------------

### QStateMachine Class Documentation

Source: https://github.com/qt/qtwebsockets/blob/dev/tests/auto/bic/data/QtWebSockets.5.12.0.linux-gcc-amd64.txt

Details about the QStateMachine class, its size, alignment, and inheritance hierarchy.

```APIDOC
## QStateMachine Class

### Description
Manages a collection of states and transitions, forming a state machine. It inherits from QState, QAbstractState, and QObject.

### Size and Alignment
- Size: 16 bytes
- Alignment: 8 bytes

### Inheritance
- `QState`
- `QAbstractState`
- `QObject`

### Vtable for QStateMachine

- **Entries**: 20
- **Details**: Includes functions for metaObject, qt_metacast, qt_metacall, destructor, event, eventFilter, timerEvent, childEvent, customEvent, connectNotify, disconnectNotify, onEntry, onExit, beginSelectTransitions, endSelectTransitions, beginMicrostep, and endMicrostep.
```

--------------------------------

### QFileDevice Class

Source: https://github.com/qt/qtwebsockets/blob/dev/tests/auto/bic/data/QtWebSockets.5.10.0.linux-gcc-amd64.txt

Details regarding the QFileDevice class, its inheritance, and virtual function table.

```APIDOC
## QFileDevice Class

### Description
Provides details about the QFileDevice class, its memory layout, base classes (QIODevice, QObject), and virtual function table.

### Class Details
- **Size**: 16 bytes
- **Alignment**: 8 bytes
- **Base Class Size**: 16 bytes
- **Base Class Alignment**: 8 bytes

### Inheritance
- **QIODevice**: 0x0x7f7d678e57b8
- **QObject**: 0x0x7f7d678eb240

### Vtable for QFileDevice
- **Entries**: 34
- **Entry 0**: (int (*)(...))0
- **Entry 8**: (int (*)(...))(& _ZTI11QFileDevice)
- **Entry 16**: (int (*)(...))QFileDevice::metaObject
- **Entry 24**: (int (*)(...))QFileDevice::qt_metacast
- **Entry 32**: (int (*)(...))QFileDevice::qt_metacall
- **Entry 40**: (int (*)(...))QFileDevice::~QFileDevice
- **Entry 48**: (int (*)(...))QFileDevice::~QFileDevice
- **Entry 56**: (int (*)(...))QObject::event
- **Entry 64**: (int (*)(...))QObject::eventFilter
- **Entry 72**: (int (*)(...))QObject::timerEvent
- **Entry 80**: (int (*)(...))QObject::childEvent
- **Entry 88**: (int (*)(...))QObject::customEvent
- **Entry 96**: (int (*)(...))QObject::connectNotify
- **Entry 104**: (int (*)(...))QObject::disconnectNotify
- **Entry 112**: (int (*)(...))QFileDevice::isSequential
- **Entry 120**: (int (*)(...))QIODevice::open
- **Entry 128**: (int (*)(...))QFileDevice::close
- **Entry 136**: (int (*)(...))QFileDevice::pos
- **Entry 144**: (int (*)(...))QFileDevice::size
- **Entry 152**: (int (*)(...))QFileDevice::seek
- **Entry 160**: (int (*)(...))QFileDevice::atEnd
- **Entry 168**: (int (*)(...))QIODevice::reset
- **Entry 176**: (int (*)(...))QIODevice::bytesAvailable
- **Entry 184**: (int (*)(...))QIODevice::bytesToWrite
- **Entry 192**: (int (*)(...))QIODevice::canReadLine
- **Entry 200**: (int (*)(...))QIODevice::waitForReadyRead
- **Entry 208**: (int (*)(...))QIODevice::waitForBytesWritten
- **Entry 216**: (int (*)(...))QFileDevice::readData
- **Entry 224**: (int (*)(...))QFileDevice::readLineData
- **Entry 232**: (int (*)(...))QFileDevice::writeData
- **Entry 240**: (int (*)(...))QFileDevice::fileName
- **Entry 248**: (int (*)(...))QFileDevice::resize
- **Entry 256**: (int (*)(...))QFileDevice::permissions
- **Entry 264**: (int (*)(...))QFileDevice::setPermissions
```

--------------------------------

### QLibrary Class and Vtable

Source: https://github.com/qt/qtwebsockets/blob/dev/tests/auto/bic/data/QtWebSockets.5.13.0.linux-gcc-amd64.txt

Information regarding the QLibrary class, its memory layout, inheritance from QObject, and its virtual method table (vtable).

```APIDOC
## QLibrary::QPrivateSignal

### Description
Internal class for private signals within QLibrary.

### Size and Alignment
- Size: 1 byte
- Alignment: 1 byte

### Base Class Information
- Base Size: 0 bytes
- Base Alignment: 1 byte

## Vtable for QLibrary

### Description
Virtual Method Table for the QLibrary class.

### Entries
- 0: (int (*)(...))0
- 8: (int (*)(...))(& _ZTI8QLibrary)
- 16: (int (*)(...))QLibrary::metaObject
- 24: (int (*)(...))QLibrary::qt_metacast
- 32: (int (*)(...))QLibrary::qt_metacall
- 40: (int (*)(...))QLibrary::~QLibrary
- 48: (int (*)(...))QLibrary::~QLibrary
- 56: (int (*)(...))QObject::event
- 64: (int (*)(...))QObject::eventFilter
- 72: (int (*)(...))QObject::timerEvent
- 80: (int (*)(...))QObject::childEvent
- 88: (int (*)(...))QObject::customEvent
- 96: (int (*)(...))QObject::connectNotify
- 104: (int (*)(...))QObject::disconnectNotify

## QLibrary

### Description
Represents a dynamic library.

### Size and Alignment
- Size: 32 bytes
- Alignment: 8 bytes

### Base Class Information
- Base Size: 25 bytes
- Base Alignment: 8 bytes

### Inheritance
- Inherits from QObject.
- vptr points to `(& QLibrary::_ZTV8QLibrary) + 16`.
- Primary base for QLibrary instance.
```

--------------------------------

### Create Secure WebSocket Server

Source: https://context7.com/qt/qtwebsockets/llms.txt

Use this class to create a secure WebSocket server that listens for incoming connections on a specified port. Ensure server.crt and server.key files are available in the application's directory.

```cpp
#include <QtWebSockets/QWebSocketServer>
#include <QtWebSockets/QWebSocket>
#include <QtNetwork/QSslConfiguration>
#include <QtNetwork/QSslCertificate>
#include <QtNetwork/QSslKey>
#include <QtCore/QFile>

class SecureServer : public QObject
{
    Q_OBJECT
public:
    explicit SecureServer(quint16 port, QObject *parent = nullptr)
        : QObject(parent)
        , m_server(new QWebSocketServer(QStringLiteral("Secure Server"),
                                        QWebSocketServer::SecureMode, this))
    {
        // Load SSL certificate
        QFile certFile(QStringLiteral("server.crt"));
        certFile.open(QIODevice::ReadOnly);
        QSslCertificate certificate(&certFile, QSsl::Pem);
        certFile.close();

        // Load private key
        QFile keyFile(QStringLiteral("server.key"));
        keyFile.open(QIODevice::ReadOnly);
        QSslKey sslKey(&keyFile, QSsl::Rsa, QSsl::Pem);
        keyFile.close();

        // Configure SSL
        QSslConfiguration sslConfiguration;
        sslConfiguration.setPeerVerifyMode(QSslSocket::VerifyNone);
        sslConfiguration.setLocalCertificate(certificate);
        sslConfiguration.setPrivateKey(sslKey);
        m_server->setSslConfiguration(sslConfiguration);

        // Handle SSL errors
        connect(m_server, &QWebSocketServer::sslErrors,
                this, &SecureServer::onSslErrors);
        connect(m_server, &QWebSocketServer::peerVerifyError,
                this, &SecureServer::onPeerVerifyError);

        if (m_server->listen(QHostAddress::Any, port)) {
            qDebug() << "Secure server listening on" << m_server->serverUrl();
            connect(m_server, &QWebSocketServer::newConnection,
                    this, &SecureServer::onNewConnection);
        }
    }

private Q_SLOTS:
    void onNewConnection()
    {
        QWebSocket *socket = m_server->nextPendingConnection();
        qDebug() << "Secure client connected:" << socket->peerName();
        // Handle socket...
    }

    void onSslErrors(const QList<QSslError> &errors)
    {
        for (const QSslError &error : errors) {
            qWarning() << "SSL error:" << error.errorString();
        }
    }

    void onPeerVerifyError(const QSslError &error)
    {
        qWarning() << "Peer verification error:" << error.errorString();
    }

private:
    QWebSocketServer *m_server;
};

```

--------------------------------

### QWebSocketServer Class Overview

Source: https://github.com/qt/qtwebsockets/blob/dev/tests/auto/bic/data/QtWebSockets.5.10.0.linux-gcc-amd64.txt

This section details the QWebSocketServer class, its size, alignment, and base class information.

```APIDOC
## Class QWebSocketServer

### Description
Provides details about the QWebSocketServer class, including its memory layout and inheritance.

### Size and Alignment
- **Size**: 16 bytes
- **Alignment**: 8 bytes

### Base Class Information
- **Base Size**: 16 bytes
- **Base Alignment**: 8 bytes

### Inheritance
- **QObject**: primary-for QWebSocketServer

### Constructor and Destructor Information
- **QWebSocketServer (0x0x7f7d64700618)**: Constructor at offset 0.
  - **vptr**: Points to the virtual function table of QWebSocketServer, offset by 16 bytes.
- **QObject (0x0x7f7d6472b420)**: Base class object at offset 0.
```

--------------------------------

### QState Class

Source: https://github.com/qt/qtwebsockets/blob/dev/tests/auto/bic/data/QtWebSockets.5.13.0.linux-gcc-amd64.txt

Details about the QState class, including its virtual table and inheritance.

```APIDOC
## QState Class

### Description
Represents a state within a state machine.

### Inheritance
- QAbstractState
- QObject

### Virtual Table (Vtable)
```
Vtable for QState
QState::_ZTV6QState: 16 entries
0     (int (*)(...))0
8     (int (*)(...))(& _ZTI6QState)
16    (int (*)(...))QState::metaObject
24    (int (*)(...))QState::qt_metacast
32    (int (*)(...))QState::qt_metacall
40    (int (*)(...))QState::~QState
48    (int (*)(...))QState::~QState
56    (int (*)(...))QState::event
64    (int (*)(...))QObject::eventFilter
72    (int (*)(...))QObject::timerEvent
80    (int (*)(...))QObject::childEvent
88    (int (*)(...))QObject::customEvent
96    (int (*)(...))QObject::connectNotify
104   (int (*)(...))QObject::disconnectNotify
112   (int (*)(...))QState::onEntry
120   (int (*)(...))QState::onExit
```

### Class Definition
```
Class QState
   size=16 align=8
   base size=16 base align=8
QState (0x0x7f6ddf347410) 0
    vptr=((& QState::_ZTV6QState) + 16)
  QAbstractState (0x0x7f6ddf347478) 0
      primary-for QState (0x0x7f6ddf347410)
    QObject (0x0x7f6ddf3ce240) 0
        primary-for QAbstractState (0x0x7f6ddf347478)
```
```

--------------------------------

### QFile Class

Source: https://github.com/qt/qtwebsockets/blob/dev/tests/auto/bic/data/QtWebSockets.5.10.0.linux-gcc-amd64.txt

Information about the QFile class, including its size, inheritance, and virtual function table.

```APIDOC
## QFile Class

### Description
Details about the QFile class, its relationship with QFileDevice, and its virtual function table.

### Class Details
- **Size**: 16 bytes
- **Alignment**: 8 bytes
- **Base Class Size**: 16 bytes
- **Base Class Alignment**: 8 bytes

### Inheritance
- **QFileDevice**: 0x0x7f7d678e5750

### Vtable for QFile
- **Entries**: 34
- **Entry 0**: (int (*)(...))0
- **Entry 8**: (int (*)(...))(& _ZTI5QFile)
- **Entry 16**: (int (*)(...))QFile::metaObject
- **Entry 24**: (int (*)(...))QFile::qt_metacast
- **Entry 32**: (int (*)(...))QFile::qt_metacall
- **Entry 40**: (int (*)(...))QFile::~QFile
- **Entry 48**: (int (*)(...))QFile::~QFile
- **Entry 56**: (int (*)(...))QObject::event
- **Entry 64**: (int (*)(...))QObject::eventFilter
- **Entry 72**: (int (*)(...))QObject::timerEvent
- **Entry 80**: (int (*)(...))QObject::childEvent
- **Entry 88**: (int (*)(...))QObject::customEvent
- **Entry 96**: (int (*)(...))QObject::connectNotify
- **Entry 104**: (int (*)(...))QObject::disconnectNotify
- **Entry 112**: (int (*)(...))QFileDevice::isSequential
- **Entry 120**: (int (*)(...))QFile::open
- **Entry 128**: (int (*)(...))QFileDevice::close
- **Entry 136**: (int (*)(...))QFileDevice::pos
- **Entry 144**: (int (*)(...))QFile::size
- **Entry 152**: (int (*)(...))QFileDevice::seek
- **Entry 160**: (int (*)(...))QFileDevice::atEnd
- **Entry 168**: (int (*)(...))QIODevice::reset
```

--------------------------------

### Implement a Multi-Client Chat Server

Source: https://context7.com/qt/qtwebsockets/llms.txt

This C++ code implements a chat server that broadcasts messages to all connected clients except the sender. It requires Qt WebSockets and QtCore libraries.

```cpp
#include <QtCore/QCoreApplication>
#include <QtWebSockets/QWebSocketServer>
#include <QtWebSockets/QWebSocket>
#include <QtCore/QList>

class ChatServer : public QObject
{
    Q_OBJECT
public:
    explicit ChatServer(quint16 port, QObject *parent = nullptr)
        : QObject(parent)
        , m_server(new QWebSocketServer(QStringLiteral("Chat Server"),
                                        QWebSocketServer::NonSecureMode, this))
    {
        if (m_server->listen(QHostAddress::Any, port)) {
            qDebug() << "Chat server listening on port" << port;
            connect(m_server, &QWebSocketServer::newConnection,
                    this, &ChatServer::onNewConnection);
        }
    }

private Q_SLOTS:
    void onNewConnection()
    {
        QWebSocket *socket = m_server->nextPendingConnection();
        QString clientId = QStringLiteral("%1:%2")
            .arg(socket->peerAddress().toString())
            .arg(socket->peerPort());

        qDebug() << clientId << "connected";

        connect(socket, &QWebSocket::textMessageReceived,
                this, &ChatServer::processMessage);
        connect(socket, &QWebSocket::disconnected,
                this, &ChatServer::socketDisconnected);

        m_clients << socket;

        // Notify all clients about new user
        broadcast(QStringLiteral("User %1 joined the chat").arg(clientId), nullptr);
    }

    void processMessage(const QString &message)
    {
        QWebSocket *sender = qobject_cast<QWebSocket *>(QObject::sender());
        if (!sender) return;

        QString clientId = QStringLiteral("%1:%2")
            .arg(sender->peerAddress().toString())
            .arg(sender->peerPort());

        // Broadcast message to all OTHER clients
        QString formattedMessage = QStringLiteral("[%1]: %2").arg(clientId, message);
        broadcast(formattedMessage, sender);
    }

    void socketDisconnected()
    {
        QWebSocket *socket = qobject_cast<QWebSocket *>(QObject::sender());
        if (socket) {
            QString clientId = QStringLiteral("%1:%2")
                .arg(socket->peerAddress().toString())
                .arg(socket->peerPort());

            m_clients.removeAll(socket);
            socket->deleteLater();

            broadcast(QStringLiteral("User %1 left the chat").arg(clientId), nullptr);
            qDebug() << clientId << "disconnected";
        }
    }

private:
    void broadcast(const QString &message, QWebSocket *exclude)
    {
        for (QWebSocket *client : std::as_const(m_clients)) {
            if (client != exclude) {
                client->sendTextMessage(message);
            }
        }
    }

    QWebSocketServer *m_server;
    QList<QWebSocket *> m_clients;
};

int main(int argc, char *argv[])
{
    QCoreApplication app(argc, argv);
    ChatServer server(1234);
    return app.exec();
}

```