1.0.6 • Published 8 months ago

@david-fernando/nodelocalstorage v1.0.6

Weekly downloads
-
License
ISC
Repository
github
Last release
8 months ago

NodeStorage

A simple Node.js library for local storage without external dependencies, similarly to the localStorage of the browsers.

📦 Installation

To install, use one of the following commands

npm install @david-fernando/nodelocalstorage
or
yarn add @david-fernando/nodelocalstorage

🚀 Usage

Importing the Module

Since this library uses ES Modules, import it as follows:

import localStorage from '@david-fernando/nodelocalstorage';

Available Methods

  • getItem(key) - Retrieves the value associated with the specified key.
  • setItem(key, value) - Stores a value under the specified key.
  • removeItem(key) - Deletes the specified key and its value.
  • key(index) - Retrieves the value stored under the key located at the specified index.
  • clear() - Deletes all keys and removes the JSON file.
  • print() - Logs all items to the console.
  • length (Property) - Returns the number of stored items.

Example Usage

import localStorage from '@david-fernando/nodelocalstorage';

const { setItem, getItem, removeItem, key, clear, print } = localStorage();

// Setting items
setItem('username', 'David');
setItem('age', 28);

// Retrieving items
console.log(getItem('username')); // Output: David

// Print all items
print(); // Output: { username: 'David', age: 28 }

// Checking length
console.log(localStorage().length); // Output: 2

// Removing an item
removeItem('age');

// Getting keys by index
console.log(key(0)); // Output: David

// Clearing all data
clear();

📁 How Data is Stored

Data is saved in a file called localStorage.json in the root directory of this library

🔒 Note

This library only works in Node.js environments, as it uses the fs module.

📜 License

This project is licensed under the MIT License.