npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@bjnstnkvc/local-storage

v1.1.0

Published

Simple wrapper for JavaScript Local Storage API.

Downloads

22

Readme

LocalStorage

A class that provides a set of methods for interacting with the browser's local storage.

Installation & setup

NPM

You can install the package via npm:

npm install @bjnstnkvc/local-storage

and then import it into your project

import { LocalStorage } from '@bjnstnkvc/local-storage';

CDN

You can install the package via jsDelivr CDN:

<script src="https://cdn.jsdelivr.net/npm/@bjnstnkvc/local-storage/lib/main.min.js"></script>

Usage

set

Set the value for a given key in the Local Storage.

Parameters

  • key - String containing the name of the key.
  • value - The value to be stored.
  • ttl (optional) - Time to live in seconds for the key. Defaults to null (no expiration) or equal to LocalStorage.ttl value.

Example

LocalStorage.set('key', 'value', 60); 

get

Retrieve the value associated with the given key from the Local Storage.

Parameters

  • key - String containing the name of the key.
  • fallback (optional) - The fallback value in case the key does not exist. Defaults to null.

Example

LocalStorage.get('key', 'default');

You can also pass a closure as the default value. If the specified item is not found in the Local Storage, the closure will be executed and its result returned. This allows you to lazily load default values from other sources:

LocalStorage.get('key', () => 'default');

Note: When you attempt to retrieve a value using the get method, it checks if the item has expired based on its TTL (Time-To-Live). If the item has indeed expired, it is automatically removed from the LocalStorage, ensuring that your application only works with valid, up-to-date data.

remember

Retrieve the value associated with the given key, or execute the given callback and store the result in the Local Storage.

Parameters

  • key - String containing the name of the key.
  • fallback - Function you want to execute.
  • ttl (optional) - Time to live in seconds for the key. Defaults to null (no expiration) or equal to LocalStorage.ttl value.

Example

LocalStorage.remember('key', () => 'default', 60);

all

Retrieve an object containing all keys and their associated values stored in the Local Storage.

Example

LocalStorage.all();

remove

Remove the key and its associated value from the Local Storage.

Parameters

  • key - String containing the name of the key to be deleted.

Example

LocalStorage.remove('key');

clear

Clear all keys and their associated values from the Local Storage.

Example

LocalStorage.clear();

has

Check if a key exists in the Local Storage.

Parameters

  • key - String containing the name of the key to be checked.

Example

LocalStorage.has('key');

hasAny

Check if any of the provided keys exist in the Local Storage.

Parameters

  • keys - String or an array of strings containing the names of the keys to be checked.

Example

LocalStorage.hasAny(['key1', 'key2']);

isEmpty

Check if the Local Storage is empty.

Example

LocalStorage.isEmpty();

isNotEmpty

Check if the Local Storage is not empty.

Example

LocalStorage.isNotEmpty();

keys

Retrieve an array containing all keys stored in the Local Storage.

Example

LocalStorage.keys();

count

Retrieve the total number of items stored in the Local Storage.

Example

LocalStorage.count();

touch

Update the expiration time of a key in the Local Storage.

Parameters

  • key - String containing the name of the key.
  • ttl (optional) - Time to live in seconds for the key. Defaults to null (no expiration) or equal to LocalStorage.ttl value.

Example

LocalStorage.touch('key', 60);

expiry

Retrieve the expiration date for a given key.

Parameters

  • key - String containing the name of the key you want to check against
  • ttl (optional) - If true, returns the expiration date as a Date object. Defaults to false.

Example

LocalStorage.expiry('key');

You can also pass a boolean as the second parameter to return the expiration date as a Date object:

LocalStorage.expiry('key', true);

dump

Print the value associated with a key to the console.

Parameters

  • key - String containing the name of the key.

Example

LocalStorage.dump('key');

ttl

Define a global Time-To-Live (TTL) in seconds for all items saved using the LocalStorage.set or LocalStorage.touch method, without specifying a TTL for each item. This can be particularly useful for applications needing a consistent expiry policy for most stored data.

Example

LocalStorage.ttl(7200);

If a default TTL has been set using LocalStorage.ttl, it will be applied to all items set without a specified TTL.