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; |
---|