sol-idb
TypeScript icon, indicating that this package has built-in type declarations

1.0.5 • Public • Published

sol-idb

IndexDB that is rock solid. Dead simple and clear to use.

Installation:

npm install sol-idb

//Or use your favorite package manager.

Start using right away:

import { SolIdb } from "sol-idb/types-solid";
//OR
// import { SolIdb } from "sol-idb";

let DB_NAME = "db"; //name of database to create

//Array of stores to create while initializing sol-idb
let stores = [
    {
        name: "my_store", // name of store
        keyPath: "id" // unique property of objects 
                      // to be stored
    },
    //...
];    
let my_db = new SolIdb(DB_NAME, stores);

You are free to create more than one database with above method.

With my_db, you are now able to access easy methods to save, get and update objects in my_db database. All methods return Promise.

Available methods:

  • save(storeName, value) : To save the value in the mentioned store. And yes, you can pass callbacks.
let obj = { 
    name: "John Doe",
    id: "MY_UNIQUE_ID"
}
my_db.save("my_store", obj);
//OR 

function callback() {
    //something to do after saving the data.
}
my_db.save("my_store", obj, callback);
  • get(storeName, key) : To get the value from store with provided key. Here, the key is the value of keyPath within object.
let value = my_db.get("my_store", "MY_UNIQUE_ID");
  • getAll(storeName) : To get all the values from the store.
let value = my_db.getAll("my_store");
  • update(storeName, key, new_value, callback) : To update the value for the given key within the provided store. Callback is available here too (as optional parameter).
let newValue = { 
    name: "Next John Doe",
    id: "MY_UNIQUE_ID"
}

//Create Callback if required
function updateCallback () { 
    //something to do/trigger after successfull update.
}

my_db.update("my_store", "MY_UNIQUE_ID", newValue, updateCallback);
  • delete(storeName, key, callback) : To delete the value for the given key within the provided store. Callback is available here too (as optional parameter).
//Create Callback if required
function deleteCallback () { 
    //something to do/trigger after successful delete.
}

my_db.delete("my_store", "MY_UNIQUE_ID", deleteCallback);
  • clearStore(storeName) : To clear the store.
my_db.clearStore("my_store");

Package Sidebar

Install

npm i sol-idb

Weekly Downloads

4

Version

1.0.5

License

MIT

Unpacked Size

15.1 kB

Total Files

8

Last publish

Collaborators

  • anurag-dhamala