Skip to main content

Interface: SubscribableArray<T>

Defined in: src/sdk/sub/SubscribableArray.ts:25

An array which allows others to subscribe to be notified of changes in its state.

Extended by​

Type Parameters​

Type Parameter
T

Properties​

length​

readonly length: number

Defined in: src/sdk/sub/SubscribableArray.ts:27

The length of this array.

Methods​

get()​

get(index): T

Defined in: src/sdk/sub/SubscribableArray.ts:35

Retrieves an element from this array.

Parameters​

ParameterTypeDescription
indexnumberThe index of the element.

Returns​

T

the element at the specified index.

Throws​

Error if index is out of bounds.


getArray()​

getArray(): readonly T[]

Defined in: src/sdk/sub/SubscribableArray.ts:48

Gets a read-only version of this array.

Returns​

readonly T[]

a read-only version of this array.


sub()​

sub(handler, initialNotify?, paused?): Subscription

Defined in: src/sdk/sub/SubscribableArray.ts:58

Subscribes to changes in this array's state.

Parameters​

ParameterTypeDescription
handlerSubscribableArrayHandler<T>A function which is called when this array's state changes.
initialNotify?booleanWhether to immediately invoke the callback function with this array's current state. Defaults to false. This argument is ignored if the subscription is initialized as paused.
paused?booleanWhether the new subscription should be initialized as paused. Defaults to false.

Returns​

Subscription

The new subscription.


tryGet()​

tryGet(index): undefined | T

Defined in: src/sdk/sub/SubscribableArray.ts:42

Attempts to retrieve an element from this array.

Parameters​

ParameterTypeDescription
indexnumberThe index of the element.

Returns​

undefined | T

the element at the specified index, or undefined if index is out of bounds.


unsub()​

unsub(handler): void

Defined in: src/sdk/sub/SubscribableArray.ts:66

Unsubscribes a callback function from this array.

Parameters​

ParameterTypeDescription
handlerSubscribableArrayHandler<T>The function to unsubscribe.

Returns​

void

Deprecated​

This method has been deprecated in favor of using the Subscription object returned by .sub() to manage subscriptions.