Class WebSocketEvent

core/src/stdlib/pyscript/websocket.py:70–115

A read-only wrapper for [WebSocket event objects](https://developer.mozilla.org/en-US/docs/Web/API/MessageEvent). This class wraps browser WebSocket events and provides convenient access to event properties. It handles the conversion of binary data from JavaScript typed arrays

class WebSocketEvent:
    """
    A read-only wrapper for
    [WebSocket event objects](https://developer.mozilla.org/en-US/docs/Web/API/MessageEvent).

    This class wraps browser WebSocket events and provides convenient access
    to event properties. It handles the conversion of binary data from
    JavaScript typed arrays to Python bytes-like objects.

    The most commonly used property is `event.data`, which contains the
    message data for "message" events.

    ```python
    def on_message(event):  # The event is a WebSocketEvent instance.
        # For text messages.
        if isinstance(event.data, str):
            print(f"Text: {event.data}")
        else:
            # For binary messages.
            print(f"Binary: {len(event.data)} bytes")
    ```
    """

    def __init__(self, event):
        """
        Create a WebSocketEvent wrapper from an underlying JavaScript
        `event`.
        """
        self._event = event

    def __getattr__(self, attr):
        """
        Get an attribute `attr` from the underlying event object.

        Handles special conversion of binary data from JavaScript typed
        arrays to Python `memoryview` objects.
        """
        value = getattr(self._event, attr)
        if attr == "data" and not isinstance(value, str):
            if hasattr(value, "to_py"):
                # Pyodide - convert JavaScript typed array to Python.
                return value.to_py()
            else:
                # MicroPython - manually convert JS ArrayBuffer.
                return memoryview(as_bytearray(value))
        return value


class WebSocket: