Ember.js addon for lifecycle aware async tasks and DOM events.
npm install ember-lifeline!CI Build
Ember applications have long life-cycles. A user may navigate to several pages
and use many different features before they leave the application. This
makes JavaScript and Ember development unlike Rails development, where the
lifecycle of a request is short and the environment disposed of after
each request. It makes Ember development much more like iOS or video game
development than traditional server-side web development.
This addon introduces several functional utility methods to help manage async, object
lifecycles, and the Ember runloop. These tools should provide a simple developer
experience that allows engineers to focus on the business domain, and think less
about the weird parts of working in a long-lived app.
The documentation website contains more examples and API information.
ember install ember-lifeline
Ember Lifeline supports a functional API that enables entanglement - _the association of async behavior to object instances_. This allows you to write async code in your classes that can be automatically cleaned up for you when the object is destroyed.
Ember's runloop functions, like the example below, don't ensure that an object's async is cleaned up.
``js
import Component from '@ember/component';
import { run } from '@ember/runloop';
export default Component.extend({
init() {
this._super(...arguments);
run.later(() => {
this.set('date', new Date());
}, 500);
},
});
`
Using ember-lifeline's equivalent, in this case runTask, can help ensure that any active async is cleaned up once the object is destroyed.
`js
import Component from '@ember/component';
import { runTask, runDisposables } from 'ember-lifeline';
export default Component.extend({
init() {
this._super(...arguments);
runTask(
this,
() => {
this.set('date', new Date());
},
500
);
},
willDestroy() {
this._super(...arguments);
runDisposables(this);
},
});
`
For more information and examples, please visit the documentation website.
See the Contributing guide for details.
This addon was developed internally at Twitch, written originally by @mixonic and @rwjblue. It's since been further developed and maintained by scalvert.
The name ember-lifeline` was suggested by @nathanhammod.