Class DataStore

Readonly[kMaybeHaveEventListener]

Readonlymutex

[asyncDispose]

• [asyncDispose](): Promise<void>

• Close the store.

  Returns Promise<void>

clearExpired

• clearExpired(): Promise<void>

• Delete all expired records.

  Returns Promise<void>

delete

• delete(...names): Promise<void>

• Delete Data packets with given names.

  Parameters

  • Rest...names: readonly Name[]

  Returns Promise<void>

  See

  Transaction.delete

find

• find(interest): Promise<undefined | Data>

• Find Data that satisfies Interest.

  Parameters

  • interest: Interest

  Returns Promise<undefined | Data>

get

• get(name): Promise<undefined | Data>

• Retrieve Data by exact name.

  Parameters

  • name: Name

  Returns Promise<undefined | Data>

insert

• insert(...args): Promise<void>

• Insert one or more Data packets.

  Parameters

  • Rest...args: (Data | AnyIterable<Data>)[] | [InsertOptions, ...(Data | AnyIterable<Data>)[]]

  Returns Promise<void>

  See

  Transaction.insert

listData

• listData(prefix?): AsyncIterable<Data, any, any>

• List Data packets, optionally filtered by name prefix.

  Parameters

  • Optionalprefix: Name

  Returns AsyncIterable<Data, any, any>

listNames

• listNames(prefix?): AsyncIterable<Name, any, any>

• List Data names, optionally filtered by name prefix.

  Parameters

  • Optionalprefix: Name

  Returns AsyncIterable<Name, any, any>

tx

• tx(): Transaction

• Start an update transaction.

  Returns Transaction

Staticcreate

• create(open): Promise<DataStore>

• Create DataStore from an abstract-level opener function.

  Parameters

  • open: DbOpener

    Function that opens an abstract-level compatible key-value database with the given options.

  Returns Promise<DataStore>
• create<const A, const O>(ctor, ...args): Promise<DataStore>

• Create DataStore from an abstract-level subclass constructor.

  Type Parameters

  • const A extends unknown[]
  • const O extends {}

  Parameters

  • ctor: DbCtor<A, O>

    Subclass of abstract-level that accepts options as its last parameter.
  • Rest...args: [...A[], O]

    ctor arguments; last should be options object.

  Returns Promise<DataStore>