What is cache-base?
The cache-base npm package is a simple and fast key-value store for caching data. It provides an easy-to-use API for setting, getting, and managing cached data with support for namespaces and custom storage engines.
What are cache-base's main functionalities?
Setting and getting values
This feature allows users to store and retrieve data by key. The example shows how to set an object with user details and then retrieve it.
{
const Cache = require('cache-base');
const cache = new Cache();
cache.set('user', { name: 'John Doe', age: 30 });
console.log(cache.get('user'));
}
Using namespaces
Namespaces allow for organizing data under a specific context, avoiding key collisions and making data management clearer. The example demonstrates setting and getting data under a 'users' namespace.
{
const Cache = require('cache-base');
const usersCache = new Cache('users');
usersCache.set('user1', { name: 'John Doe', age: 30 });
console.log(usersCache.get('user1'));
}
Custom storage engines
Cache-base supports custom storage engines, allowing users to define how data is stored and retrieved. This example uses JavaScript's Map object as a custom storage engine.
{
const Cache = require('cache-base');
const customStore = new Map();
const cache = new Cache({ store: customStore });
cache.set('key', 'value');
console.log(cache.get('key'));
}
Other packages similar to cache-base
node-cache
node-cache is another simple caching solution for Node.js. It offers similar functionalities to cache-base but also includes TTL (time to live) support for automatic cache invalidation, which cache-base does not provide by default.
lru-cache
lru-cache is a cache object that deletes the least-recently-used items. It is similar to cache-base in providing a key-value cache but is specifically optimized for scenarios where you need to limit memory usage and manage entries based on usage frequency.
cache-base

Basic object cache with get
, set
, del
, and has
methods for node.js/javascript projects.
Please consider following this project's author, Jon Schlinkert, and consider starring the project to show your :heart: and support.
(TOC generated by verb using markdown-toc)
Install
Install with npm:
$ npm install --save cache-base
Quickstart
const CacheBase = require('cache-base');
const app = new CacheBase();
app.set('a.b', 'c');
console.log(app.cache.a);
console.log(app.cache.a.b);
console.log(app.get('a'));
console.log(app.get('a.b'));
More usage examples below.
API
Params
prop
{String|Object}: (optional) Property name to use for the cache, or the object to initialize with.
cache
{Object}: (optional) An object to initialize with.
Example
const app = new CacheBase();
Assign value
to key
. Also emits set
with the key and value.
Params
key
{String|Array}: The name of the property to set. Dot-notation may be used to set nested properties.
value
{any}
returns
{Object}: Returns the instance for chaining.
Events
emits
: set
with key
and value
as arguments.
Example
app.on('set', function(key, val) {
});
app.set('admin', true);
app.set({ name: 'Brian' });
app.set([{ foo: 'bar' }, { baz: 'quux' }]);
console.log(app);
Return the value of key
.
Params
key
{String|Array}: The name of the property to get. Dot-notation may be used to set nested properties.
returns
{any}: Returns the value of key
Events
emits
: get
with key
and value
as arguments.
Example
app.set('a.b.c', 'd');
app.get('a.b');
Create a property on the cache with the given value
only if it doesn't already exist.
Params
key
{String}: Property name or object path notation.
val
{any}
returns
{Object}: Returns the instance for chaining.
Example
console.log(app.cache);
app.set('one', { foo: 'bar' });
app.prime('one', { a: 'b' });
app.prime('two', { c: 'd' });
console.log(app.cache.one);
console.log(app.cache.two);
Set a default value to be used when .get()
is called and the value is not defined on the cache. Returns a value from the defaults when only a key is passed.
Params
key
{String|Array}: The name of the property to set. Dot-notation may be used to set nested properties.
value
{any}: (optional) The value to set on the defaults object.
returns
{Object}: Returns the instance for chaining.
Example
app.set('foo', 'xxx');
app.default('foo', 'one');
app.default('bar', 'two');
app.default('baz', 'three');
app.set('baz', 'zzz');
console.log(app.get('foo'));
console.log(app.get('bar'));
console.log(app.get('baz'));
console.log(app);
Set an array of unique values on cache key
.
Params
key
{String|Array}: The name of the property to union. Dot-notation may be used to set nested properties.
value
{any}
returns
{Object}: Returns the instance for chaining.
Example
app.union('a.b.c', 'foo');
app.union('a.b.c', 'bar');
app.union('a.b.c', ['bar', 'baz']);
console.log(app.get('a'));
Return true if the value of property key
is not undefined
.
Params
key
{String|Array}: The name of the property to check. Dot-notation may be used to set nested properties.
returns
{Boolean}
Example
app.set('foo', true);
app.set('baz', null);
app.set('bar', undefined);
app.has('foo');
app.has('bar');
app.has('baz');
Returns true if the specified property is an own (not inherited) property. Similar to .has(), but returns true if the key exists, even if the value is undefined
.
Params
key
{String}
returns
{Boolean}: Returns true if object key
exists. Dot-notation may be used to set nested properties.
Example
app.set('a.b.c', 'd');
app.set('x', false);
app.set('y', null);
app.set('z', undefined);
app.hasOwn('a');
app.hasOwn('b');
app.hasOwn('c');
app.hasOwn('a.b.c');
app.hasOwn('x');
app.hasOwn('y');
app.hasOwn('z');
app.hasOwn('lslsls');
Delete one or more properties from the instance.
Params
key
{String|Array}: The name of the property to delete. Dot-notation may be used to set nested properties.
returns
{Object}: Returns the instance for chaining.
Events
emits
: del
with the key
as the only argument.
Example
app.on('del', key => app.set(key, app.default(key)));
app.del();
app.del('foo');
app.del(['foo', 'bar']);
Reset the entire cache to an empty object. Note that this does not also clear the defaults
object, since you can manually do cache.defaults = {}
if you want to reset that object as well.
Example
app.on('clear', key => (app.defaults = {}));
app.clear();
Visit (or map visit) the specified method (key
) over the properties in the
given object or array.
Params
key
{String|Array}: The name of the method to visit.
val
{Object|Array}: The object or array to iterate over.
returns
{Object}: Returns the instance for chaining.
Gets an array of names of all enumerable properties on the cache.
Example
const app = new CacheBase();
app.set('user', true);
app.set('admin', false);
console.log(app.keys);
Gets the length of keys.
Example
const app = new CacheBase();
app.set('user', true);
app.set('admin', false);
console.log(app.size);
Usage examples
Create an instance of cache-base
const app = new CacheBase();
app.set('a', 'b');
app.set('c.d', 'e');
console.log(app.get('a'));
console.log(app.get('c'));
console.log(app);
Initialize with an object
const app = new CacheBase({ a: 'b', c: { d: 'e' } });
console.log(app.get('a'));
console.log(app.get('c'));
console.log(app.get('c.d'));
console.log(app);
Inherit
class MyApp extends CacheBase {}
const app = new MyApp();
app.set('a', 'b');
app.set('c', 'd');
console.log(app.get('a'));
console.log(app);
Custom namespace
Pass a string as the first value to the contructor to define a custom property name to use for the cache. By default values are stored on the cache
property.
const CacheBase = require('cache-base');
const app = new CacheBase('data', { a: 'b' });
app.set('c.d', 'e');
console.log(app.get('a'));
console.log(app.get('c'));
console.log(app.data);
console.log(app);
About
Contributing
Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.
Running Tests
Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:
$ npm install && npm test
Building docs
(This project's readme.md is generated by verb, please don't edit the readme directly. Any changes to the readme must be made in the .verb.md readme template.)
To generate the readme, run the following command:
$ npm install -g verbose/verb
Related projects
You might also be interested in these projects:
- base-methods: base-methods is the foundation for creating modular, unit testable and highly pluggable node.js applications, starting… more | homepage
- get-value: Use property paths like 'a.b.c' to get a nested value from an object. Even works… more | homepage
- has-value: Returns true if a value exists, false if empty. Works with deeply nested values using… more | homepage
- option-cache: Simple API for managing options in JavaScript applications. | homepage
- set-value: Create nested values and any intermediaries using dot notation (
'a.b.c'
) paths. | homepage
- unset-value: Delete nested properties from an object using dot notation. | homepage
Contributors
Author
Jon Schlinkert
License
Copyright © 2018, Jon Schlinkert.
Released under the MIT License.
This file was generated by verb-generate-readme, v0.6.0, on March 23, 2018.