Skip to main content

Interface: WriteTransaction

WriteTransactions are used with mutators which are registered using ReplicacheOptions.mutators and allows read and write operations on the database.

Hierarchy#

Properties#

clientID#

Readonly clientID: string

Inherited from#

ReadTransaction.clientID

Methods#

del#

del(key): Promise<boolean>

Removes a key and its value from the database. Returns true if there was a key to remove.

Parameters#

NameType
keystring

Returns#

Promise<boolean>


get#

get(key): Promise<undefined | JSONValue>

Overrides ReadTransaction.get to return a mutable JSONValue.

Parameters#

NameType
keystring

Returns#

Promise<undefined | JSONValue>

Overrides#

ReadTransaction.get


has#

has(key): Promise<boolean>

Determines if a single key is present in the database.

Parameters#

NameType
keystring

Returns#

Promise<boolean>

Inherited from#

ReadTransaction.has


isEmpty#

isEmpty(): Promise<boolean>

Whether the database is empty.

Returns#

Promise<boolean>

Inherited from#

ReadTransaction.isEmpty


put#

put(key, value): Promise<void>

Sets a single value in the database. The value will be encoded using JSON.stringify.

Parameters#

NameType
keystring
valueJSONValue

Returns#

Promise<void>


scan#

scan(): ScanResult<string, JSONValue>

Overrides ReadTransaction.scan to return a mutable JSONValue.

Returns#

ScanResult<string, JSONValue>

Overrides#

ReadTransaction.scan

scan<Options, Key>(options?): ScanResult<Key, JSONValue>

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
Optionsextends ScanOptions
Keyextends string | [secondary: string, primary: string]

Parameters#

NameType
options?Options

Returns#

ScanResult<Key, JSONValue>

Overrides#

ReadTransaction.scan