Interface ICache<Type>

max_size

query

Readonly ready

Readonly storeQuery

delete

• delete(key, include_store?): Promise<boolean>

• Parameters

  • key: Key

  • Optional include_store: boolean

    delete key in store

  Returns Promise<boolean>

  deleted_from_map || (include_store && deleted_from_store)

flushToStore

• flushToStore(): Promise<void>

• Insert all items into the store, then clear the cache.

  Returns Promise<void>

get

• get(key, include_store?): Promise<NullableCacheValue<Type>>

• Get value by key.

  Parameters

  • key: Key

  • Optional include_store: boolean

    if key is not found in the cache, then search the store. If found in the store, automatically load it into the cache.

  Returns Promise<NullableCacheValue<Type>>

getMeta

• getMeta(key): Promise<undefined | Metadata>

• Get key metadata. Only works if key has already been stored at some point.

  Parameters

  • key: Key

  Returns Promise<undefined | Metadata>

has

• has(key, include_store?): boolean

• Parameters

  • key: Key

  • Optional include_store: boolean

    if key is not found in the cache, then search the store.

  Returns boolean

loadFromStore

• loadFromStore(): Promise<void>

• Load items from the store, in reverse chronological order, limited by max_size.

  Returns Promise<void>

save

• save(keys): Promise<void>

• Insert items into the store.

  Parameters

  • keys: "all" | Key[]

  Returns Promise<void>

set

• set(key, value): Promise<Key>

• Adds a new element with a specified key and value to the Cache. If an element with the same key already exists, the element will be updated. If the insertion of the element makes the cache larger than max_size, the first pushed element is flushed to store. If a string key is passed, a new Key instance will be generated.

  Parameters

  • key: string | Key

  • value: Type

  Returns Promise<Key>