Old Guides - You are viewing the guides for Ember v3.12.0. VIEW v3.28.0
Edit Page

Debugging


Ember provides several configuration options that can help you debug problems with your application.

Routing

Log router transitions

import Application from '@ember/application';

export default Application.extend({
  // Basic logging, e.g. "Transitioned into 'post'"
  LOG_TRANSITIONS: true,

  // Extremely detailed logging, highlighting every internal
  // step made while transitioning into a route, including
  // `beforeModel`, `model`, and `afterModel` hooks, and
  // information about redirects and aborted transitions
  LOG_TRANSITIONS_INTERNAL: true
});

Views / Templates

Log view lookups

ENV.APP.LOG_VIEW_LOOKUPS = true;

Controllers

Log generated controller

ENV.APP.LOG_ACTIVE_GENERATION = true;

Miscellaneous

Turn on resolver resolution logging

This option logs all the lookups that are done to the console. Custom objects you've created yourself have a tick, and Ember generated ones don't.

It's useful for understanding which objects Ember is finding when it does a lookup and which it is generating automatically for you.

import Application from '@ember/application';

export default Application.extend({
  LOG_RESOLVER: true
});

Dealing with deprecations

Ember.ENV.RAISE_ON_DEPRECATION = true;
Ember.ENV.LOG_STACKTRACE_ON_DEPRECATION = true;

Implement an Ember.onerror hook to log all errors in production

import fetch from 'fetch';

Ember.onerror = function(error) {
  fetch('/error-notification', {
    method: 'POST',
    body: JSON.stringify({
      stack: error.stack,
      otherInformation: 'exception message'
    })
  });
}

Import the console

If you are using imports with Ember, be sure to import the console:

Ember = {
  imports: {
    Handlebars: Handlebars,
    jQuery: $,
    console: window.console
  }
};

Errors within Ember.run.later Backburner

Backburner.js has support for stitching the stacktraces together so that you can track down where an error thrown by Ember.run.later is being initiated from. Unfortunately, this is quite slow and is not appropriate for production or even normal development.

To enable full stacktrace mode in Backburner, and thus determine the stack of the task when it was scheduled onto the run loop, you can set:

Ember.run.backburner.DEBUG = true;

Once the DEBUG value is set to true, when you are at a breakpoint you can navigate back up the stack to the flush method in and check the errorRecordedForStack.stack value, which will be the captured stack when this job was scheduled.