Skip to main content

Connections

WSX manages WebSocket connections through the WSXConnection interface, providing a clean abstraction for real-time communication between clients and servers.

Connection Lifecycle

Connection Establishment

When a client establishes a WebSocket connection, WSX creates a WSXConnection instance that represents that specific connection:

Connection Object

Each connection has the following properties:

Connection Management

Getting Connections

You can retrieve connection information on the server:

Connection Events

Handle connection lifecycle events:

Session Data

Storing Session Information

Use sessionData to store per-connection information:

Accessing Session Data

Access session data in handlers:

Connection-Specific Messaging

Send to Specific Connection

Send messages to individual connections:

Conditional Broadcasting

Broadcast to connections based on conditions:

Connection Patterns

User Authentication

Room/Channel Management

Error Handling

Connection Errors

Handle connection-related errors gracefully:

Best Practices

  1. Session Management: Use sessionData for user state, not global variables
  2. Connection Cleanup: Handle disconnections to clean up resources
  3. Security: Validate authentication before sensitive operations
  4. Error Handling: Always handle connection errors gracefully
  5. Resource Management: Don’t store large objects in session data

Next Steps

  • Learn about Handlers for processing requests
  • Explore Broadcasting for multi-client communication
  • Understand Triggers for client-side events