The Inspector provides a way to look at all Promises created
in your application. Click on the `Promises` menu to start inspecting them.


<img src="/images/guides/ember-inspector/promises-screenshot.png" width="680" />

You can see a hierarchical list of Promises with labels describing each
Promise, its state, its settled value, and the time it took to
settle.


### Promise States and Filtering

Promises have different colors based on their state.

<img src="/images/guides/ember-inspector/promises-fulfilled.png" width="300"/>

<img src="/images/guides/ember-inspector/promises-pending.png" width="300"/>

<img src="/images/guides/ember-inspector/promises-rejected.png" width="300"/>

You can filter by clicking on the following pills: `Rejected`, `Pending`, `Fulfilled`.

<img src="/images/guides/ember-inspector/promises-toolbar.png" width="600"/>

You can also search for Promises by typing a query in the search box.

To clear the currently logged Promises, click on the clear icon on the
top left of the tab.

### Inspecting Settled Values

If the fulfillment value of a Promise is an Ember object or an array, you can click
on that object to open it in the Object Inspector.

<img src="/images/guides/ember-inspector/promises-object-inspector.png" width="400"/>

If the rejection value is an `Error` object, you can send its stack trace to
the console.

<img src="/images/guides/ember-inspector/promises-error.png" width="400"/>

You can also click on the `$E` button to send the value to the console.

### Tracing

The Inspector provides a way to view a Promise's stack trace.
Tracing Promises is disabled by default for performance reasons. To
enable tracing, check the `Trace promise` checkbox. You may want to
reload to trace existing Promises.

<img src="/images/guides/ember-inspector/promises-trace-checkbox.png"
width="200"/>

To trace a Promise, click on the `Trace` button next to the label,
which will send the Promise stack trace to the console.

<img src="/images/guides/ember-inspector/promises-trace.png" width="300"/>

### Labeling Promises

Promises generated by Ember are all labeled by default.
You can also label your own RSVP Promises to find them in the Inspector's Promises tab.
All RSVP methods can take a label as the final argument.

```javascript

var label = 'Find Posts'

new RSVP.Promise(method, label);

RSVP.Promise.resolve(value, label);

RSVP.Promise.reject(reason, label);

RSVP.Promise.all(array, label);

RSVP.Promise.hash(hash, label);

promise.then(success, failure, label);

promise.catch(callback, label);

promise.finally(callback, label);

```