coder/websocket
Websocket
This is a minimal WebSocket library for Go designed for bidirectional real-time communication. It serves as a network protocol implementation for managing handshakes, frame masking, and control signals to enable the exchange of text and binary messages over persistent connections.
The library distinguishes itself by providing a connectivity layer that wraps browser WebSocket APIs for applications compiled to WebAssembly. It also functions as data compression middleware, utilizing deflate compression to reduce bandwidth usage for transmitted messages.
The project covers a broad range of networking capabilities, including connection lifecycle management via heartbeats and timeouts, protocol tunneling for wrapping arbitrary network protocols, and traffic management through message size limits and origin validation. It supports the transmission of structured data using formats such as JSON and Protobuf.
Features
- Go WebSocket Libraries - A high-performance implementation of the WebSocket protocol written specifically for Go.
- WebSocket Message Exchanges - Provides bidirectional transmission of text and binary frames over persistent WebSocket connections.
- Real-Time Data Streaming - Enables real-time delivery and processing of data streams from remote peers over persistent connections.
- Real-time Messaging - Facilitates instant bidirectional communication between systems without the overhead of repeated request-response cycles.
- Connection Establishment Protocols - Initiates and upgrades bidirectional network connections between clients and servers.
- WebSocket and Fallback Connection Establishment - Performs the initial handshake with a remote server to establish a persistent bidirectional connection.
- Connection Control Frame Handlers - Implements logic to handle protocol-level control messages like ping, pong, and close frames.
- WebSocket Frame Processors - Implements low-level processing for encoding and decoding WebSocket data and control frames using optimized buffers.
- WebSocket Ping/Pong Keepalives - Maintains connection health by exchanging WebSocket ping and pong frames.
- Websocket Connection Managers - Manages persistent WebSocket connections, including subprotocol negotiation and resource cleanup.
- Connection Termination - Implements graceful shutdown of connections using formal WebSocket status codes and handshakes.
- Health Monitoring - Monitors connection stability through the exchange of ping frames and pong responses.
- Data Framing - Encapsulates data into binary frames with headers for length, masking, and control signals.
- Frame Masking - Applies a rotating masking key to data frames using bitwise XOR operations for secure transmission.
- Network Protocol Implementations - Implements the low-level WebSocket protocol, managing handshakes, frame masking, and control signals.
- Connection Lifecycle Managers - Handles automated state transitions, heartbeats, and closing connections with specific status codes.
- Connection Hijacking - Extracts the underlying network connection from a response writer to switch to a bidirectional stream.
- WebSocket Message Readers - Implements the ability to retrieve incoming messages as byte slices or streams while processing control frames.
- WebSocket Message Writers - Provides the capability to write data as single atomic messages or streams to a WebSocket connection.
- WebSocket Frame Masking - Provides the required masking-key XOR transformation for secure WebSocket data transmission.
- Network Connection Lifecycles - Uses Go contexts and heartbeats to manage connection timeouts and prevent resource leaks.
- Protocol Upgrades - Provides mechanisms to upgrade standard HTTP connections to a persistent bidirectional WebSocket stream.
- Real-Time Communication - Provides persistent, bidirectional data streaming for sending and receiving text and binary messages.
- Real-Time Communication Protocols - Enables bidirectional, low-latency data exchange between clients and servers using the WebSocket protocol.
- JSON Data Exchange - Uses JSON for transporting structured state and configuration between clients and servers.
- Structured Message Serialization - Supports serializing and deserializing data using JSON and Protobuf formats for network transmission.
- WebSocket Frame Compression - Compresses individual WebSocket frames using the deflate algorithm to reduce network bandwidth.
- WebSocket Proxy Tunnels - Provides the ability to tunnel network traffic across restricted boundaries using WebSocket connections.
- JSON Message Exchanges - Exchanges structured JSON messages over a persistent connection to synchronize state.
- Tunneling Protocols - Provides the ability to encapsulate arbitrary network protocols within a WebSocket connection to bypass restrictive environments.
- Browser API Wrappers - Provides a connectivity layer that wraps browser WebSocket APIs for applications compiled to WebAssembly.
- WebSocket API Wrappers - Provides a connectivity layer that wraps browser WebSocket APIs for Go applications compiled to WebAssembly.
- WebSocket Payload Compressions - Lowers data transfer volume by applying compression to all outgoing and incoming frames.
- Request Size Limiters - Protects server resources from memory exhaustion by rejecting incoming frames that exceed defined byte limits.
- Response Size Limits - Caps the maximum number of bytes allowed for a single incoming message to prevent memory exhaustion.
- Browser API Wrappers - Wraps the native browser WebSocket API to provide a consistent interface for WebAssembly applications.
