La referencia de la API está disponible solo en inglés por ahora.

EntityAdapter<T, Id extends EntityId = string>

interface
entity/entityAdapter.ts:71

Reducer helpers, selectors, and the subscription paths that make the shape worth having.

Type parameters

NameTypeDescription
T
Idextends EntityId

Properties

NameTypeDescription
idsPathstringPath to the order array. Subscribe here for a list that reorders.

Methods

addMany

signature
addMany<S>(state, entities): S

Type parameters

NameTypeDescription
Sextends EntityState<T, Id>

Parameters

NameTypeDescription
stateS
NameTypeDescription
entitiesreadonly T[]

Returns

S

addOne

Adds an entity. Existing ids are left alone — this is not an upsert.

signature
addOne<S>(state, entity): S

Adds an entity. Existing ids are left alone — this is not an upsert.

Type parameters

NameTypeDescription
Sextends EntityState<T, Id>

Parameters

NameTypeDescription
stateS
NameTypeDescription
entityT

Returns

S

anyField

Wildcard across every entity's field, for the loose subscription registry.

signature
anyField(field): string

Wildcard across every entity's field, for the loose subscription registry.

Parameters

NameTypeDescription
fieldstring

Returns

string

getInitialState

Overload 1

signature
getInitialState(): EntityState<T, Id>

Returns

EntityState<T, Id>

Overload 2

signature
getInitialState<Extra>(extra): EntityState<T, Id> & Extra

Type parameters

NameTypeDescription
Extraextends object

Parameters

NameTypeDescription
extraExtra

Returns

EntityState<T, Id> & Extra

pathTo

Path to one entity, or to a field of it.

signature
pathTo(id, field?): string

Path to one entity, or to a field of it.

Parameters

NameTypeDescription
idId
NameTypeDescription
field?string

Returns

string

removeAll

signature
removeAll<S>(state): S

Type parameters

NameTypeDescription
Sextends EntityState<T, Id>

Parameters

NameTypeDescription
stateS

Returns

S

removeMany

signature
removeMany<S>(state, ids): S

Type parameters

NameTypeDescription
Sextends EntityState<T, Id>

Parameters

NameTypeDescription
stateS
NameTypeDescription
idsreadonly Id[]

Returns

S

removeOne

signature
removeOne<S>(state, id): S

Type parameters

NameTypeDescription
Sextends EntityState<T, Id>

Parameters

NameTypeDescription
stateS
NameTypeDescription
idId

Returns

S

selectAll

signature
selectAll(state): readonly T[]

Parameters

NameTypeDescription
stateEntityState<T, Id>

Returns

readonly T[]

selectById

signature
selectById(state, id): undefined | T

Parameters

NameTypeDescription
stateEntityState<T, Id>
NameTypeDescription
idId

Returns

undefined | T

selectEntities

signature
selectEntities(state): Readonly<Record<Id, T>>

Parameters

NameTypeDescription
stateEntityState<T, Id>

Returns

Readonly<Record<Id, T>>

selectIds

signature
selectIds(state): readonly Id[]

Parameters

NameTypeDescription
stateEntityState<T, Id>

Returns

readonly Id[]

selectTotal

signature
selectTotal(state): number

Parameters

NameTypeDescription
stateEntityState<T, Id>

Returns

number

setAll

Replaces the whole collection.

signature
setAll<S>(state, entities): S

Replaces the whole collection.

Type parameters

NameTypeDescription
Sextends EntityState<T, Id>

Parameters

NameTypeDescription
stateS
NameTypeDescription
entitiesreadonly T[]

Returns

S

setMany

signature
setMany<S>(state, entities): S

Type parameters

NameTypeDescription
Sextends EntityState<T, Id>

Parameters

NameTypeDescription
stateS
NameTypeDescription
entitiesreadonly T[]

Returns

S

setOne

Adds or replaces one entity wholesale.

signature
setOne<S>(state, entity): S

Adds or replaces one entity wholesale.

Type parameters

NameTypeDescription
Sextends EntityState<T, Id>

Parameters

NameTypeDescription
stateS
NameTypeDescription
entityT

Returns

S

updateMany

signature
updateMany<S>(state, updates): S

Type parameters

NameTypeDescription
Sextends EntityState<T, Id>

Parameters

NameTypeDescription
stateS
NameTypeDescription
updatesreadonly EntityUpdate<T, Id>[]

Returns

S

updateOne

Merges changes into one entity. Unknown ids are ignored.

signature
updateOne<S>(state, update): S

Merges changes into one entity. Unknown ids are ignored.

Type parameters

NameTypeDescription
Sextends EntityState<T, Id>

Parameters

NameTypeDescription
stateS
NameTypeDescription
updateEntityUpdate<T, Id>

Returns

S

upsertMany

signature
upsertMany<S>(state, entities): S

Type parameters

NameTypeDescription
Sextends EntityState<T, Id>

Parameters

NameTypeDescription
stateS
NameTypeDescription
entitiesreadonly T[]

Returns

S

upsertOne

Adds, or merges into an existing entity.

signature
upsertOne<S>(state, entity): S

Adds, or merges into an existing entity.

Type parameters

NameTypeDescription
Sextends EntityState<T, Id>

Parameters

NameTypeDescription
stateS
NameTypeDescription
entityT

Returns

S