map-cache

map-cache

Basic cache object for storing key-value pairs.

Install

Install with npm:

$ npm install map-cache --save

Based on MapCache in Lo-dash v3.0. MIT License

Usage

var MapCache = require('map-cache');
var mapCache = new MapCache();

API

MapCache

Creates a cache object to store key/value pairs.

Example

var cache = new MapCache();

.set

Adds value to key on the cache.

Params

• key {String}: The key of the value to cache.
• value {any}: The value to cache.
• returns {Object}: Returns the Cache object for chaining.

Example

cache.set('foo', 'bar');

.get

Gets the cached value for key.

Params

• key {String}: The key of the value to get.
• returns {any}: Returns the cached value.

Example

cache.get('foo');
//=> 'bar'

.has

Checks if a cached value for key exists.

Params

• key {String}: The key of the entry to check.
• returns {Boolean}: Returns true if an entry for key exists, else false.

Example

cache.has('foo');
//=> true

.del

Removes key and its value from the cache.

Params

• key {String}: The key of the value to remove.
• returns {Boolean}: Returns true if the entry was removed successfully, else false.

Example

cache.del('foo');

Related projects

You might also be interested in these projects:

• cache-base: Basic object cache with get, set, del, and has methods for node.js/javascript projects. | homepage
• config-cache: General purpose JavaScript object storage methods. | homepage
• option-cache: Simple API for managing options in JavaScript applications. | homepage

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Building docs

Generate readme and API documentation with verb:

$ npm install verb && npm run docs

Or, if verb is installed globally:

$ verb

Running tests

Install dev dependencies:

$ npm install -d && npm test

Author

Jon Schlinkert

• github/jonschlinkert
• twitter/jonschlinkert

License

Copyright © 2016, Jon Schlinkert. Released under the MIT license.

This file was generated by verb, v0.9.0, on May 10, 2016.

Similar packages

Other packages similar to map-cache

lru-cache

lru-cache is an npm package that implements a cache object that deletes the least-recently-used items. It is similar to map-cache but with the added feature of maintaining a limited size and evicting entries that have not been recently used.

node-cache

node-cache is an in-memory cache module for Node.js. It is similar to map-cache but provides additional features like TTL (time to live) for entries, statistics about the cache's performance, and events for when entries expire.

memory-cache

memory-cache is another simple in-memory cache for Node.js applications. It is similar to map-cache but also offers the ability to set a timeout on cached items, after which they are automatically removed.