The default blueprint for ember-cli addons.
Last updated a year ago by fivetanley .
MIT · Original npm · Tarball · package.json
$ cnpm install ember-promise-helpers 
SYNC missed versions from official npm registry.

Ember Promise Helpers Build Status


ember install ember-promise-helpers


When Ember's templates encounter a promise, it won't re-render it when the promise is resolved or rejected. For an example of the problem (where model is a specific single model, not an RSVP.hash):

{{#if model.author}}
  The author is: {{model.author.name}}
  No author!

If model.author is a promise (like a an Ember Data belongsTo relationship), the template will always contain the text: "The author is:", rather than "No author!".

Ember Promise Helpers allow you to work with Promises easily in your Ember templates, without wrapping your objects with something like Ember.PromiseProxyMixin in the Route, Controller, or Component.

Example Usage


{{#if (await model.author)}}
  {{get (await model.author) 'name'}}
  No author!

The await helper also works anywhere, because it's just a Handlebars subexpression. For example, you can pass it to another helper...

{{#each (await model.comments) as |comment|}}
  {{comment.author}} wrote {{comment.text}}

Or pass it to a component:

{{twitter-timeline users=(await user.following)}}

Or use it by itself:

{{await model.title}}


Resolves with false if the promise resolved or rejected, otherwise true until the promise resolves or rejects.

  {{#if (is-pending promise)}}
    <img src="loading.gif"/>


Resolves with true if the promise rejects or fails, false otherwise. Initial value is null until the promise is resolved.

  {{#unless (is-pending promise)}}
    {{#if (is-rejected promise)}}
      rejected! :(((


Resolves with true if the promise resolved successfully, false otherwise. Initial value is null until the promise is resolved.

  {{#unless (is-pending promise)}}
    {{#if (is-fulfilled promise)}}
      Yay it worked!
      Oh :(


Gives you the error or reason as to why a promise was rejected. Null until the promise rejects or if the promise resolves. For example:

// app/controllers/index.js
import Ember from 'ember';

export default Ember.Controller.extend({
  promise: Ember.computed(function() {
    return Ember.RSVP.reject(new Error('whoops'));
{{! app/templates/index.js }}

{{#if (is-rejected promise)}}
  The error was {{get (promise-rejected-reason promise) 'message'}}.


Uses the Ember.RSVP.all function to create a promise. It also accepts 1..n promises as arguments or an array as first argument.

  {{#if (is-pending (promise-all promise1 promise2))}}
    <img src="loading.gif"/>
  {{#if (is-pending (promise-all promiseArray))}}
    <img src="loading.gif"/>


Uses the Ember.RSVP.hash function to create a promise.

  {{#if (is-pending (promise-hash foo=promise1 bar=promise2))}}
    <img src="loading.gif"/>

This would render "The error was whoops."

Proposed Block Helper syntax (Not implemented!)

If you want to know when a promise becomes rejected or resolved, you can use the await-promise component, which gives you an error property if the promise becomes rejected (similar to calling .catch on a promise.). Another isFulfilled argument is passed for you to handle loading state:

{{#await-promise model.author as |author error isFulfilled|}}
  {{#if isFulfilled}}

    {{#unless error}}

      {{#if author}}
        The author is: {{author.name}}
        There is no author!

      Oops! The error was {{error.message}}


Development Installation

  • git clone this repository
  • yarn


  • ember test – Runs the test suite on the current Ember version
  • ember test --server – Runs the test suite in "watch mode"
  • ember try:each – Runs the test suite against multiple Ember versions

Running Tests

  • npm test (Runs ember try:testall to test your addon against multiple Ember versions)
  • ember test
  • ember test --server


  • ember build

For more information on using ember-cli, visit http://www.ember-cli.com/.

Current Tags

  • 1.0.9                                ...           latest (a year ago)

9 Versions

  • 1.0.9                                ...           a year ago
  • 1.0.8                                ...           a year ago
  • 1.0.6                                ...           3 years ago
  • 1.0.5                                ...           3 years ago
  • 1.0.4                                ...           3 years ago
  • 1.0.3                                ...           4 years ago
  • 1.0.2                                ...           5 years ago
  • 1.0.1                                ...           5 years ago
  • 1.0.0                                ...           5 years ago

Copyright 2014 - 2016 © taobao.org |