incache

Powerful key/value in-memory storage or on disk to persist some data

What does?

InCache is a module that store any info in memory, it can be used for example for storing server sessions, caching http response or sharing singleton object in your apps. It also give you the possibility to save data on disk so you can avoid the data loss when the process exit or restart.

Installation

Node.js

npm install incache --save

Examples

Basic

const InCache = require('incache');
const store = new InCache();

// Create a record with key 'my key'
store.set('my key', 'my value');

// Update 'my key'
store.set('my key', {a: 1, b: 2});

// Get key
store.get('my key');

// Remove 'my key'
store.remove('my key');

// Clear
store.clear();

// Expires after 2 seconds
store.set('my string', 'hello world', {maxAge: 2000});
// Or expires on...
store.set('my string', 'hello world', {expires: '2028-08-22 12:00:00'});

Auto remove expired records

const store = new InCache({
    autoRemovePeriod: 2 //checks every 2 seconds
});

store.set('my string', 'hello world', {maxAge: 4000});

setTimeout(()=>{
    console.log(store.count()) //=> 0
}, 6000);

Max cache size

const store = new InCache({
    maxRecordNumber: 5
});

store.set('k0', 'v0');
store.set('k1', 'v1');
store.set('k2', 'v2');
store.set('k3', 'v3');
store.set('k4', 'v4');
store.set('k5', 'v5');

console.log(store.count()); //=> 5
console.log(store.has('k0')); //=> false

Save on disk

This operation is running before the process is terminated

const store = new InCache({
    autoSave: true
});

Save manually

const store = new InCache({
    filePath: 'my-path/my-store.json'
});

store.set('a key', 'a value');

// This method returns a Promise
store.save();

Events

// Triggered when a record has been deleted
incache.on('remove', key => {
    console.log(key);
});

// Triggered before create/update
incache.on('beforeSet', (key, value) => {
    console.log(key, value);
    if(foo)
        return false;
});

// Triggered when a record has been created
incache.on('create', (key, record) => {
    console.log(key, record);
});

//Triggered when a record has been updated
incache.on('update', (key, record) => {
    console.log(key, record);
});

API

Please see the full documentation for more details.

Browser

Local

<script src="node_modules/incache/dist/incache.min.js"></script>

CDN unpkg

<script src="https://unpkg.com/incache/dist/incache.min.js"></script>

CDN jsDeliver

<script src="https://cdn.jsdelivr.net/npm/incache/dist/incache.min.js"></script>

Changelog

You can view the changelog here

License

InCache is open-sourced software licensed under the MIT license

Author

Fabio Ricali

Contributor

Davide Polano

Changelog

[6.0.0] - 2017-09-23

• Added
  • options
    • autoLoad
    • autoSave
    • autoSaveMode
    • autoSavePeriod
    • clone
    • preserve
    • deleteOnExpires
    • maxRecordNumber
  • methods
    • load()
    • save()
    • count()
  • events
    • load
    • save