Rumblejs NPM | npm.io

RumbleJS

Reactive Storage wrapped around either localStorage or sessionStorage, in the browser. you chooose which engine fits your needs.

It works like this:

import SetupStorage from "rumblejs";

const rls = SetupStorage(localStorage);

const readSubscriber = rls.onRead("user", (event) => {
    console.log("User readed", event.value);
});

const writeSubscriber = rls.onWrite("user", (event) => {
    console.log(event.previous, event.value);
});

const removeSubscriber = rls.onRemove("user", (event) => {
    console.log("User removed. Need to signin again");
});

const clearSubscriber = rls.onClear(() => {
    console.log("Storage has been cleared");
});

rls.setItem("user", "Paul Logan");
rls.getItem("user");
rls.removeItem("user");

readSubscriber.cancel();
writeSubscriber.cancel();
removeSubscriber.cancel();
clearSubscriber.cancel();
/// same for other subscribers

How it works:

RumbleJS encapsulates either localStorage or sessionStorage to provide the same functionality as localStorage or sessionStorage, but is able to react to changes applied to the keys stored by it, on demand. Events are passed through the sender associated with the document, to allow function calls without latency or promise.

Available functions and attributes

readonly length: number

Returns the total number of keys available in the storage

clear(): void

Clears the storage, and triggers the clear event. Interceptable with onClear.

getItem(key: string): string | null

Returns the current value associated with the given key, or null if the given key does not exist

getString(key: string): string | null

Returns the current value associated with the given key, or null if the given key does not exist

getObject(key: string): any | null

Returns the current value associated with the given key with automatic conversion to Javascript Object with JSON.parse, or null if the given key does not exist

getNumber(key: string): number | null

Returns the current value associated with the given key with automatic parsing to number with parseFloat, or null if the given key does not exist

getBoolean(key: string): boolean

Returns the current value associated with the given key with automatic parsing to boolean by checking if the value is equal to true or 1, or false if the given key does not exist