sessionStorage API which gracefully degrades to & cookies when not available

Downloads in past


0.1.06 years ago9 years agoMinified + gzip package size for sessionstorage in KB


!Made by unshiftmade-by!Version npmversion!Build Statusbuild!Dependenciesdavid!Coverage Statuscover!IRC channelirc
The sessionStorage API is amazing and super useful when you need to store data temporarily in the browser. We used to abuse cookies for this, but not all the data that you want to store needs to be synced with the server. The sessionStorage API filled that gap, but unfortunately we cannot expect this API to be available and enabled in every browser context. This module provides various of fallbacks which follow the same API as sessionStorage for when it's not enabled. The following fallback's are supported:
  • - Storing data in the name property of the window.
  • cookies - This doesn't really need an explanation.


It's build for browserify but it should work with Node.js as well as we provide a fallback API. The module is released in the public npm registry and can be installed using:
npm install --save sessionstorage


The API is exactly the same as the DOM storage API so you can use the following methods:
  • getItem(key)
  • setItem(key, value)
  • removeItem(key)
  • clear()

So all you need to do is require the module and you're ready to go:
'use strict';

var sessionstorage = require('sessionstorage');