1 |
3a515b92
|
cagy
|
/**
|
2 |
|
|
* This method invokes `interceptor` and returns `value`. The interceptor
|
3 |
|
|
* is invoked with one argument; (value). The purpose of this method is to
|
4 |
|
|
* "tap into" a method chain sequence in order to modify intermediate results.
|
5 |
|
|
*
|
6 |
|
|
* @static
|
7 |
|
|
* @memberOf _
|
8 |
|
|
* @since 0.1.0
|
9 |
|
|
* @category Seq
|
10 |
|
|
* @param {*} value The value to provide to `interceptor`.
|
11 |
|
|
* @param {Function} interceptor The function to invoke.
|
12 |
|
|
* @returns {*} Returns `value`.
|
13 |
|
|
* @example
|
14 |
|
|
*
|
15 |
|
|
* _([1, 2, 3])
|
16 |
|
|
* .tap(function(array) {
|
17 |
|
|
* // Mutate input array.
|
18 |
|
|
* array.pop();
|
19 |
|
|
* })
|
20 |
|
|
* .reverse()
|
21 |
|
|
* .value();
|
22 |
|
|
* // => [2, 1]
|
23 |
|
|
*/
|
24 |
|
|
function tap(value, interceptor) {
|
25 |
|
|
interceptor(value);
|
26 |
|
|
return value;
|
27 |
|
|
}
|
28 |
|
|
|
29 |
|
|
module.exports = tap;
|