❤
npm
Sign UpSign In

cacheman-promise

1.6.0 • Public • Published

Cacheman-Promise

NPM version Downloads Build Status Dependency Status Coverage Status

NPM

Cacheman library with a promise interface.

Installation

$ npm install --save cacheman-promise

Usage

Cacheman-promise only support set, get, del, clear, pull and wrap promise interface.

Cacheman([name, [options]])

Please refer to Cacheman Options API

var Cacheman = require('cacheman-promise');
 
var options = {
  ttl: 90,
  engine: 'redis',
  port: 9999,
  host: '127.0.0.1'
};
 
var cache = new Cacheman('todo', options);
// or
var cache = new Cacheman(options);

cache.set(key, value, [ttl, [fn]])

Usage:

var key = 'foo';
var data = 'bar';
 
cache.set(key, {name: data})
  .then(function(val){
    // output "{name: 'bar'}"
    console.log(val);
  });

cache.get(key, fn)

You can pass array or string as key.

Usage:

 
cache.set('foo', 'bar');
 
cache.get('foo')
  .then(function(val){
    // output "bar"
    console.log(val);
  });

pass array as multiple keys

Usage:

 
cache.set('foo', 1);
cache.set('bar', 2);
 
cache.get(['foo', 'bar'])
  .then(function(result){
    // output {"foo": 1, "bar": 2}
    console.log(result);
  });

cache.pull(key, default)

If you need to retrieve an item from the cache and then delete it, you may use the pull method. Like the get method, null will be returned if the item does not exist in the cache.

cache.set('foo', 'bar');
 
cache.pull('foo')
  .then(function(result){
    // output 'bar'
    console.log(result);
  }).then(function() {
    return cache.get('foo');
  }).then(function(result) {
    // output 'null'
    console.log(result);
  });

You can pass default value as second paramaeter if the item doesn't exist in the cache.

// make sure `foo` cache doesn't exist.
cache.del('foo');
 
cache.pull('foo', 'bar')
  .then(function(result){
    // output 'bar'
    console.log(result);
  });

cache.del(key, [fn])

You can pass array or string as key.

Usage:

cache.del('foo')
  .then(function(){
    console.log('foo was deleted');
  });

or

cache.del(['foo', 'bar'])
  .then(function(){
    console.log('foo and bar was deleted');
  });

Clear some items with prefix name:

cache.clear('foo*')
  .then(function(){
    console.log('clear cache with `foo` prefix name like `foo1`, `foo2` etc.');
  });

cache.clear([fn])

Clear all cache as follwoing:

cache.clear()
  .then(function(){
    console.log('cache is now clear');
  });

cache.wrap(key, default, [ttl, [fn]])

Wraps a function in cache. I.e., the first time the function is run, its results are stored in cache so subsequent calls retrieve from cache instead of calling the function.

var key = 'foo';
var data = 'bar';
 
cache.wrap(key, data)
  .then(function(val) {
 
    // get foo key from cache
    return cache.get(key);
  }).then(function(val) {
 
    // output 'bar'
    console.log(val);
  });

Run tests

$ npm test

Readme

Keywords

Package Sidebar

Install

npm i cacheman-promise

Repository

github.com/appleboy/cacheman-promise

Homepage

github.com/appleboy/cacheman-promise

Weekly Downloads

0

Version

1.6.0

License

MIT

Last publish

Collaborators

  • appleboy
Try on RunKit
Report malware