Local Storage Handler

Cookies are good options for keeping data for limited time on client side. But what if you have data, which is much bigger than cookies accept? You might still want to have expire date for the data. This small library will help you to achieve this. It will basically set local storage items with a time stamp and retrieve them by checking how many hours ago it was set. You decide by specifying the number of hours. It is useful for applications where you have data, which needs to be refreshed once in a while but you don't need to refresh after each page load and you want to unload your server a little bit.

• The library is written in Typescript, hence, you have built-in type support.

• No additional dependencies.

• The handler basically sets a timestamp for each key. Every time you try to retrieve the key, it will check the timestamp if it key value is set earlier than the cacheHours hours. If not, it will return the string value. If older, it will return null

Install the Library

1npm i @ozntel/local-storage-handler

Import

1import { LocalStorageHandler } from '@ozntel/local-storage-handler';

Usage

1// You can create Handler by passing specified cacheHours
2let lsh = new LocalStorageHandler({ cacheHours: 0.5 });
3
4// or use 24 Hours by default and pass only an empy object
5let lsh = new LocalStorageHandler({});
6
7// You can change the cacheHours later on
8lsh.cacheHours = 12;
9
10// Set a new Local Storage Value
11// It'll return 'success' but you don't need to assign to variable
12let setResp = lsh.setLocalStorage({ key: 'key1', value: 'value1' });
13
14// Get Local Storage Item.
15// It'll return value if the data in local storage isn't older than specified cachedHours
16// or null if key not found or is older than cachedHours
17let val1 = lsh.getFromLocalStorage({ key: 'key1' });
18
19// You can ask for local storage item by ignoring the cacheTime.
20// It'll return value no matter when the local storage key was set
21let val1 = lsh.getFromLocalStorage({ key: 'key1', checkCacheHours: false });
22
23// If you want to check the value by certain cacheTime, you can also pass additionally
24let val1 = lsh.getFromLocalStorage({ key: 'key1', checkCacheHours: false, cacheHours: 5 });
25
26// Finally you can remove the local storage key
27// It'll return 'success' if deleted
28// or 'not-found' if it couldn't find the key.
29// It will also delete the timestamp related to the key from local storage.
30let clearResp = lsh.removeFromLocalStorage({ key: 'key1' });