ramda.js applySpec

Question

const getMetrics = R.applySpec({
  sum: R.add,
  nested: { mul: R.multiply }
});
getMetrics(2, 4); // => { sum: 6, nested: { mul: 8 } }

ramda.jsのapplySpecについて、非常に情けないのですが、公式ドキュメントを読んでも理解できませんでした。

https://ramdajs.com/docs/#applySpec

コードを読もうとしてもイメージが湧かないです...。
まず

applySpecによって返されるものは関数で、さらに上のように、他の関数をネスト構造で組み込めるのでしょうか。
つまり、

applySpecは関数のセットを作って返すものというイメージでよろしいでしょうか。

そして"applySpecによって作られた関数に付与された引数"は、"内部のそれぞれの関数"に付与されるということでしょうか。

Try Ramdaでは以下のようなコードも動きました...。

const getMetrics = R.applySpec({
  sum: R.add,
  nested: { mul: R.multiply },
  test : (x , y) => { return y - x }
});
getMetrics(2, 4); // => {"nested": {"mul": 8}, "sum": 6, "test": 2}

Answer 1

applySpecによって返されるものは関数

これは間違いありませんね。
値のお尻に()を入れて実行出来るのは関数(もしくはプロパティに保存されたメソッド)だけです。

他の関数をネスト構造で組み込めるのでしょうか。

本文にobject recursively mapping properties to functionsという記述があるので、
オブジェクトのネストにも対応しているそうです。

applySpecは関数のセットを作って返すものというイメージでよろしいでしょうか。

これの目的はspacという名前が付いているように、
バリデートやテストコードがメインでしょうね。

例えばフォームの値をチェックしましょうとなった時、
必須入力項目が3つあるとするじゃないですか、
しかし、普通にtrue or falseを返すだけでは、どの入力項目が空なのかが判別出来ないので個別にあり/なしを検証する必要があり、オブジェクト形式でキーの値がfalseのものを見つけたら入力失敗だったとしたい。
そんな場面で力を発揮しそうです。

えっ、だったら最初からこれでええやんだって！？知らんがな
まぁ、こういうのと比べると、各関数を外部ファイル化したり別スコープから輸入出来るって所で強みがあるかもしれませんね。

const getMetrics = (x, y) => ({
  sum: x + y,
  nested: { mul: x * y },
  test : y - x
});
getMetrics(2, 4);

"applySpecによって作られた関数に付与された引数"は、"内部のそれぞれの関数"に付与されるということでしょうか。

ここはまぁそんな感じですね。
意地悪で引数1個しか取らないid: R.identityを追加したところ、
結果は1個目の引数の2になりました。

このことから、オブジェクト内の全てのキーが所持している関数に対して
同じ引数をそのまま使って実行し、機械的に戻り値に変換しているようです。

const getMetrics = R.applySpec({
  sum: R.add,
  nested: { mul: R.multiply },
  id: R.identity
});
getMetrics(2, 4);
// {"id": 2, "nested": {"mul": 8}, "sum": 6}

Comments

[退会済みユーザー]

R.identityでの検証も含め、非常に詳しくありがとうございました。
イメージが少しずつ湧いてきました...。