WebSocketFactory

Utilities for creating WebSocket instances across runtimes.

class WebSocketFactory {

private constructor();

static private detectEnvironment;

static createWebSocket(url: string | URL, protocols?: string | string[]): WebSocketLike;

static getWebSocketConstructor(): WebSocket;

static isWebSocketSupported(): boolean;

}

§Constructors

new WebSocketFactory() private

Static-only utility – prevent instantiation.

detectEnvironment

createWebSocket(url: string | URL, protocols?: string | string[]): WebSocketLike

Creates a WebSocket using the detected constructor.

@example

const socket = WebSocketFactory.createWebSocket('wss://realtime.supabase.co/socket')

getWebSocketConstructor(): WebSocket

Returns the best available WebSocket constructor for the current runtime.

@example

const WS = WebSocketFactory.getWebSocketConstructor()
const socket = new WS('wss://realtime.supabase.co/socket')

isWebSocketSupported(): boolean

Detects whether the runtime can establish WebSocket connections.

@example

if (!WebSocketFactory.isWebSocketSupported()) {
  console.warn('Falling back to long polling')
}