Skip to content
Chrome Developer Tools extension for debugging Backbone.js applications
JavaScript HTML CSS
Branch: master
Clone or download
Latest commit 6d437a1 Dec 14, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
css Panel: fix alignments and paddings Jan 13, 2017
img Create and update screenshot used in updated.html Feb 4, 2015
js #52 | $.ajax: prevent automatic js execution Dec 14, 2017
templates Update toggle views for each component Jan 7, 2017
.gitignore
CHANGELOG.md Release v0.4.1 Dec 14, 2017
CONTRIBUTORS Update copyright range Jan 29, 2015
LICENSE License change from GPL to MPL (Mozilla Public License) May 19, 2013
README.md Update README.md Mar 28, 2016
devtools.html Convert tabs to spaces Jul 13, 2013
elementsSidebar.html
manifest.json Release v0.4.1 Dec 14, 2017
panel.html Convert tabs to spaces Jul 13, 2013
updated.html Update updated.html Sep 19, 2015

README.md

Backbone Debugger

Chrome Developer Tools extension for debugging Backbone.js applications.

Features

  • Adds a panel under the Chrome Developer Tools that displays in real-time all your application views, models, collections and routers. Data displayed includes:
    • Views: rendering status, html element, associated model and/or collection, handled page events, events triggered
    • Models: last sync status, attributes, id, cid, url, associated collection, events triggered, sync actions
    • Collections: last sync status, models, url, events triggered, sync actions
    • Routers: events triggered (include routes)
  • Extends the sidebar of the developer tools "Elements" panel to display the Backbone View of the inspected html element.

Install from source

Using Google Chrome:

  • Download the project archive and extract it somewhere.
  • Click on Tools -> Settings -> Extensions.
  • Select "Enable developer mode" in the upper right of the window.
  • Click on "Load unpacked extension".
  • Select the extracted folder.
  • Restart the browser.
  • Enjoy!

Install from Chrome Web Store

Follow this method if you want the latest stable release, it will also update automatically.

  • Go to the extension page and follow the instructions. Leave a review if you can!
  • Restart the browser.

Backbone detection

If you get the message "Waiting for Backbone" indefinitely, then Backbone can't be found, currently the only supported automatic detection is via window.Backbone or via AMD with window.define.

To send the Backbone object to the debugger manually, use the following code just after requiring it in the main file, before creating any application component, like views or models:

var Backbone = require('backbone'); // example: backbone is imported
// Add this!
if (window.__backboneAgent) {
  window.__backboneAgent.handleBackbone(Backbone);
}

In case this isn't enough, please open an issue.

Known Limitations

Support for apps that modify the standard Backbone behavior, e.g. apps that patch core methods like extend or delegateEvents, or that replace part of Backbone functions with custom code, is uncertain. However, constant efforts are taken in this direction to address the most possible use cases, so even if your application falls into this category you may still give it a try, open an issue or wait for newer versions.

Contribute

Want to contribute? You can report bugs, suggest features, write code and write documentation!

Looking for other ways? You can also support this project via Flattr or Gittip

Screenshots

Views:

Views

Models:

Models

Collections:

Collections

Routers:

Routers

Elements sidebar extension:

Elements sidebar extension

You can’t perform that action at this time.