On September 25th, 2024, we released v2 of the Apps SDK. To learn what’s new and how to upgrade, see Migration FAQ and Migration guide.

ListState

API reference for the ListState type.
This version of the API is a preview. Preview APIs are unstable and may change without warning. You can't release public apps using this API until it's stable.

A list of items that can be read.

Type Parameters

T

Indexable

[n: number]: T

Properties

lengthnumberRead-only
Required

Methods

joinfunction
Required

Parameters

separatorstring
Optional

Returns

string

slicefunction
Required

Parameters

startnumber
Optional
endnumber
Optional

Returns

A list of items that can be read and updated.

lengthnumber
popfunction

Returns

undefined | T

pushfunction

Parameters

itemsT[]
Required

Returns

number

shiftfunction

Returns

undefined | T

splicefunction

Parameters

startnumber
Required
deleteCountnumber
Required
itemsT[]
Required

Returns

A list of items that can be read and updated.

EditableListState<T>

unshiftfunction

Parameters

itemsT[]
Required

Returns

number

For more information, see ListState.

indexOffunction
Required

Parameters

searchElementT
Required
fromIndexnumber
Optional

Returns

number

lastIndexOffunction
Required

Parameters

searchElementT
Required
fromIndexnumber
Optional

Returns

number

everyfunction
Required

Parameters

predicatefunction
Required

Parameters

valueT
Required
indexnumber
Required

Returns

unknown

Returns

boolean

somefunction
Required

Parameters

predicatefunction
Required

Parameters

valueT
Required
indexnumber
Required

Returns

unknown

Returns

boolean

forEachfunction
Required

Parameters

callbackFnfunction
Required

Parameters

valueT
Required
indexnumber
Required

Returns

void

Returns

void

mapfunction
Required

Parameters

callbackFnfunction
Required

Parameters

valueT
Required
indexnumber
Required

Returns

U

Returns

A list of items that can be read and updated.

lengthnumber
popfunction

Returns

undefined | T

pushfunction

Parameters

itemsT[]
Required

Returns

number

shiftfunction

Returns

undefined | T

splicefunction

Parameters

startnumber
Required
deleteCountnumber
Required
itemsT[]
Required

Returns

A list of items that can be read and updated.

EditableListState<T>

unshiftfunction

Parameters

itemsT[]
Required

Returns

number

For more information, see ListState.

filterfunction
Required

Parameters

predicatefunction
Required

Parameters

valueT
Required
indexnumber
Required

Returns

unknown

Returns

T[]

reducefunction
Required

Parameters

callbackFnfunction
Required

Parameters

previousValueU
Required
currentValueT
Required
currentIndexnumber
Required

Returns

U

initialValueU
Required

Returns

U

reduceRightfunction
Required

Parameters

callbackFnfunction
Required

Parameters

previousValueU
Required
currentValueT
Required
currentIndexnumber
Required

Returns

U

initialValueU
Required

Returns

U

findfunction
Required

Parameters

predicatefunction
Required

Parameters

valueundefined | T
Required
indexnumber
Required

Returns

unknown

Returns

undefined | T

flatMapfunction
Required

Parameters

callbackfunction
Required

Parameters

valueT
Required
indexnumber
Required
arrayT[]
Required

Returns

Returns

U[]