Options
All
  • Public
  • Public/Protected
  • All
Menu

A structure holding settings and handlers for a WebSocket URL route handler.

Hierarchy

  • WebSocketBehavior

Index

Properties

Optional compression

compression?: number

What permessage-deflate compression to use. uWS.DISABLED, uWS.SHARED_COMPRESSOR or any of the uWS.DEDICATED_COMPRESSOR_xxxKB. Defaults to uWS.DISABLED.

Optional idleTimeout

idleTimeout?: number

Maximum amount of seconds that may pass without sending or getting a message. Connection is closed if this timeout passes. Resolution (granularity) for timeouts are typically 4 seconds, rounded to closest. Disable by using 0. Defaults to 120.

Optional maxBackpressure

maxBackpressure?: number

Maximum length of allowed backpressure per socket when publishing or sending messages. Slow receivers with too high backpressure will be skipped until they catch up or timeout. Defaults to 1024 * 1024.

Optional maxPayloadLength

maxPayloadLength?: number

Maximum length of received message. If a client tries to send you a message larger than this, the connection is immediately closed. Defaults to 16 * 1024.

Optional sendPingsAutomatically

sendPingsAutomatically?: number

Whether or not we should automatically send pings to uphold a stable connection given whatever idleTimeout.

Methods

Optional close

  • close(ws: WebSocket, code: number, message: ArrayBuffer): void
  • Handler for close event, no matter if error, timeout or graceful close. You may not use WebSocket after this event. Do not send on this WebSocket from within here, it is closed.

    Parameters

    • ws: WebSocket
    • code: number
    • message: ArrayBuffer

    Returns void

Optional drain

  • Handler for when WebSocket backpressure drains. Check ws.getBufferedAmount(). Use this to guide / drive your backpressure throttling.

    Parameters

    Returns void

Optional message

  • message(ws: WebSocket, message: ArrayBuffer, isBinary: boolean): void
  • Handler for a WebSocket message. Messages are given as ArrayBuffer no matter if they are binary or not. Given ArrayBuffer is valid during the lifetime of this callback (until first await or return) and will be neutered.

    Parameters

    • ws: WebSocket
    • message: ArrayBuffer
    • isBinary: boolean

    Returns void

Optional open

  • Handler for new WebSocket connection. WebSocket is valid from open to close, no errors.

    Parameters

    Returns void

Optional ping

  • ping(ws: WebSocket, message: ArrayBuffer): void
  • Handler for received ping control message. You do not need to handle this, pong messages are automatically sent as per the standard.

    Parameters

    Returns void

Optional pong

  • pong(ws: WebSocket, message: ArrayBuffer): void
  • Handler for received pong control message.

    Parameters

    Returns void

Optional upgrade

Generated using TypeDoc