Interface AsyncStore<ItemType, IDType>

An asynchronous store. This is the preferred kind of store implementation.

interface AsyncStore<ItemType, IDType> {
    get(id, options?): Promise<undefined | ItemType>;
    getIdentity?(item): undefined | IDType;
    getMetadata(): Promise<Metadata>;
    id: undefined | string;
    idProperty?: string;
    on?<Name>(eventName, callback): EventHandle;
    on?(eventName, callback): EventHandle;
    on?(eventName, callback): EventHandle;
    query(query?, options?): AsyncQueryResult<ItemType>;
}

Type Parameters

Hierarchy (view full)

Implemented by

Properties

id idProperty?

Methods

get getIdentity? getMetadata on? query

Properties

Readonly id

id: undefined | string

ID of the store.

Optional Readonly idProperty

idProperty?: string

Name of the property used as ID. If not provided, the 'getIdentity' method must be declared.

Methods

get

  • get(id, options?): Promise<undefined | ItemType>

  • Retrieves an item by its identifier.

    Parameters

    • id: IDType

      id of an item in the store.

    • Optional options: GetOptions

      options to specify the result.

    Returns Promise<undefined | ItemType>

Optional getIdentity

  • getIdentity(item): undefined | IDType

  • Returns an items‘s identity. This must always execute synchronously.

    Parameters

    Returns undefined | IDType

    the ID

getMetadata

  • getMetadata(): Promise<Metadata>

  • Returns any available metadata about the store. This may include attribution, available fields, cache directives, history or version information.

    Returns Promise<Metadata>

Optional on

  • on<Name>(eventName, callback): EventHandle

  • Register event listener for specific events.

    Type Parameters

    • Name extends "changed"

    Parameters

    • eventName: Name

      name of the event

    • callback: EventCallback<StoreEvents<IDType>[Name]>

      the event handler callback will be invoked when the event has been emitted

    Returns EventHandle

    a handle to unregister from the event

  • on(eventName, callback): EventHandle

  • Register event listener for any event.

    Parameters

    • eventName: "*"

      must be "*" for this overload

    • callback: EventCallback<StoreChangedEvent<IDType>>

      the event handler callback will be invoked when any event has been emitted

    Returns EventHandle

    a handle to unregister from the events

  • on(eventName, callback): EventHandle

  • Register event listener for the events listed in eventName. Comma separated event names are possible, for example "eventA,eventB".

    Parameters

    • eventName: string | string[]

      the event name or list of names

    • callback: EventCallback<unknown>

      the event handler callback

    Returns EventHandle

    a handle to unregister from the event(s)

query

Settings

Member Visibility

Theme

On This Page

ididPropertygetgetIdentitygetMetadataonquery

Generated using TypeDoc