local-js

Simple local storage tools.

Installing

npm i local-js

Basic example

    const { setOneWithTTL, getOneWithTTL } = require('local-js');
   
    const key = 'your_key'; 
    const data = [ 'your', 'data' ];
    const ttl = 3000;
   
    setOneWithTTL(key, data, ttl); // Sets data with an expiry time

    const item = getOneWithTTL(key);
    console.log(item) // [ 'your', 'data '];

Documentation

setOne(key, data)

Info: Sets a single item into localStorage, accepts nested structures.

    const { setOne } = require('local-js');
    
    const key = 'your_key'; 
    const data = [ 'your', 'data' ];
    
    setOne(key, data);

getOne(key)

Info: Gets a single item from localStorage, return null if item does not exist.

    const { getOne } = require('local-js');
    
    const key = 'your_key'; 
    
    getOne(key); // Returns data if key exists, null if it doesnt.

setOneWithTTL(key, data, ttl)

Info: Sets a single item into localStorage with an expiry time(ttl), accepts nested structures.

    const { setOneWithTTL } = require('local-js');
    
    const key = 'your_key'; 
    const data = [ 'your', 'data' ];
    const ttl = 3000;
    
    setOneWithTTL(key, data, ttl);

getOneWithTTL(key)

Info: Get a single item with an expiry time, if the token is expired it will be removed and return null.

    const { getOneWithTTL } = require('local-js');
    
    const key = 'your_key'; 
    
    getOneWithTTL(key); // Return data if key exists and isnt expired, else return null

setMany(array)

Info: Sets many items into localStorage, array of objects containing the keys, key and value.

    const { setMany } = require('local-js');

    const array = [
                    { key: 'first_key', value: 'first_value' }, 
                    { key: 'second_key', value: [ 'second', 'value' ]},
                    ...
                  ];

    setMany(array);

getMany(array)

Info: Gets many items from localStorage.

    const { getMany } = require('local-js');
    
    const array = [ 'first_key', 'second_key', ...];
    
    getMany(array); // [ 'first_value', [ 'second', 'value' ], ...];

setManyWithTTL(array)

Info: Sets many items into localStorage with ttl, array of objects containing the keys, key, value, ttl.

    const { setManyWithTTL } = require('local-js');

    const array = [
                    { key: 'first_key', value: 'first_value', ttl: 1000 }, 
                    { key: 'second_key', value: [ 'second', 'value' ], ttl: 2000 },
                    ...
                  ];

    setManyWithTTL(array);

getManyWithTTL(array)

Info: Gets many items into localStorage with ttl, if the item is expired or does not exist it will be returned as null.

    const { getManyWithTTL } = require('local-js');

    const array = [ 'first_key', 'second_key', ...];

    getManyWithTTL(array); // [ 'first_value', [ 'second', 'value' ], ...];

deleteOne(key)

Info: Removes a single item from localStorage.

    const { deleteOne } = require('local-js');

    const key = 'my_key';
    deleteOne(key);

deleteAll()

Info: Clears all data from localStorage.

    const { deleteAll } = require('local-js');

    deleteAll();

pruneExpired()

Info: Clears all keys with TTL that have expired.

    const { pruneExpired } = require('local-js');

    pruneExpired();

getAll()

Info: Get all items from local storage.

    const { getAll } = require('local-js');

    getAll(); // [ { key: 'your_key', data: [ 'your', 'data' ] }, ...];