mirror of
https://github.com/musix-org/musix-oss
synced 2024-11-10 11:20:19 +00:00
30 lines
703 B
JavaScript
30 lines
703 B
JavaScript
|
/**
|
||
|
* This method invokes `interceptor` and returns `value`. The interceptor
|
||
|
* is invoked with one argument; (value). The purpose of this method is to
|
||
|
* "tap into" a method chain sequence in order to modify intermediate results.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @since 0.1.0
|
||
|
* @category Seq
|
||
|
* @param {*} value The value to provide to `interceptor`.
|
||
|
* @param {Function} interceptor The function to invoke.
|
||
|
* @returns {*} Returns `value`.
|
||
|
* @example
|
||
|
*
|
||
|
* _([1, 2, 3])
|
||
|
* .tap(function(array) {
|
||
|
* // Mutate input array.
|
||
|
* array.pop();
|
||
|
* })
|
||
|
* .reverse()
|
||
|
* .value();
|
||
|
* // => [2, 1]
|
||
|
*/
|
||
|
function tap(value, interceptor) {
|
||
|
interceptor(value);
|
||
|
return value;
|
||
|
}
|
||
|
|
||
|
module.exports = tap;
|