v3.1.0

Compare Source

• Addedq.pushAsync andq.unshiftAsync, analagous toq.push andq.unshift, except they always do not accept a callback, and reject if processing the task errors. (#​1659)
• Promises returned fromq.push andq.unshift when a callback is not passed now resolve even if an error ocurred. (#​1659)
• Fixed a parsing bug inautoInject with complicated function bodies (#​1663)
• Added ES6+ configuration for Browserify bundlers (#​1653)
• Various doc fixes (#​1664,#​1658,#​1665,#​1652)

v3.0.1

Compare Source

Bug fixes

• Fixed a regression where arrays passed toqueue andcargo would be completely flattened. (#​1645)
• Clarified Async's browser support (#​1643)

v3.0.0

Compare Source

Theasync/await release!

There are a lot of new features and subtle breaking changes in this major version, but the biggest feature is that most Async methods return a Promise if you omit the callback, meaning you canawait them from within anasync function.

constresults=awaitasync.mapLimit(urls,5,asyncurl=>{constresp=awaitfetch(url)returnresp.body})

Breaking Changes

• Most Async methods return a Promise when the final callback is omitted, making themawait-able! (#​1572)
• We are now making heavy use of ES2015 features, this means we have dropped out-of-the-box support for Node 4 and earlier, and many old versions of browsers. (#​1541,#​1553)
• Inqueue,priorityQueue,cargo andcargoQueue, the "event"-style methods, likeq.drain andq.saturated are now methods that register a callback, rather than properties you assign a callback to. They are now of the formq.drain(callback). If you do not pass a callback a Promise will be returned for the next occurrence of the event, making themawait-able, e.g.await q.drain(). (#​1586,#​1641)
• Callingcallback(false) will cancel an async method, preventing further iteration and callback calls. This is useful for preventing memory leaks when you break out of an async flow by calling an outer callback. (#​1064,#​1542)
• during anddoDuring have been removed, and insteadwhilst,doWhilst,until anddoUntil now have asynchronoustest functions. (#​850,#​1557)
• limits of less than 1 now cause an error to be thrown in queues and collection methods. (#​1249,#​1552)
• memoize no longer memoizes errors (#​1465,#​1466)
• applyEach/applyEachSeries have a simpler interface, to make them more easily type-able. It always returns a function that takes in a single callback argument. If that callback is omitted, a promise is returned, making it awaitable. (#​1228,#​1640)

New Features

• Async generators are now supported in all the Collection methods. (#​1560)
• AddedcargoQueue, a queue with bothconcurrency andpayload size parameters. (#​1567)
• Queue objects returned fromqueue now have aSymbol.iterator method, meaning they can be iterated over to inspect the current list of items in the queue. (#​1459,#​1556)
• A ESM-flavoredasync.mjs is included in theasync package. This is described in thepackage.json"module" field, meaning it should be automatically used by Webpack and other compatible bundlers.

Bug fixes

• Better handle arbitrary error objects inasyncify (#​1568,#​1569)

Other

• Removed Lodash as a dependency (#​1283,#​1528)
• Miscellaneous docs fixes (#​1393,#​1501,#​1540,#​1543,#​1558,#​1563,#​1564,#​1579,#​1581)
• Miscellaneous test fixes (#​1538)