Skip to main content

Class: ArraySubject<T>

Defined in: src/sdk/sub/ArraySubject.ts:9

An array-like class to observe changes in a list of objects. ArraySubject

Extends​

Type Parameters​

Type Parameter
T

Properties​

initialNotifyFunc()​

protected readonly initialNotifyFunc: (sub) => void

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:20

A function which sends initial notifications to subscriptions.

Notifies a subscription of this array's current state.

Parameters​

ParameterTypeDescription
subHandlerSubscription<SubscribableArrayHandler<T>>The subscription to notify.

Returns​

void

Inherited from​

AbstractSubscribableArray.initialNotifyFunc


notifyDepth​

protected notifyDepth: number = 0

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:17

Inherited from​

AbstractSubscribableArray.notifyDepth


onSubDestroyedFunc()​

protected readonly onSubDestroyedFunc: (sub) => void

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:23

A function which responds to when a subscription to this subscribable is destroyed.

Responds to when a subscription to this array is destroyed.

Parameters​

ParameterTypeDescription
subHandlerSubscription<SubscribableArrayHandler<T>>The destroyed subscription.

Returns​

void

Inherited from​

AbstractSubscribableArray.onSubDestroyedFunc


singletonSub?​

protected optional singletonSub: HandlerSubscription<SubscribableArrayHandler<T>>

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:14

Inherited from​

AbstractSubscribableArray.singletonSub


subs?​

protected optional subs: HandlerSubscription<SubscribableArrayHandler<T>>[]

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:16

Inherited from​

AbstractSubscribableArray.subs

Accessors​

length​

Get Signature​

get length(): number

Defined in: src/sdk/sub/ArraySubject.ts:14

The length of this array.

Returns​

number

The length of this array.

Overrides​

AbstractSubscribableArray.length

Methods​

addSubscription()​

protected addSubscription(sub): void

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:29

Adds a subscription to this array.

Parameters​

ParameterTypeDescription
subHandlerSubscription<SubscribableArrayHandler<T>>The subscription to add.

Returns​

void

Inherited from​

AbstractSubscribableArray.addSubscription


clear()​

clear(): void

Defined in: src/sdk/sub/ArraySubject.ts:101

Clears all data in the array.

Returns​

void


get()​

get(index): T

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:64

Gets an item from the array.

Parameters​

ParameterTypeDescription
indexnumberThex index of the item to get.

Returns​

T

An item.

Throws​

Inherited from​

AbstractSubscribableArray.get


getArray()​

getArray(): readonly T[]

Defined in: src/sdk/sub/ArraySubject.ts:110

Gets the array.

Returns​

readonly T[]

The array.

Overrides​

AbstractSubscribableArray.getArray


initialNotify()​

protected initialNotify(sub): void

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:163

Notifies a subscription of this array's current state.

Parameters​

ParameterTypeDescription
subHandlerSubscription<SubscribableArrayHandler<T>>The subscription to notify.

Returns​

void

Inherited from​

AbstractSubscribableArray.initialNotify


insert()​

insert(item, index?): void

Defined in: src/sdk/sub/ArraySubject.ts:44

Inserts a new item at the end or the specified index.

Parameters​

ParameterTypeDescription
itemTThe item to insert.
index?numberThe optional index to insert the item to. Will add the item at then end if index not given.

Returns​

void


insertRange()​

insertRange(index?, arr?): void

Defined in: src/sdk/sub/ArraySubject.ts:60

Inserts items of an array beginning at the specified index.

Parameters​

ParameterTypeDefault valueDescription
index?number0The index to begin inserting the array items.
arr?readonly T[]undefinedThe array to insert.

Returns​

void


notify()​

protected notify(index, type, modifiedItem?): void

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:87

Notifies subscriptions of a change in the array.

Parameters​

ParameterTypeDescription
indexnumberThe index that was changed.
typeSubscribableArrayEventTypeThe type of subject event.
modifiedItem?T | readonly T[]The item modified by the operation.

Returns​

void

Inherited from​

AbstractSubscribableArray.notify


onSubDestroyed()​

protected onSubDestroyed(sub): void

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:172

Responds to when a subscription to this array is destroyed.

Parameters​

ParameterTypeDescription
subHandlerSubscription<SubscribableArrayHandler<T>>The destroyed subscription.

Returns​

void

Inherited from​

AbstractSubscribableArray.onSubDestroyed


removeAt()​

removeAt(index): void

Defined in: src/sdk/sub/ArraySubject.ts:69

Removes the item at the specified index.

Parameters​

ParameterTypeDescription
indexnumberThe index of the item to remove.

Returns​

void


removeItem()​

removeItem(item): boolean

Defined in: src/sdk/sub/ArraySubject.ts:79

Removes the given item from the array.

Parameters​

ParameterTypeDescription
itemTThe item to remove.

Returns​

boolean

Returns a boolean indicating if the item was found and removed.


set()​

set(arr): void

Defined in: src/sdk/sub/ArraySubject.ts:93

Replaces all items in the array with the new array.

Parameters​

ParameterTypeDescription
arrreadonly T[]The array.

Returns​

void


sub()​

sub(handler, initialNotify, paused): Subscription

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:41

Subscribes to changes in this array's state.

Parameters​

ParameterTypeDefault valueDescription
handlerSubscribableArrayHandler<T>undefinedA function which is called when this array's state changes.
initialNotifybooleanfalseWhether 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.
pausedbooleanfalseWhether the new subscription should be initialized as paused. Defaults to false.

Returns​

Subscription

The new subscription.

Inherited from​

AbstractSubscribableArray.sub


tryGet()​

tryGet(index): T | undefined

Defined in: src/sdk/sub/AbstractSubscribableArray.ts:77

Tries to get the value from the array.

Parameters​

ParameterTypeDescription
indexnumberThe index of the item to get.

Returns​

T | undefined

The value or undefined if not found.

Inherited from​

AbstractSubscribableArray.tryGet


create()​

static create<AT>(arr): ArraySubject<AT>

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

Creates and returns a new observable array.

Type Parameters​

Type ParameterDescription
ATThe type of the array items.

Parameters​

ParameterTypeDefault valueDescription
arrAT[][]The initial array elements.

Returns​

ArraySubject<AT>

A new instance of SubjectArray.

Static​