API Docs for: v2.11.0
Show:

File: packages/ember-utils/lib/owner.js

/**
@module ember
@submodule ember-runtime
*/

import symbol from './symbol';

export const OWNER = symbol('OWNER');

/**
  Framework objects in an Ember application (components, services, routes, etc.)
  are created via a factory and dependency injection system. Each of these
  objects is the responsibility of an "owner", which handled its
  instantiation and manages its lifetime.

  `getOwner` fetches the owner object responsible for an instance. This can
  be used to lookup or resolve other class instances, or register new factories
  into the owner.

  For example, this component dynamically looks up a service based on the
  `audioType` passed as an attribute:

  ```
  // app/components/play-audio.js
  import Ember from 'ember';

  // Usage:
  //
  //   {{play-audio audioType=model.audioType audioFile=model.file}}
  //
  export default Ember.Component.extend({
    audioService: Ember.computed('audioType', function() {
      let owner = Ember.getOwner(this);
      return owner.lookup(`service:${this.get('audioType')}`);
    }),
    click() {
      let player = this.get('audioService');
      player.play(this.get('audioFile'));
    }
  });
  ```

  @method getOwner
  @for Ember
  @param {Object} object An object with an owner.
  @return {Object} An owner object.
  @since 2.3.0
  @public
*/
export function getOwner(object) {
  return object[OWNER];
}

/**
  `setOwner` forces a new owner on a given object instance. This is primarily
  useful in some testing cases.

  @method setOwner
  @for Ember
  @param {Object} object An object instance.
  @param {Object} object The new owner object of the object instance.
  @since 2.3.0
  @public
*/
export function setOwner(object, owner) {
  object[OWNER] = owner;
}