A simple and lightweight library for managing and interacting with LocalStorage in JavaScript applications.
To use this library, you can install it via npm or yarn:
npm install @gabrielalonsocabral/localstorage-jsor
yarn add @gabrielalonsocabral/localstorage-jsTo use the LocalStorage functionality, import the LocalStorage class from the library:
import { LocalStorage } from '@gabrielalonsocabral/localstorage-js';
// Create an instance of the LocalStorage class
const localStorage = new LocalStorage();
// Set a value in LocalStorage
localStorage.set('myKey', 'myValue', 3600); // Store 'myValue' with key 'myKey' for 3600 seconds (1 hour)
// Get a value from LocalStorage
const value = localStorage.get('myKey');
console.log(value); // Output: 'myValue'
// Check if a key exists in LocalStorage
const exists = localStorage.has('myKey');
console.log(exists); // Output: true
// Delete a value from LocalStorage
localStorage.delete('myKey');
// Push a value to an existing array stored in LocalStorage
localStorage.set('myArray', JSON.stringify([1, 2, 3]), 3600); // Store an array in LocalStorage
localStorage.push('myArray', '4'); // Append '4' to the array
const updatedArray = localStorage.get('myArray');
console.log(updatedArray); // Output: '[1, 2, 3, 4]'Storage key value on LocalStorage.
key: Identifier key.value: Store value.ttl: Expiration date in seconds.
Returns true if the operation was successful; otherwise, an error is thrown.
Return the localStorage value based on the key.
key: Identifier key.
Returns the key value if it is not expired, otherwise, it returns null.
Verify if the key exists on LocalStorage.
key: Identifier key.
Returns true if the key already exists; otherwise, false.
Delete the key from LocalStorage.
key: Identifier key.
There is no return value.
Append a new item to a localStorage key in case the value is an array.
key: Identifier key.value: Store value.
Returns true if the value was successfully added to the array; otherwise, it returns false.
This project is licensed under the MIT License - see the LICENSE file for details.
Note: This library is designed to work with dayjs for handling time and dates. Make sure to have dayjs installed in your project before using this library.