NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #12 most downloaded on npm
A cache object that deletes the least-recently-used items.
Latest stable
11.5.3
Last release 2 months ago
18 Sep 2026
Ships fairly regularly
a new release about every 4 weeks
Some releases are documented
notes for 17 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
15 years old
164 releases · first in 2011
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add backgroundFetchSize option, defaulting to 1, to set an effective size for provisional background fetch objects while in flight, if they do not sha
backgroundFetchSize option, defaulting to 1, to set an
effective size for provisional background fetch objects while
in flight, if they do not shadow an existing stale entry.Your coding agent can read these notes before it upgrades. Set up the MCP server →
Add cache property to status objects, in order to differentiate which cache is emitting the metric or trace.
cache property to status objects, in order to
differentiate which cache is emitting the metric or trace.onInsert does not fire for background fetch internal
promises.dispose() and disposeAfter() now fire for the stale
value left behind when an in-process background fetch is
pre-empted by eviction.fetchMethod that returns a non-Promise value is handled
correctly.Error is created, or abort() signaled, when a
background fetch promise is resolved. (Presumably the
implementation is done by that point.)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add observability features, expand the coverage of LRUCache.Status objects.
LRUCache.Status objects.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add the perf option to specify performance, Date, or any other object with a now() method that returns a number.
perf option to specify performance, Date, or any
other object with a now() method that returns a number.- Add the onInsert method
onInsert methodNothing published for this version
Nothing published for this version
Drop support for node less than v20
Nothing published for this version
Nothing published for this version
Nothing published for this version
Accidental minor update, should've been patch.
Nothing published for this version
set disposeReason to 'expire' when it's the result of a TTL expiration, or 'fetch' when it's the result of an aborted or undefined-returning fetch()
forceFetch() methoddisposeReason to 'expire' when it's the result of a TTL
expiration, or 'fetch' when it's the result of an aborted
or undefined-returning fetch()memo() methodNothing published for this version
Nothing published for this version
types: implement the Map interface
Map<K, V> interfaceadd cache.info(key) to get value as well as ttl and size information.
cache.info(key) to get value as well as ttl and size
information.Nothing published for this version
Nothing published for this version
Nothing published for this version
cache.fetch() return type is now Promise instead of Promise . This is an irrelevant change practically speaking, but can require changes for TypeScrip
cache.fetch() return type is now Promise<V | undefined>
instead of Promise<V | void>. This is an irrelevant change
practically speaking, but can require changes for TypeScript
users.Nothing published for this version
Nothing published for this version
cache.set(key, undefined) is now an alias for cache.delete(key)
cache.set(key, undefined) is now an alias for
cache.delete(key)Nothing published for this version
Nothing published for this version
Nothing published for this version
Use named export only, no default export.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
The fetchContext option was renamed to context, and may no longer be set on the cache instance itself.
fetchContext option was renamed to context, and may no
longer be set on the cache instance itself.null or undefined.'lru-cache/min', for both CJS
and MJS builds.Nothing published for this version
Nothing published for this version
Nothing published for this version
Add support for internal state investigation through the use of a status option to has(), set(), get(), and fetch().
status option to has(), set(), get(), and fetch().Nothing published for this version
Nothing published for this version
Add signal option for fetch to pass a user-supplied AbortSignal
signal option for fetch to pass a user-supplied
AbortSignalignoreFetchAbort and allowStaleOnFetchAbort optionsFail fetch() promises when they are aborted
Nothing published for this version
One column per quarter.