Class: TaskProperty

This behaves like the task(...).on() modifier, but instead will cause the task to be canceled if any of the specified events fire on the parent object.

See the Live Example

Logs lifecycle events to aid in debugging unexpected Task behavior. Presently only logs cancelation events and the reason for the cancelation, e.g. "TaskInstance 'doStuff' was canceled because the object it lives on was destroyed or unrendered"

Configures the task to immediately cancel (i.e. drop) any task instances performed when the task is already running at maxConcurrency. Sets default maxConcurrency to 1.

Configures the task to run task instances one-at-a-time in the order they were .perform()ed. Sets default maxConcurrency to 1.

Activates lifecycle events, allowing Evented host objects to react to task state changes.

export default Component.extend({
  uploadTask: task(function* (file) {
    // ... file upload stuff
  }).evented(),

  uploadedStarted: on('uploadTask:started', function(taskInstance) {
    this.analytics.track("User Photo: upload started");
  }),
});

Adds this task to a TaskGroup so that concurrency constraints can be shared between multiple tasks.

See the Task Group docs for more information

Configures the task to drop all but the most recently performed TaskInstance.

Sets the maximum number of task instances that are allowed to run at the same time. By default, with no task modifiers applied, this number is Infinity (there is no limit to the number of tasks that can run at the same time). .restartable, .enqueue, and .drop set the default maxConcurrency to 1, but you can override this value to set the maximum number of concurrently running tasks to a number greater than 1.

See the AJAX Throttling example

The example below uses a task with maxConcurrency(3) to limit the number of concurrent AJAX requests (for anyone using this task) to 3.

doSomeAjax: task(function * (url) {
  return fetch(url);
}).maxConcurrency(3),

elsewhere() {
  this.doSomeAjax.perform("http://www.example.com/json");
},

This behaves like the task(...).on() modifier, but instead will cause the task to be performed if any of the specified properties on the parent object change.

Calling task(...).on(eventName) configures the task to be automatically performed when the specified events fire. In this way, it behaves like Ember.on.

You can use task(...).on('init') to perform the task when the host object is initialized.

export default Component.extend({
  pollForUpdates: task(function * () {
    // ... this runs when the Component is first created
    // because we specified .on('init')
  }).on('init'),

  handleFoo: task(function * (a, b, c) {
    // this gets performed automatically if the 'foo'
    // event fires on this Component,
    // e.g., if someone called component.trigger('foo')
  }).on('foo'),
});

Configures the task to call the passed in callback for derived state updates, overriding the default derived state tracking. You may call with null to completely opt-out of derived state tracking.

Configures the task to cancel old currently task instances to make room for a new one to perform. Sets default maxConcurrency to 1.

See the Live Example