eddorre / store.js

localStorage wrapper for all browsers without using cookies. Uses localStorage, globalStorage, and userData behavior under the hood

store.js

store.js exposes a simple API for cross browser local store

// Store 'marcus' at 'username'
store.set('username', 'marcus');

// Get 'username'
store.get('username');

// Remove 'username'
store.remove('username');

// Clear all keys
store.clear();

In order to use setObject and getObject your browser needs be able to parse and stringify JSON.
If your browser doesn't have such capability, download http://www.json.org/json2.js.

// Use JSON to stash an object (see http://www.json.org/json2.js)
store.setObject('user', { name: 'marcus', likes: 'javascript' });

// Use JSON to retrieve an object (see http://www.json.org/json2.js)
var user = store.getObject('user');
alert(user.name + ' likes ' + user.likes);

Tests

Go to test.html in your browser

Supported

• Tested in Firefox 2.0
• Tested in Firefox 3.0
• Tested in Firefox 3.5
• Tested in Firefox 3.6
• Tested in Chrome 5
• Tested in Safari 4
• Tested in Safari 5
• Tested in IE6
• Tested in IE7
• Tested in IE8
• Tested in Opera 10
  • Opera 10.54

Supported but borken (please help fix)

• Chrome 4
• Opera 10.10 (Someone reported this as broken, I'm not sure it's true)

Not supported

• Firefox 1.0: no means (beside cookies and flash)
• Safari 2: no means (beside cookies and flash)
• Safari 3: no synchronous api (has asynch sqlite api, but store.js is synch)
• Opera 9: don't know if there is synchronous api for storing data locally
• Firefox 1.5: don't know if there is synchronous api for storing data locally

TODO

• I believe underlying APIs can throw under certain conditions. Where do we need try/catch?
• Test different versions of Opera 10.X explicitly