Skip to main content

Interface: ReadTransaction#

ReadTransactions are used with Replicache.query and Replicache.subscribe and allows read operations on the database.

Hierarchy#

Implemented by#

Methods#

get#

get(key: string): Promise<undefined | JSONValue>

Get a single value from the database. If the key is not present this returns undefined.

Parameters:#

NameType
keystring

Returns: Promise<undefined | JSONValue>

Defined in: transactions.ts:23


has#

has(key: string): Promise<boolean>

Determines if a single key is present in the database.

Parameters:#

NameType
keystring

Returns: Promise<boolean>

Defined in: transactions.ts:26


isEmpty#

isEmpty(): Promise<boolean>

Whether the database is empty.

Returns: Promise<boolean>

Defined in: transactions.ts:29


scan#

scan<O, K>(options?: O): ScanResult<K>

Gets many values from the database. This returns a ScanResult which implements AsyncIterable. It also has methods to iterate over the keys and entries.

If options has an indexName, then this does a scan over an index with that name. A scan over an index uses a tuple for the key consisting of [secondary: string, primary: string].

If the ScanResult is used after the ReadTransaction has been closed it will throw a TransactionClosedError.

Type parameters:#

NameType
OScanOptions
KScanOptionIndexedStartKey

Parameters:#

NameType
options?O

Returns: ScanResult<K>

Defined in: transactions.ts:43


scanAll#

scanAll<O, K>(options?: O): Promise<[K, JSONValue][]>

Convenience form of scan which returns all the entries as an array.

deprecated Use scan().entries().toArray() instead

Type parameters:#

NameType
OScanOptions
KScanOptionIndexedStartKey

Parameters:#

NameType
options?O

Returns: Promise<[K, JSONValue][]>

Defined in: transactions.ts:51