interface OptionalWebSocketManagerOptions

external
interface OptionalWebSocketManagerOptions

Optional additional configuration for the WebSocketManager

external
compression : CompressionMethod | null = null (no transport compression)

The transport compression method to use - mutually exclusive with useIdentifyCompression

external
encoding : Encoding = 'json'

The encoding to use

external
handshakeTimeout : number | null

How long to wait for a shard to connect before giving up

external
helloTimeout : number | null

How long to wait for a shard's HELLO packet before giving up

external
identifyProperties : GatewayIdentifyProperties

Properties to send to the gateway when identifying

external
initialPresence : GatewayPresenceUpdateData | null

Initial presence data to send to the gateway when identifying

external
largeThreshold : number | null

Value between 50 and 250, total number of members where the gateway will stop sending offline members in the guild member list

external
readyTimeout : number | null

How long to wait for a shard's READY packet before giving up

deprecatedoptionalexternal
rest? : REST

The REST instance to use for fetching gateway information

external
shardCount : number | null

The total number of shards across all WebsocketManagers you intend to instantiate. Use null to use Discord's recommended shard count

external
shardIds : number[] | ShardRange | null

The ids of the shards this WebSocketManager should manage. Use null to simply spawn 0 through shardCount - 1

external
token : string

The token to use for identifying with the gatewayIf not provided, the token must be set using setToken

external
useIdentifyCompression : boolean = false

Whether to use the compress option when identifying

external
version : string = '10'

The gateway version to use

external
buildIdentifyThrottler(
manager: WebSocketManager
) : Awaitable<IIdentifyThrottler>

Builds an identify throttler to use for this manager's shards

external
buildStrategy(
manager: WebSocketManager
) : IShardingStrategy

Builds the strategy to use for sharding

Examples:
const manager = new WebSocketManager({
 token: process.env.DISCORD_TOKEN,
 intents: 0, // for no intents
 rest,
 buildStrategy: (manager) => new WorkerShardingStrategy(manager, { shardsPerWorker: 2 }),
});

external
fetchGatewayInformation() : Awaitable<RESTGetAPIGatewayBotResult>

Fetches the initial gateway URL used to connect to Discord. When missing, this will default to the gateway URL that Discord returns from the /gateway/bot route.

Examples:
const manager = new WebSocketManager({
 token: process.env.DISCORD_TOKEN,
 fetchGatewayInformation() {
   return rest.get(Routes.gatewayBot());
 },
})

external
retrieveSessionInfo(
shardId: number
) : Awaitable<SessionInfo | null>

Function used to retrieve session information (and attempt to resume) for a given shard

Examples:
const manager = new WebSocketManager({
  async retrieveSessionInfo(shardId): Awaitable<SessionInfo | null> {
    // Fetch this info from redis or similar
    return { sessionId: string, sequence: number };
    // Return null if no information is found
  },
});

external
updateSessionInfo(
shardId: number
sessionInfo: SessionInfo | null
) : Awaitable<void>

Function used to store session information for a given shard