- Adds Object.assign polyfill so that tests pass on on non-supporting browsers for apps that don't set includePolyfill:true
- Upgraded ember-maybe-import-regenerator so that other addons can consume/depend on ember-concurrency without making the end user have to make any additional configuration to support transpiled generator function syntax.
- Upgraded to more Node-backwards-compatible version of ember-maybe-import-regenerator.
- You no longer have to set
includePolyfill:true
in ember-cli-build.js as a requirement for using ember-concurrency.regenerator-runtime
is now provided by https://github.com/machty/ember-maybe-import-regenerator, which gracefully no-ops if you still want to keepincludePolyfill:true
. Babel's polyfill is 98kb minified, whereas the regenerator runtime is only 4kb minified.
- When using Ember 2.5.0 or higher, you can now pass task objects
directly to the closure
action
helper, e.g.onclick={{action myTask 1 2 3}}
. This works exactly the same asonclick={{perform myTask 1 2 3}}
but it's nice because any component that fires actions using the(action)
helper can now directly be passed a task and have it run properly, rather than having to cast to an action using the(perform)
helper.
- removed any attempt to auto-polyfill using babel.includePolyfill, fixing #57. The auto-polyfill was never working reliably so it shouldn't break anyone's code.
- (perform) and (cancel-all) helpers no longer cause run loop autoruns
- The .keepLatest() task modifier has been redocumented due to popular demand; it's useful for when you want to enqueue only the most recent intermediate .perform() and drop everything in between.
- Support for Ember 1.13.0
- within a task generator function, TaskCancelation "errors" are longer "catchable" in the catch block of a try/catch. This means you no longer have to check if the error thrown is a cancelation in order to handle it differently than an exception.
- That said, since promises have no concept of cancelation, if
you perform a task within a promise (or you call
someTask.perform().then(...).catch(...)
), then any promisecatch
handlers will be called with TaskCancelation "errors", and if you need to distinguish between cancelation and exceptions thrown, you can import and use the newdidCancel
utility function, which returns true if the error passed to it is a TaskCancelation. Previously, the only safe way to test this was to checkerr && err.name === 'TaskCancelation'
; now you can justimport { didCancel } from 'ember-concurrency'
and checkdidCancel(err)
.
- bugfix: errors that bubble throw arbitrary depths of child tasks will only call window/Ember.onerror once
- bugfix: errors thrown from child tasks don't "rethrow" when caught by parent task
- Fixed bug when using ember-concurrency in an addon that is consumed by another app. #46
- feature: Task Groups: http://ember-concurrency.com/#/docs/task-groups. Task Groups let you enforce concurrency constraints across multiple tasks, which previously wasn't possible.
- feature: Moar Derived State: http://ember-concurrency.com/#/docs/derived-state
Task Instances now expose .value and .error properties for the
value returned from the task function, or the error thrown from it.
Furthermore: Task objects expose
last
andlastSuccessful
, which point to recently performed TaskInstances, which then make it possible to idiomatically access .value and .error, e.g.{{myTask.last.value}}
or{{myTask.last.error}}
. This is a continuation of ember-concurrency's goal of exposing as much Derived State as possible, and minimizing boilerplate. - feature: .observes() Task Modifier: appending .observes('foo', 'bar') to a task will automatically perform the task when 'foo' or 'bar' changes. Thanks to @ofbriggs for co-authoring this feature.
- bugfix: once an object is destroyed, any attempts to perform a task on that object will be immediately canceled.
- experimental: support for linking tasks
- bugfix: timeout() internally uses Ember.run.later() now so that Ember testing helpers know to wait for it. Note: this means that infinite loops in tasks that pause with a timer can pause your acceptance tests until they timeout unless you break the loop somehow; one way to do this is to call Ember.run.cancelTimers()
- bugfix: fixed a few more corner cases where a TaskCancelation error unnecessarily bubbled to the top even though the user hadn't opted into handling cancelations (by calling .then() on the TaskInstance returned from task.perform()).
- bugfix: don't set taskInstance.isCanceled to true if cancel() is called after a successful finish.
- bugfix: No longer treat the most recent yield as the implicit return of a function.
- bugfix: perform helper returns the performed TaskInstance
- bugfix: perform helper properly curries arguments
- Added perform and cancel-all helper for a more familiar
approach to calling tasks from templates:
onclick={{perform taskName 1 2 3}}
andonclick={{cancel-all taskName}}
- EXPERIMENTAL: integration with observables via
subscribe
function
- Prevent promises from being swallowed in some cases
- EXPERIMENTAL: Task#performWillSucceed boolean property
- EXPERIMENTAL: TaskProperty#.performs() for linking to tasks you intend to call.
- added Task-aware/cancelable variant of Promise.race
- added Task-aware/cancelable variant of Promise.all for joining multiple child tasks.
- added task(...).cancelOn('eventName'), which calls cancelAll() on the task whenever the event is fired
- .state properties for Tasks and TaskInstances
- task.cancelAll() cancels all running/pending task instances
- taskInstance.cancel() cancels an individual instance
- Added .maxConcurrency(n) task modifier which works in conjunction with the other task modifiers.
nameOfTask.perform()
returns a Task Instance, which represents a single execution of that task which might be cancelled, dropped, or run to completion. It exposes a .cancel() method and other properties like .isRunning or .isFinished
- First stable version since re-working the docs site
- No more reliance on js-csp, or CSP concepts whatsoever