jonschlinkert/map-cache

Basic cache object for storing key-value pairs. Based on MapCache in Lo-dash 3.0

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.

map-cache's Issues

API usage docs in Readme?

Curious as to why they were removed? For such a small lib, having them in the README is much more convenient than installing a 3rd party dep (verb).

add `.del` alias?

want PR?