1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
|
{{alias}}( fcn, predicate, done[, thisArg] )
Invokes a function while a test condition is true.
The condition is evaluated *after* executing the provided function; thus,
`fcn` *always* executes at least once.
The function to invoke is provided two arguments:
- `i`: iteration number (starting from zero)
- `next`: a callback which must be invoked before proceeding to the next
iteration
The first argument of the `next` callback is an `error` argument. If `fcn`
calls the `next` callback with a truthy `error` argument, the function
suspends execution and immediately calls the `done` callback for subsequent
`error` handling.
The predicate function is provided two arguments:
- `i`: iteration number (starting from one)
- `clbk`: a callback indicating whether to invoke `fcn`
The `clbk` function accepts two arguments:
- `error`: error argument
- `bool`: test result
If the test result is truthy, the function continues invoking `fcn`;
otherwise, the function invokes the `done` callback.
The `done` callback is invoked with an `error` argument and any arguments
passed to the final `next` callback.
Execution is *not* guaranteed to be asynchronous. To guarantee asynchrony,
wrap the `done` callback in a function which either executes at the end of
the current stack (e.g., `nextTick`) or during a subsequent turn of the
event loop (e.g., `setImmediate`, `setTimeout`).
Parameters
----------
fcn: Function
The function to invoke.
predicate: Function
The predicate function which indicates whether to continue invoking a
function.
done: Function
Callback to invoke upon completion.
thisArg: any (optional)
Execution context for the invoked function.
Examples
--------
> function fcn( i, next ) {
... setTimeout( onTimeout, i );
... function onTimeout() {
... next( null, 'boop'+i );
... }
... };
> function predicate( i, clbk ) { clbk( null, i < 5 ); };
> function done( error, result ) {
... if ( error ) {
... throw error;
... }
... console.log( result );
... };
> {{alias}}( fcn, predicate, done )
boop: 4
See Also
--------
|
