lru.min is a fast, lightweight LRU cache for JavaScript that supports Node.js (8+), Bun, Deno, and browser environments. It provides key-value caching with O(1) operations like get, set, peek, has, delete, and eviction via a max size, including an optional onEviction callback.
Project status
- Actively maintained: Recent upstream activity is very recent (last push 2026-09-01), with a new v1.1.5 update on 2026-09-01, indicating ongoing maintenance rather than dormancy.
- Update cadence: Updates appear somewhat sporadic but ongoing, with gaps of about 5-6 months (v1.1.3 to v1.1.4), then ~6 months (v1.1.4 to v1.1.5 includes an extended gap from 2026-02-02 to 2026-09-01), and earlier releases spanning 2024 to late 2025.
AI summary generated
Recent updates
v1.1.5
v1.1.5 includes a fix for LRU resize behavior where stale key/value references could be left behind in internal slots after shrinking. The code change explicitly clears the freed internal arrays to allow garbage collection, and new tests were added to verify memory release. Release notes only mention the stale-reference fix, but the diff also shows CI and dependency changes.
v1.1.4
v1.1.4 focuses on correctness and efficiency improvements in the internal linked-list management used by the LRU cache. The update refactors how entries are reordered on get/set and how resize eviction/removal is performed, alongside performance tweaks to reduce redundant writes and resize allocations.
v1.1.3
v1.1.3 focuses on a performance optimization to reduce overhead in the cache .clear() eviction path. The repo also updates benchmarks and CI configuration, and bumps several development dependencies.
v1.1.2
Release v1.1.2 focuses on a small internal performance-oriented refactor. However, the repo also includes several non-release-noted changes to contributor tooling (test scripts), dev tooling configuration (Biome), and dependency version bumps.
v1.1.1
v1.1.1 ships a bug fix aimed at improving browser compatibility and a performance improvement to the cache `clear` behavior. The release notes only mention those two items, but the code diff also shows changes to the published package export map and a major refactor of the browser build pipeline.
v1.1.0
v1.1.0 primarily adds a publicly exported TypeScript type, `CacheOptions`, for typing the options passed to `createLRU`. The code and repo docs/tests also indicate an iteration-order change for cache iteration methods, but that behavior change is not mentioned in the release notes.
Featuresv1.0.0
v1.0.0 is the initial release of the project, introducing the "lru.min" functionality. The provided release notes do not describe the API surface or behavior changes in detail.
Features