npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@dzek69/idb-kv

v2.1.1-ts.2

Published

A tiny key value API for indexeddb with automatic batching for out of the box performance.

Downloads

8

Readme

FORK AHEAD

This is temporary fork of idb-kv.

It adds TypeScript typings. It's meant to be used for test purposes until the original package is updated. You probably should use the original package instead.

Idb-kv

Node.js CI standard badge npm

IndexedDB Key Value Store

A tiny and simple API for IndexedDB with automatic batching for out of the box performance.

All operations called within a 10ms interval are queued and executed in a single batch transaction. This improves performance when lots of reads and/or writes are performed quickly.

Goals

  • Simple and small API
  • Minimize bundle size
  • Good performance
  • Fully tested

Usage

Install

$ npm install idb-kv

Require

let Idbkv = require('idb-kv')

let store = new Idbkv('example-store')

store.set('animals', ['dog', 'cat', 'koala', 'moose', 'chinchilla'])
store.set('pastas', ['spaghetti', 'linguine', 'macaroni', 'fettuccine'])
const animals = await store.get('animals')
animals[2] // >> 'koala'
// new Session
let Idbkv = require('idb-kv')

let store = new Idbkv('example-store') // using the same name loads previous data

const pastas = await store.get('pastas')
pastas[1] // >> "linguine"

Batching

Because actions are batched, you only have to listen to a single promise for every set or delete in a synchronous block of code because they all share a common promise that indicates the success or failure of the entire batch transaction.

This may provide a performance benefit with a large number of writes by eliminating promise handler overhead.

store.set(0, 'first')
store.set(1, 'second')
store.set(2, 'third')
store.set(3, 'fourth')
store.delete(3)
  .then(() => console.log('all 4 sets and delete completed successfully'))

The order of actions is maintained when batching.

store.delete(0)
store.get(0) // resolves with >> undefined
store.set(0, 'first')
store.get(0) // resolves with >> "first"

API

new Idbkv(dbName, [{batchInterval: 10}])

let store = new Idbkv('example-store')

// this store will gather actions for 1000ms before executing a transaction
let slowStore = new Idbkv('slow-store', {batchInterval: 1000})

Create a new Idbkv store instance using indexedDB.open(dbName) for data. Two instances created with the same name will use the same data store.

batchInterval is the number of milliseconds to wait for more actions before a batch transaction is performed. The default is 10ms. Higher values improve batching, but also increase the delay for actions to complete including get().

async get(key)

Read a value from the store

store.get('animals') // resolves with >> ['dog', 'cat', 'koala', 'moose', 'chinchilla']
store.get('nonexistent') // resolves with >> undefined

Returns a promise that resolves with the value corresponding to key, or rejects due to errors thrown by IndexedDB.

If the key doesn't exist in the database, then get() resolves with undefined.

async set(key, value)

Write a value to the store

store.set('pastas', ['spaghetti', 'linguine', 'macaroni', 'fettuccine'])
const pastas = await store.get('pastas')
pastas[1] // >> "linguine"

Returns a promise that resolves when the data is successfully written to the disk, or rejects on IndexedDB errors.

async delete(key)

Remove a value from the store

let store = new Idbkv('example-store')
store.set('pastas', ['spaghetti', 'linguine', 'macaroni', 'fettuccine'])
store.delete('pastas')
store.get('pastas') // resolves with >> undefined

Returns a promise that resolves when the data is successfully deleted from the disk or rejects on indexedDB errors.

async destroy()

Delete the database, and tear down the Idbkv instance

let store = new Idbkv('example-store')
store.get('color') // resolves with >> "blue"
await store.destroy()

store = new Idbkv('example-store')
store.get('color') // resolves with >> undefined

Closes and then deletes the underlying IndexedDB database. This is basically equivalent to calling store.delete() on every existing key in the store.

Returns a promise that resolves when the database is successfully deleted or rejects on an error.