Skip to main content
Version: Next

Class: Subscription<T>

Represents an active WebSocket subscription.

This class should not be instantiated directly. It is returned by the subscribe methods on the WebSocketChannel.

Example

const channel = new WebSocketChannel({ nodeUrl: 'YOUR_NODE_URL' });
await channel.waitForConnection();

// The 'sub' object is an instance of the Subscription class.
const sub = await channel.subscribeNewHeads();

sub.on((data) => {
  console.log('Received new head:', data);
});

// ... later
await sub.unsubscribe();

Type parameters​

NameTypeDescription
TanyThe type of data expected from the subscription event.

Constructors​

constructor​

• new Subscription<T>(options): Subscription<T>

Type parameters​

NameType
Tany

Parameters​

NameTypeDescription
optionsSubscriptionOptionsSubscription configuration options

Returns​

Subscription<T>

Defined in​

src/channel/ws/subscription.ts:91

Properties​

channel​

• channel: WebSocketChannel

The containing WebSocketChannel instance.

Defined in​

src/channel/ws/subscription.ts:57

method​

• method: string

The JSON-RPC method used to create this subscription.

Defined in​

src/channel/ws/subscription.ts:63

params​

• params: any

The parameters used to create this subscription.

Defined in​

src/channel/ws/subscription.ts:69

id​

• id: string

The unique identifier for this subscription.

Defined in​

src/channel/ws/subscription.ts:75

events​

• Private events: EventEmitter<SubscriptionEvents<T>>

Defined in​

src/channel/ws/subscription.ts:77

buffer​

• Private buffer: T[] = []

Defined in​

src/channel/ws/subscription.ts:79

maxBufferSize​

• Private maxBufferSize: number

Defined in​

src/channel/ws/subscription.ts:81

handler​

• Private handler: null | (data: T) => void = null

Defined in​

src/channel/ws/subscription.ts:83

_isClosed​

• Private _isClosed: boolean = false

Defined in​

src/channel/ws/subscription.ts:85

Accessors​

isClosed​

• get isClosed(): boolean

Indicates if the subscription has been closed.

Returns​

boolean

true if unsubscribed, false otherwise.

Defined in​

src/channel/ws/subscription.ts:103

Methods​

_handleEvent​

▸ _handleEvent(data): void

Internal method to handle incoming events from the WebSocket channel. If a handler is attached, it's invoked immediately. Otherwise, the event is buffered.

Parameters​

NameTypeDescription
dataTThe event data.

Returns​

void

Defined in​

src/channel/ws/subscription.ts:113

on​

▸ on(handler): void

Attaches a handler function to be called for each event.

When a handler is attached, any buffered events will be passed to it sequentially. Subsequent events will be passed directly as they arrive.

Parameters​

NameTypeDescription
handler(data: T) => voidThe function to call with event data.

Returns​

void

Throws

If a handler is already attached to this subscription.

Defined in​

src/channel/ws/subscription.ts:134

unsubscribe​

▸ unsubscribe(): Promise<boolean>

Sends an unsubscribe request to the node and cleans up local resources.

Returns​

Promise<boolean>

A Promise that resolves to true if the unsubscription was successful.

Defined in​

src/channel/ws/subscription.ts:155