Security News
tea.xyz Spam Plagues npm and RubyGems Package Registries
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
tiny-lru
Advanced tools
Changelog
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,117,547 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
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.