Security News
New Proposed CISA Mandate Would Require Critical Infrastructure to Report Ransom Payments Within 24 Hours
CISA has proposed a set of new rules that would require critical infrastructure to report cyber incidents and ransom payments.
tiny-lru
Advanced tools
Tiny LRU cache for Client or Server
Weekly downloads
Readme
Least Recently Used cache for Client or Server.
import {lru} from "tiny-lru";
const cache = lru(max, ttl = 0, resetTtl = false);
import {LRU} from "tiny-lru";
const cache = new LRU(max, ttl = 0, resetTtl = false);
import {LRU} from "tiny-lru";
class MyCache extends LRU {}
Lodash provides a memoize
function with a cache that can be swapped out as long as it implements the right interface.
See the lodash docs for more on memoize
.
_.memoize.Cache = lru().constructor;
const memoized = _.memoize(myFunc);
memoized.cache.max = 10;
Tiny-LRU has 100% code coverage with its tests.
--------------|---------|----------|---------|---------|-------------------
File | % Stmts | % Branch | % Funcs | % Lines | Uncovered Line #s
--------------|---------|----------|---------|---------|-------------------
All files | 100 | 89.85 | 100 | 100 |
tiny-lru.cjs | 100 | 89.85 | 100 | 100 | 11-31,130-138,172
--------------|---------|----------|---------|---------|-------------------
Item in "first" or "bottom" position; default is null
Example
const cache = lru();
cache.first; // null - it's a new cache!
Item in "last" or "top" position; default is null
Example
const cache = lru();
cache.last; // null - it's a new cache!
Max items to hold in cache; default is 1000
Example
const cache = lru(500);
cache.max; // 500
Resets item.expiry
with each set()
if true
; default is false
Example
const cache = lru(500, 5*6e4, true);
cache.resetTtl; // true
Number of items in cache
Example
const cache = lru();
cache.size; // 0 - it's a new cache!
Milliseconds an item will remain in cache; lazy expiration upon next get()
of an item
Example
const cache = lru(100, 3e4);
cache.ttl; // 30000;
Clears the contents of the cache
return {Object} LRU instance
Example
cache.clear();
Removes item from cache
param {String} key Item key
return {Object} LRU instance
Example
cache.delete("myKey");
Returns an Array
cache items
param {Array} keys (Optional) Cache item keys to get, defaults to `this.keys()` if not provided
return {Object} LRU instance
Example
cache.entries(['myKey1', 'myKey2']);
Evicts the least recently used item from cache
return {Object} LRU instance
Example
cache.evict();
Gets expiration time for cached item
param {String} key Item key
return {Mixed} Undefined or number (epoch time)
Example
const item = cache.expiresAt("myKey");
Gets cached item and moves it to the front
param {String} key Item key
return {Mixed} Undefined or Item value
Example
const item = cache.get("myKey");
Returns a Boolean
indicating if key
is in cache
return {Object} LRU instance
Example
cache.has('myKey');
Returns an Array
of cache item keys (first
to last
)
return {Array} Array of keys
Example
console.log(cache.keys());
Sets item in cache as first
param {String} key Item key
param {Mixed} value Item value
return {Object} LRU instance
Example
cache.set("myKey", {prop: true});
Returns an Array
cache items
param {Array} keys (Optional) Cache item keys to get
return {Array} Cache items
Example
cache.values(['abc', 'def']);
Copyright (c) 2023 Jason Mulligan Licensed under the BSD-3 license.
FAQs
Tiny LRU cache for Client or Server
The npm package tiny-lru receives a total of 1,017,302 weekly downloads. As such, tiny-lru popularity was classified as popular.
We found that tiny-lru demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
CISA has proposed a set of new rules that would require critical infrastructure to report cyber incidents and ransom payments.
Security News
Redis is no longer OSS, breaking its explicit commitment to remain under the BSD 3-Clause License forever. This has angered contributors who are now working to fork the software.
Product
Socket AI now enables 'AI detected potential malware' alerts by default, ensuring users benefit from AI-powered state-of-the-art malware detection without needing to opt-in.