wraps localStorage and adds .getObject(), .setObject(), .isPersistent
localStorage is a simple key/value store API for browsers, perfectly
suited to store little amount of data like configurations.
humbleLocalStorage provides additional APIs to store / retrieve
JSON objects, and also handles several circumstances in which Browsers
do not support or persist localStorage (e.g. private modes,
Cookies disabled, etc).
In case data cannot be persisted in localStorage, humbleLocalStorage
falls back to in-memory storage. To determine if data is being persisted,
use humbleLocalStorage.isPersistent property.
- Download: https://github.com/gr2m/humble-localstorage/releases
- or: install via Bower:
bower install -S humble-localstorage - or: install via npm:
npm install -S humble-localstorage
humbleLocalStorage.getItem('mykey') // string value or null
humbleLocalStorage.setItem('mykey', 123) // stored as '123'
humbleLocalStorage.removeItem('mykey')
humbleLocalStorage.clear() // removes all data
humbleLocalStorage.key(0) // name of key by numeric index, or null
humbleLocalStorage.length // number of stored keys
humbleLocalStorage.getObject('mykey') // JSON value or null
humbleLocalStorage.setObject('mykey', {foo: 'bar'}) // stored as '{"foo": "bar"}'
humbleLocalStorage.isPersistent // true if data persists page reload, false if not# see all available tasks
npm run
# run unit & integration tests
# note: selenium must be running
npm test
MIT