incache

Simple 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});

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

// Clear
store.clear();

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

Save on disk

This operation is running when the process is terminated

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

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