localStorage implementation for node.js
Go to file
AJ ONeal 8c3ac848f2 v1.0.4: update links and license 2018-10-10 16:51:23 -06:00
lib moved root so that README and tests are included 2013-01-26 02:07:18 -07:00
tests should not return ls.prototype.key 2013-01-25 21:12:55 -07:00
LICENSE v1.0.4: update links and license 2018-10-10 16:51:23 -06:00
README.md v1.0.4: update links and license 2018-10-10 16:51:23 -06:00
package.json v1.0.4: update links and license 2018-10-10 16:51:23 -06:00

README.md

DOMStorage

See https://git.coolaj86.com/coolaj86/dom-storage.js for a slightly better version of the same thing.

localStorage

An inefficient, but as W3C-compliant as possible using only pure JavaScript, localStorage implementation.

Purpose

This is meant for the purpose of being able to run unit-tests and such for browser-y modules in node.

Usage

var localStorage = require('localStorage')
  , myValue = { foo: 'bar', baz: 'quux' }
  ;

localStorage.setItem('myKey', JSON.stringify(myValue));
myValue = localStorage.getItem('myKey');

API

  • getItem(key)
  • setItem(key, value)
  • removeItem(key)
  • clear()
  • key(n)
  • length

Tests

null === localStorage.getItem('key');

0 === localStorage.length;
null === localStorage.getItem('doesn't exist');
undefined === localStorage['doesn't exist'];

localStorage.setItem('myItem');
"undefined" === localStorage.getItem('myItem');
1 === localStorage.length;

localStorage.setItem('myItem', 0);
"0" === localStorage.getItem('myItem');

localStorage.removeItem('myItem', 0);
0 === localStorage.length;

localStorage.clear();
0 === localStorage.length;

TODO / Bugs

  • Does not persist.
    • could use fs.readFileSync at load and an occasional fs.writeFile to write-out localStorage.json
  • Doesn't not emit Storage events