Sweet and simple - Zero dependencies, pure JS, < 1KB of code
What's this for? PersitentMap is a lightweight, in-process data store that
uses time-tested principles for insuring data-integrity. In short, if you want
to retain metrics and analytics counters, event history, app preferences ...
whatever, but don't want the hassle of setting up MySQL or Redis, this might be
what you're after.
Quick Start
Install:
npm install persistentmap
Use:
// Create a map (and tell it where to save state on disk)const pm = new PersistentMap('~/datastore.json');// Load any prior stateawait pm.load();// Treat it like a Mappm.set('foo', 123);pm.get('foo'); // -> 123// If you want to verify state has been saved before proceeding// await the resultawait pm.set('foo', 345);// 'foo' is now saved to disk. If/when the process dies, restarting it// will restore 'foo' when the map is load()'ed, above
Performance
Unless you're doing 10K's or 100Ks of set() or delete() calls per second, PersistentMap performance should not be an issue. Methods that change the map state(set(), delete(), and clear()), if await'ed, will be fast, but "file system fast", not "in process memory" fast, and depend to some extent on how much data you're storing. In these cases, the Big O performance will be:
set(key, val): O(N) , where N = JSON.stringify(val).length
delete(key): O(1)
clear(): O(1)
For all other methods, performance should be indistuingishable from a native
Map.
Note: the set() and delete() operations may occasionally trigger a
full-state rewrite (this occurs when filesize > options.maxFileSize), in which case
performance will be O(N), where N = JSON.stringify(map).length
API
PersistentMap extends the ES6 Map class. It provides the full ES6 Map API, with the following changes:
New constructor signature, documented below
Existing clear(), delete(), and set() methods enhanced to return a
Promise that resolves when state has been successfully saved to file (or
rejects on error).
New compact(), flush(), and load() methods, documented below
constructor(filepath, options)
filepath - Location of transaction file. This will be created if it does not
exist. Note: PersistentMap may occasionally create a temporary file at ${filepath}.tmp, as well.
options.maxFileSize - Size (bytes) at which to compact the transaction file.
Default = 1,000,000.
async compact()`
Saves current state of map to the transaction file.
async flush()
Wait for all pending writes to complete before resolving.