ylru
v2.0.0
Published
Extends LRU base on hashlru
Downloads
11,502,039
Readme
ylru
hashlru inspired
hashlru is the Simpler, faster LRU cache algorithm. Please checkout algorithm and complexity on hashlru.
ylru extends some features base on hashlru:
- cache value can be expired.
- cache value can be empty value, e.g.:
null
,undefined
,''
,0
Usage
import { LRU } from 'ylru';
const lru = new LRU(100);
lru.set(key, value);
lru.get(key);
// value2 will be expired after 5000ms
lru.set(key2, value2, { maxAge: 5000 });
// get key and update expired
lru.get(key2, { maxAge: 5000 });
API
new LRU(max) => lru
initialize a lru object.
lru.get(key[, options]) => value | null
{Number} options.maxAge
: update expire time when get, value will becomeundefined
aftermaxAge
pass.
Returns the value in the cache.
lru.set(key, value[, options])
{Number} options.maxAge
: value will becomeundefined
aftermaxAge
pass. IfmaxAge
not set, value will be never expired.
Set the value for key.
lru.keys()
Get all unexpired cache keys from lru, due to the strategy of ylru, the keys
' length may greater than max
.
const lru = new LRU(3);
lru.set('key 1', 'value 1');
lru.set('key 2', 'value 2');
lru.set('key 3', 'value 3');
lru.set('key 4', 'value 4');
lru.keys(); // [ 'key 4', 'key 1', 'key 2', 'key 3']
// cache: {
// 'key 4': 'value 4',
// }
// _cache: {
// 'key 1': 'value 1',
// 'key 2': 'value 2',
// 'key 3': 'value 3',
// }
lru.reset()
reset a lru object.
const lru = new LRU(3);
lru.set('key 1', 'value 1');
lru.set('key 2', 'value 2');
lru.set('key 3', 'value 3');
lru.set('key 4', 'value 4');
lru.reset();
// cache: {
// }
// _cache: {
// }
lru.keys().length === 0;
License
Contributors
|fengmk2|dominictarr|dead-horse|thonatos|mourner|semantic-release-bot| | :---: | :---: | :---: | :---: | :---: | :---: | vagusX|RaoHai
This project follows the git-contributor spec, auto updated at Thu Mar 28 2024 11:52:18 GMT+0800
.