CHANGELOG.md

Changelog

0.8.0

• POSSIBLE BREAKING CHANGE: the internal task scheduler has been rewritten to be more performant, but to also more immediately start executing task functions. Prior to this version, perform()ing a task wouldn't actually start executing the task function until the actions queue on the run loop; this behavior was inconsistent with the timing of async functions, and meant that certain lifecycle hooks that depended on logic being run synchronously couldn't be used with ember-concurrency Tasks (because they already missed their window of execution). This is unlikely to break anyone's apps, but it's possible some apps out there have subtle timing dependencies on tasks running within run loop queues, so it's better to announce this as a possible breaking change. (#107)
• Derived state: Task Instances now have an additional isSuccessful and isError property (#119)
• Derived state: Tasks expose performCount that tracks how many times a task has been performed.
• waitForEvent and waitForQueue for pausing the task until a jQuery / Ember event occurs, or until a particular run loop queue has been reached.

0.7.19

• Added the ability to extend/wrap/decorate TaskPropertys (the value returned from task(), so that things like task test waiter APIs can be built without having to merge such functionality into the main EC repo. TL;DR, the .taskFn property is exposed, so it can be swapped out with another generator fn with wrapping code around yield * originalTaskFn.call(this, arg) (#116 + #117)

0.7.18

• TaskGroup.isRunning always returns a Boolean (#112)
• Fix Ember.K deprecation warnings (#110)

0.7.17

• The (perform) helper won't throw an error when passed a non-Task until the helper is actually invoked (e.g. a button is clicked). Previously it would error more eagerly, right at first render, which was often a poor dev experience and at odds with the (action) helper's behavior.

0.7.16

• Fixed Ember 2.10 error when passing (hash) helper values as an arg to a task (#99)
• Using ember-owner-polyfill to cut down on bloat

0.7.15

• BREAKING: revert the feature introduced in 0.7.11 for being able to do this.myTask.perform() instead of this.get('myTask').perform(). The internal semantics of ember-metal are too different between versions of Ember to be able to support this with any confidence; we'll just have to wait for ES5 getter syntax to come to Computed Properties in general in order to support this. Apologies for too eagerly introducing this broken feature.

0.7.14

• no functional changes; just removed unneeded files from NPM package to decrease package size

0.7.13

• fix not being able to mock tasks in tests (#84) and other related bugs

0.7.12

• fix tasks not being overridable in subclass (#81)

0.7.11

• support for this.myTask.perform(), i.e. you can get a reference to a Task using simple JavaScript accessors rather than having to write this.get('myTask').perform()

0.7.10

• tasks can be tested in component integration tests (#66)
• deprecation: using .maxConcurrency() without any other task modifier will produce a deprecation warning because it is unclear/ambiguous as to how to constrain concurrency in such a case (#79)

0.7.9

• Add task-aware allSettled promise equivalent (#75)

0.7.8

• Adds Object.assign polyfill so that tests pass on on non-supporting browsers for apps that don't set includePolyfill:true

0.7.7

• 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.

0.7.6

• Upgraded to more Node-backwards-compatible version of ember-maybe-import-regenerator.

0.7.5

• 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 keep includePolyfill:true. Babel's polyfill is 98kb minified, whereas the regenerator runtime is only 4kb minified.

0.7.4

• 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 as onclick={{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.

0.7.3

• 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.

0.7.2

• (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.

0.7.1

• Support for Ember 1.13.0

0.7.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 promise catch handlers will be called with TaskCancelation "errors", and if you need to distinguish between cancelation and exceptions thrown, you can import and use the new didCancel utility function, which returns true if the error passed to it is a TaskCancelation. Previously, the only safe way to test this was to check err && err.name === 'TaskCancelation'; now you can just import { didCancel } from 'ember-concurrency' and check didCancel(err).

0.6.3

• bugfix: errors that bubble throw arbitrary depths of child tasks will only call window/Ember.onerror once

0.6.2

• bugfix: errors thrown from child tasks don't "rethrow" when caught by parent task

0.6.1

• Fixed bug when using ember-concurrency in an addon that is consumed by another app. #46

0.6.0

• 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 and lastSuccessful, 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.

0.5.17:

• experimental: support for linking tasks

0.5.16:

• 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()).

0.5.15:

• bugfix: don't set taskInstance.isCanceled to true if cancel() is called after a successful finish.

0.5.14:

• bugfix: No longer treat the most recent yield as the implicit return of a function.

0.5.13:

• bugfix: perform helper returns the performed TaskInstance

0.5.12:

• bugfix: perform helper properly curries arguments

0.5.11:

• Added perform and cancel-all helper for a more familiar approach to calling tasks from templates: onclick={{perform taskName 1 2 3}} and onclick={{cancel-all taskName}}

0.5.10:

• EXPERIMENTAL: integration with observables via subscribe function

0.5.9:

• Prevent promises from being swallowed in some cases

0.5.8:

• EXPERIMENTAL: Task#performWillSucceed boolean property
• EXPERIMENTAL: TaskProperty#.performs() for linking to tasks you intend to call.

0.5.7:

• added Task-aware/cancelable variant of Promise.race

0.5.6:

• added Task-aware/cancelable variant of Promise.all for joining multiple child tasks.

0.5.5:

• added task(...).cancelOn('eventName'), which calls cancelAll() on the task whenever the event is fired

0.5.4:

• .state properties for Tasks and TaskInstances
• task.cancelAll() cancels all running/pending task instances
• taskInstance.cancel() cancels an individual instance

0.5.3:

• 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

0.5.0:

• First stable version since re-working the docs site
• No more reliance on js-csp, or CSP concepts whatsoever