[d24f17c] | 1 | import _curry2 from "./internal/_curry2.js";
|
---|
| 2 | import _isFunction from "./internal/_isFunction.js";
|
---|
| 3 | import curryN from "./curryN.js";
|
---|
| 4 | import toString from "./toString.js";
|
---|
| 5 | /**
|
---|
| 6 | * Given an `arity` (Number) and a `name` (String) the `invoker` function
|
---|
| 7 | * returns a curried function that takes `arity` arguments and a `context`
|
---|
| 8 | * object. It will "invoke" the `name`'d function (a method) on the `context`
|
---|
| 9 | * object.
|
---|
| 10 | *
|
---|
| 11 | * @func
|
---|
| 12 | * @memberOf R
|
---|
| 13 | * @since v0.1.0
|
---|
| 14 | * @category Function
|
---|
| 15 | * @sig Number -> String -> (a -> b -> ... -> n -> Object -> *)
|
---|
| 16 | * @param {Number} arity Number of arguments the returned function should take
|
---|
| 17 | * before the target object.
|
---|
| 18 | * @param {String} method Name of any of the target object's methods to call.
|
---|
| 19 | * @return {Function} A new curried function.
|
---|
| 20 | * @see R.construct
|
---|
| 21 | * @example
|
---|
| 22 | * // A function with no arguments
|
---|
| 23 | * const asJson = invoker(0, "json")
|
---|
| 24 | * // Just like calling .then((response) => response.json())
|
---|
| 25 | * fetch("http://example.com/index.json").then(asJson)
|
---|
| 26 | *
|
---|
| 27 | * // A function with one argument
|
---|
| 28 | * const sliceFrom = invoker(1, 'slice');
|
---|
| 29 | * sliceFrom(6, 'abcdefghijklm'); //=> 'ghijklm'
|
---|
| 30 | *
|
---|
| 31 | * // A function with two arguments
|
---|
| 32 | * const sliceFrom6 = invoker(2, 'slice')(6);
|
---|
| 33 | * sliceFrom6(8, 'abcdefghijklm'); //=> 'gh'
|
---|
| 34 | *
|
---|
| 35 | * // NOTE: You can't simply pass some of the arguments to the initial invoker function.
|
---|
| 36 | * const firstCreditCardSection = invoker(2, "slice", 0, 4)
|
---|
| 37 | * firstCreditCardSection("4242 4242 4242 4242") // => Function<...>
|
---|
| 38 | *
|
---|
| 39 | * // Since invoker returns a curried function, you may partially apply it to create the function you need.
|
---|
| 40 | * const firstCreditCardSection = invoker(2, "slice")(0, 4)
|
---|
| 41 | * firstCreditCardSection("4242 4242 4242 4242") // => "4242"
|
---|
| 42 | *
|
---|
| 43 | * @symb R.invoker(0, 'method')(o) = o['method']()
|
---|
| 44 | * @symb R.invoker(1, 'method')(a, o) = o['method'](a)
|
---|
| 45 | * @symb R.invoker(2, 'method')(a, b, o) = o['method'](a, b)
|
---|
| 46 | */
|
---|
| 47 |
|
---|
| 48 | var invoker =
|
---|
| 49 | /*#__PURE__*/
|
---|
| 50 | _curry2(function invoker(arity, method) {
|
---|
| 51 | return curryN(arity + 1, function () {
|
---|
| 52 | var target = arguments[arity];
|
---|
| 53 |
|
---|
| 54 | if (target != null && _isFunction(target[method])) {
|
---|
| 55 | return target[method].apply(target, Array.prototype.slice.call(arguments, 0, arity));
|
---|
| 56 | }
|
---|
| 57 |
|
---|
| 58 | throw new TypeError(toString(target) + ' does not have a method named "' + method + '"');
|
---|
| 59 | });
|
---|
| 60 | });
|
---|
| 61 |
|
---|
| 62 | export default invoker; |
---|