# ember-devtools

> A collection of useful functions for developing Ember apps

Latest version **6.0.0** (published 2017-06-14) · MIT license · 0 weekly downloads

## Install

```sh
npm install ember-devtools
pnpm add ember-devtools
yarn add ember-devtools
bun add ember-devtools
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 6.0.0 |
| Published | 2017-06-14 |
| First published | 2014-07-16 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >= 4 |
| Dependencies | 2 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | aexmachina |
| Keywords | ember-addon |

## Links

- npm: https://www.npmjs.com/package/ember-devtools
- npm.io page: https://npm.io/package/ember-devtools

## Dependencies (2)

- [object-assign](https://npm.io/package/object-assign.md) ^4.1.1
- [ember-cli-babel](https://npm.io/package/ember-cli-babel.md) ^6.0.0

## Recent versions

- 6.0.0 (latest) — 2017-06-14
- 5.1.1 — 2016-09-26
- 5.1.0 — 2016-09-05
- 5.0.1 — 2016-08-24
- 5.0.0 — 2016-08-23
- 4.4.6 — 2016-07-19
- 4.4.5 — 2016-05-23
- 4.4.4 — 2016-03-02
- 4.4.3 — 2016-02-24
- 4.4.2 — 2016-02-23
- 4.4.1 — 2016-02-16
- 4.4.0 — 2016-02-12
- 4.3.3 — 2016-02-11
- 4.3.2 — 2016-02-10
- 4.3.1 — 2016-02-10
- … 20 more at https://npm.io/package/ember-devtools/versions

## README

[<img align='right' alt='Build Status' src='https://travis-ci.org/aexmachina/ember-devtools.png'>](https://travis-ci.org/aexmachina/ember-devtools)

# ember-devtools

#### [Visit project page and demo](http://simonwade.me/ember-devtools)

A collection of useful functions for developing Ember apps. Best served from the console.

## Usage

ember-devtools is an `Ember.Service` that is most useful when available in the devtools 
console. The simplest was access this from the console is using
a global variable (eww!) which can be defined in `config/environment.js`.

```js
var ENV = {
  'ember-devtools': {
    global: true,
    enabled: environment === 'development'
  }
}
```

Setting `global` will allow access to the `devTools` functions globally (eg. you can 
run `routes()` in the console). If you'd prefer these functions to be under a prefix 
set `global: 'devTools'` for `devTools.routes()`.

The `enabled` option will enable the addon. By default, this addon will only be included in the `development` environment.

Alternatively you can use `Ember.inject.service('ember-devtools')` or `appInstance.lookup('service:ember-devtools')`.

## Functions

### `app([name])`

Returns the named application. `name` defaults to `main`.

### `routes()`

Returns the names of all routes.

### `route([name])`

Returns the named route. `name` defaults to the current route.

### `router([name])`

Returns the named router instance. `name` defaults to `main`.

### `model([name])`

Returns the model for the named controller. `name` defaults to the the current route.

### `service(name)`

Performs a lookup for the named service in the `owner` (using `'service:' + name`).

### `controller([name])`

Returns the named controller. `name` defaults to the current route.

### `log(promise[, property[, getEach]])`

Resolves the `promise` and logs the resolved value using `console.log`.
Also sets `window.$E` to the resolved value so you can access it in the dev
tools console.

If `property` is specified then `$E.get(property)` will be logged.

If `getEach` is true then `$E.getEach(property)` will be logged.

#### Examples:

```
> log(store.find('organisation')) => undefined
> $E.get('length') => 3
> log(store.find('organisation'), 'length') => 3
> log(store.find('organisation'), 'name', true) => array of names
```

### `lookup(name)`

Performs a lookup for the named entry in the `owner`, which will in turn
ask its `resolver` if it's not found.

### `resolveRegistration(name)`

Performs a lookup for the named factory in the `registry`.

### `ownerNameFor(obj)`

Searches the `owner` to find the name for the specified object (if any).

### `inspect`

Does what it says, in a manner of speaking. Alias to `Ember.inspect`.

### `logResolver(bool = true)`

Switch logging for the resolver on or off.

### `logAll(bool = true)`

Switch logging for all the things on/off.

### `logRenders()`

Logs the rendering duration (in milliseconds) of each component, view and helper.

### `globalize()`

Attach all of these useful functions to the `window` object (eww!) - useful
for accessing in the console.

### `getOwner(obj = this)`

The owner of the service or specified `obj`.

### `config()`

Returns the Application config

## Properties

### `owner`

The owner of the service. n.b. this is not globalised (to avoid conflict with `window.owner`), use `getOwner()` instead.
 
### `store`

The Ember Data `Store`.

### `typeMaps`

The Ember Data 'type map'.

## Installation

### Ember CLI

	npm install ember-devtools --save-dev

### Upgrading From v2.0

ember-devtools is now dependent on ember-cli.

## Changelog

- v6: `container` and `containerNameFor` are now `owner` and `ownerNameFor`

---
_Source: https://npm.io/package/ember-devtools · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._