Class IDBDatastore

Hierarchy (View Summary)

BaseDatastore
- IDBDatastore

Index

Constructors

constructor

Methods

_all _allKeys batch close delete deleteMany destroy get getMany has open put putMany query queryKeys

Constructors

constructor

new IDBDatastore(location: string, init?: IDBDatastoreInit): IDBDatastore
Parameters
- location: string
- init: IDBDatastoreInit = {}
Returns IDBDatastore
Overrides BaseDatastore.constructor
- Defined in datastore-idb/src/index.ts:43

Methods

_all

_all(q: Query, options?: AbortOptions): AwaitIterable<Pair>
Extending classes should override query or implement this method
Parameters
- q: Query
- Optionaloptions: AbortOptions
Returns AwaitIterable<Pair>
Inherited from BaseDatastore._all
- Defined in datastore-core/dist/src/base.d.ts:15

_allKeys

_allKeys(q: KeyQuery, options?: AbortOptions): AwaitIterable<Key>
Extending classes should override queryKeys or implement this method
Parameters
- q: KeyQuery
- Optionaloptions: AbortOptions
Returns AwaitIterable<Key>
Inherited from BaseDatastore._allKeys
- Defined in datastore-core/dist/src/base.d.ts:19

batch

batch(): Batch
This will return an object with which you can chain multiple operations together, with them only being executed on calling commit.

Returns Batch
Example
```
const b = store.batch()

for (let i = 0; i < 100; i++) {
  b.put(new Key(`hello${i}`), new TextEncoder('utf8').encode(`hello world ${i}`))
}

await b.commit()
console.log('put 100 values')
```
Overrides BaseDatastore.batch
- Defined in datastore-idb/src/index.ts:131

close

close(): Promise<void>
Returns Promise<void>
- Defined in datastore-idb/src/index.ts:64

delete

delete(key: Key, options?: AbortOptions): Promise<void>
Remove the record for the passed key
Parameters
- key: Key
- Optionaloptions: AbortOptions
Returns Promise<void>
Example
```
await store.delete(new Key('awesome'))
console.log('deleted awesome content :(')
```
Overrides BaseDatastore.delete
- Defined in datastore-idb/src/index.ts:118

deleteMany

deleteMany(
source: AwaitIterable<Key>,
options?: AbortOptions,
): AwaitIterable<Key>
Remove values for the passed keys
Parameters
- source: AwaitIterable<Key>
- Optionaloptions: AbortOptions
Returns AwaitIterable<Key>
Example
```
const source = [new Key('awesome')]

for await (const key of store.deleteMany(source)) {
  console.log(`deleted content with key ${key}`)
}
```
Inherited from BaseDatastore.deleteMany
- Defined in datastore-core/dist/src/base.d.ts:10

destroy

destroy(): Promise<void>
Returns Promise<void>
- Defined in datastore-idb/src/index.ts:259

get

get(key: Key, options?: AbortOptions): Promise<Uint8Array<ArrayBufferLike>>
Retrieve the value stored under the given key
Parameters
- key: Key
- Optionaloptions: AbortOptions
Returns Promise<Uint8Array<ArrayBufferLike>>
Example
```
const value = await store.get(new Key('awesome'))
console.log('got content: %s', value.toString('utf8'))
// => got content: datastore
```
Overrides BaseDatastore.get
- Defined in datastore-idb/src/index.ts:83

getMany

getMany(source: AwaitIterable<Key>, options?: AbortOptions): AwaitIterable<Pair>
Retrieve values for the passed keys
Parameters
- source: AwaitIterable<Key>
- Optionaloptions: AbortOptions
Returns AwaitIterable<Pair>
Example
```
for await (const { key, value } of store.getMany([new Key('awesome')])) {
  console.log(`got "${key}" = "${new TextDecoder('utf8').decode(value)}"`')
  // => got "/awesome" = "datastore"
}
```
Inherited from BaseDatastore.getMany
- Defined in datastore-core/dist/src/base.d.ts:9

has

has(key: Key, options?: AbortOptions): Promise<boolean>
Check for the existence of a value for the passed key
Parameters
- key: Key
- Optionaloptions: AbortOptions
Returns Promise<boolean>
Example
```
const exists = await store.has(new Key('awesome'))

if (exists) {
 console.log('it is there')
} else {
 console.log('it is not there')
}
```
Overrides BaseDatastore.has
- Defined in datastore-idb/src/index.ts:104

open

open(): Promise<void>
Returns Promise<void>
- Defined in datastore-idb/src/index.ts:50

put

put(key: Key, val: Uint8Array, options?: AbortOptions): Promise<Key>
Store the passed value under the passed key
Parameters
- key: Key
- val: Uint8Array
- Optionaloptions: AbortOptions
Returns Promise<Key>
Example
```
await store.put([{ key: new Key('awesome'), value: new Uint8Array([0, 1, 2, 3]) }])
```
Overrides BaseDatastore.put
- Defined in datastore-idb/src/index.ts:68

putMany

putMany(source: AwaitIterable<Pair>, options?: AbortOptions): AwaitIterable<Key>
Store the given key/value pairs
Parameters
- source: AwaitIterable<Pair>
- Optionaloptions: AbortOptions
Returns AwaitIterable<Key>
Example
```
const source = [{ key: new Key('awesome'), value: new Uint8Array([0, 1, 2, 3]) }]

for await (const { key, value } of store.putMany(source)) {
  console.info(`put content for key ${key}`)
}
```
Inherited from BaseDatastore.putMany
- Defined in datastore-core/dist/src/base.d.ts:8

query

query(q: Query, options?: AbortOptions): AsyncIterable<Pair>
Query the datastore.
Parameters
- q: Query
- Optionaloptions: AbortOptions
Returns AsyncIterable<Pair>
Example
```
// retrieve __all__ key/value pairs from the store
let list = []
for await (const { key, value } of store.query({})) {
  list.push(value)
}
console.log('ALL THE VALUES', list)
```
Overrides BaseDatastore.query
- Defined in datastore-idb/src/index.ts:179

queryKeys

queryKeys(q: KeyQuery, options?: AbortOptions): AsyncIterable<Key>
Query the datastore.
Parameters
- q: KeyQuery
- Optionaloptions: AbortOptions
Returns AsyncIterable<Key>
Example
```
// retrieve __all__ keys from the store
let list = []
for await (const key of store.queryKeys({})) {
  list.push(key)
}
console.log('ALL THE KEYS', key)
```
Overrides BaseDatastore.queryKeys
- Defined in datastore-idb/src/index.ts:195

Class IDBDatastore

Hierarchy (View Summary)

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns IDBDatastore

Methods

_all

Parameters

Returns AwaitIterable<Pair>

_allKeys

Parameters

Returns AwaitIterable<Key>

batch

Returns Batch

Example

close

Returns Promise<void>

delete

Parameters

Returns Promise<void>

Example

deleteMany

Parameters

Returns AwaitIterable<Key>

Example

destroy

Returns Promise<void>

get

Parameters

Returns Promise<Uint8Array<ArrayBufferLike>>

Example

getMany

Parameters

Returns AwaitIterable<Pair>

Example

has

Parameters

Returns Promise<boolean>

Example

open

Returns Promise<void>

put

Parameters

Returns Promise<Key>

Example

putMany

Parameters

Returns AwaitIterable<Key>

Example

query

Parameters

Returns AsyncIterable<Pair>

Example

queryKeys

Parameters

Returns AsyncIterable<Key>

Example

Settings

On This Page