Class BaseDatastore

Extending classes should override query or implement this method

Extending classes should override queryKeys or implement this method

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

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')
Copy

Remove the record for the passed key

Example

await store.delete(new Key('awesome'))
console.log('deleted awesome content :(')
Copy

Remove values for the passed keys

Example

const source = [new Key('awesome')]

for await (const key of store.deleteMany(source)) {
  console.log(`deleted content with key ${key}`)
}
Copy

Retrieve the value stored under the given key

Example

const value = await store.get(new Key('awesome'))
console.log('got content: %s', value.toString('utf8'))
// => got content: datastore
Copy

Retrieve values for the passed keys

Example

for await (const { key, value } of store.getMany([new Key('awesome')])) {
  console.log(`got "${key}" = "${new TextDecoder('utf8').decode(value)}"`')
  // => got "/awesome" = "datastore"
}
Copy

Check for the existence of a value for the passed key

Example

const exists = await store.has(new Key('awesome'))

if (exists) {
 console.log('it is there')
} else {
 console.log('it is not there')
}
Copy

Store the passed value under the passed key

Example

await store.put([{ key: new Key('awesome'), value: new Uint8Array([0, 1, 2, 3]) }])
Copy

Store the given key/value pairs

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}`)
}
Copy

Query the datastore.

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)
Copy

Query the datastore.

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)
Copy