Ember.ApplicationInstance Class packages/ember-application/lib/system/application-instance.js:24
PUBLIC
Extends: Ember.EngineInstance
Defined in: packages/ember-application/lib/system/application-instance.js:24
Module: ember-application
The ApplicationInstance
encapsulates all of the stateful aspects of a
running Application
.
At a high-level, we break application boot into two distinct phases:
- Definition time, where all of the classes, templates, and other dependencies are loaded (typically in the browser).
- Run time, where we begin executing the application once everything has loaded.
Definition time can be expensive and only needs to happen once since it is an idempotent operation. For example, between test runs and FastBoot requests, the application stays the same. It is only the state that we want to reset.
That state is what the ApplicationInstance
manages: it is responsible for
creating the container that contains all application state, and disposing of
it once the particular test run or FastBoot request has finished.
boot
(options)
PromiseInitialize the Ember.ApplicationInstance
and return a promise that resolves
with the instance itself when the boot process is complete.
The primary task here is to run any registered instance initializers.
See the documentation on BootOptions
for the options it takes.
Parameters:
- options
Returns:
- Promise
customEvents
Object
private
The DOM events for which the event dispatcher should listen.
By default, the application's Ember.EventDispatcher
listens
for a set of standard DOM events, such as mousedown
and
keyup
, and delegates them to your application's Ember.View
instances.
rootElement
String|DOMElement
private
The root DOM element of the Application as an element or a jQuery-compatible selector string.