rememoize*

Memoize results of async functions and refresh them periodically in background.

* May contain traces of sin and unicorn tears.

Installation

npm install rememoize

Usage

Wrap an async function with rememoize like so:

1var rememoize = require('rememoize')
2var rememoizedFunction = rememoize(<asyncFunction>, [options])
3
4rememoizedFunction(<callback>)

Argument options is optional and may specify the following values:

1{
2  initialValue    :  [any_value]
3  refreshInterval :  [milliseconds]
4}

• initialValue If set, specifies an initial value that will be returned immediately on first call to rememoized function. If not set, initial calls will be queued up until first iteration has completed.
• refreshInterval If set, specifies the interval at which the rememoized function will be refreshed in background. If not, the given async function will only be called once (and it's result will be cached).

Examples

1var rememoize = require('rememoize')
2
3var rememoizedFunction = rememoize(function(done) {
4  // Awww, this takes long to complete
5  doLongRunningAsyncStuff(function(err, result) {
6    done(err, result)
7  })
8}, {
9  initialValue: 'my initial value',
10  refreshInterval: 1000
11})
12
13rememoizedFunction(function(err, result) {
14  if (err) throw err
15  console.log('Got result:', result)
16})