backbone-idb
Backbone IndexedDB adapter with cross browser support via IDBWrapper
IDBWrapper tutorial Part 1 - Basic CRUD
IDBWrapper tutorial Part 2 - Indexes and Query
See tests for usage until I get some more time to fully document.
Dependencies
Obtaining backbone-idb
Available via npm
$ npm install backbone-idb# or$ npm install backbone-idb --save # to install and save to package.jsonAlso available via bower
$ bower install backbone-idb# or$ bower install backbone-idb --save # to install and save to bower.jsonUsage
Define a Backbone.Model or Backbone.Collection with an indexedDB property in the initialize function.
var Note = Backbone.Model.extend({}); var Notes = Backbone.Collection.extend({ initialize: function() { this.indexedDB = new Backbone.IndexedDB({ storeName: 'notes', dbVersion: 1, keyPath: 'id', autoIncrement: true, indexes:[ {name:'tags', keyPath:'tags', unique: false, multiEntry: true}, // When specifying only the `name`, `keyPath` is assummed to be the same. // `unique` and `multiEntry` are also false by default. // {name:'titleLC', keyPath:'titleLC', unique: false, multiEntry: false} {name:'titleLC'} ] }, this); }, model: Note});The first parameter passed into Backbone.IndexedDB is the options object. You may pass in an empty object and have the default attributes set for the store (defaults listed below). Any options that you pass in will override the defaults.
// The default options object set on the Collection/Modelvar options = { storeName: 'Store', storePrefix: '', dbVersion: 1, keyPath: 'id', autoIncrement: true, onStoreReady: defaultReadyHandler, onError: defaultErrorHandler, indexes: []};Since indexedDB is asynchronous in nature, we need to update the way we instantiate a new Collection or Model. By default, backbone-idb will trigger idb:ready on the object. This behaviour can be overridden by setting your own callback function on the onStoreReady attribute in the options object.
var notes = new Notes(); notes.once('idb:ready', function() { // Some actions to take after initializing the new collection});Collections/Models can now use the same Backbone.sync api to interact with IndexedDB; however, you will need to add your own success callback and, optionally, your own error callback in the options parameter.
notes.fetch({success: function() { // fetch success handler}}); var note = new Note(); notes.add(note);note.save({title: 'some note title'}, {success: function() { // save success handler}});TODO
- Document retrieving models from a store by an
indexvia theiteratecommand - Document keyRanges
- Proxying directly to
idb-wrappervia theindexedDB.storeobject