Installation
ember install ember-promise-helpers
Description
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:
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
await
The await
helper also works anywhere, because it's just a Handlebars
subexpression. For example, you can pass it to a another helper...
Or passing it to a component:
is-pending
Resolves with false
if the promise resolved or rejected, otherwise
true until the promise resolves or rejects.
is-rejected
Resolves with false
if the promise rejects or fails, false
otherwise. Initial value is null
until the promise is resolved.
is-fulfilled
Resolves with true
if the promise resolved successfully, false
otherwise. Initial value is null
until the promise is resolved.
promise-rejected-reason
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'));
})
});
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:
Development Installation
git clone
this repositorynpm install
bower install
Running
ember server
- Visit your app at http://localhost:4200.
Running Tests
npm test
(Runsember try:testall
to test your addon against multiple Ember versions)ember test
ember test --server
Building
ember build
For more information on using ember-cli, visit http://www.ember-cli.com/.