Skip to content

Backbone IndexedDB adapter with cross browser support via IDBWrapper

License

Notifications You must be signed in to change notification settings

vincentmac/backbone-idb

Repository files navigation

backbone-idb

Backbone IndexedDB adapter with cross browser support via IDBWrapper

Build Status

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.json

Also available via bower

$ bower install backbone-idb
# or
$ bower install backbone-idb --save # to install and save to bower.json

Usage

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/Model
var 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 index via the iterate command
  • Document keyRanges
  • Proxying directly to idb-wrapper via the indexedDB.store object

About

Backbone IndexedDB adapter with cross browser support via IDBWrapper

Resources

License

Stars

Watchers

Forks

Packages

No packages published