summaryrefslogtreecommitdiff
path: root/lib/doUntil.js
diff options
context:
space:
mode:
authorHubert Argasinski <argasinski.hubert@gmail.com>2016-03-31 02:22:16 -0700
committerGraeme Yeates <yeatesgraeme@gmail.com>2016-04-12 18:46:28 -0400
commit8eb2a7cec2c62edf35d7b812765bd64e6b7d484f (patch)
tree76a0c7715c612acddd9e6801dc14ec43f768176f /lib/doUntil.js
parenta778ee63788d533111ff63b611cc5034e18a907f (diff)
downloadasync-8eb2a7cec2c62edf35d7b812765bd64e6b7d484f.tar.gz
jsdoc-style documentation began documenting `Control Flow` methods
remaining `Control Flow` methods to document: - queue - priorityQueue - cargo - auto - autoInject - retry - retryable - iterator - times, timesSeries, timesLimit - race
Diffstat (limited to 'lib/doUntil.js')
-rw-r--r--lib/doUntil.js19
1 files changed, 19 insertions, 0 deletions
diff --git a/lib/doUntil.js b/lib/doUntil.js
index d5f2b83..e5c48c9 100644
--- a/lib/doUntil.js
+++ b/lib/doUntil.js
@@ -2,6 +2,25 @@
import doWhilst from './doWhilst';
+/**
+ * Like [`doWhilst`](#doWhilst), except the `test` is inverted. Note the
+ * argument ordering differs from `until`.
+ *
+ * @name doUntil
+ * @static
+ * @memberOf async
+ * @see `async.doWhilst`
+ * @category Control Flow
+ * @param {Function} fn - A function which is called each time `test` fails.
+ * The function is passed a `callback(err)`, which must be called once it has
+ * completed with an optional `err` argument. Invoked with (callback).
+ * @param {Function} test - synchronous truth test to perform before each
+ * execution of `fn`. Invoked with ().
+ * @param {Function} [callback] - A callback which is called after the test
+ * function has passed and repeated execution of `fn` has stopped. `callback`
+ * will be passed an error and any arguments passed to the final `fn`'s
+ * callback. Invoked with (err, [results]);
+ */
export default function doUntil(iteratee, test, cb) {
return doWhilst(iteratee, function() {
return !test.apply(this, arguments);