/**
* 合計値を返す
*
* @param {...number} values 合計を求める数値
* @returns {number} `values` の合計値
*/
function sum(...values) {
return values.reduce((a, b) => a + b, 0)
}
この資料の役割
なんのための型やテストか? 🤔
✋ 安全性や動作確認のため?
😏 それらは副作用と言って良い
仕様を明示するために書く ✍️
👉 つまりドキュメンテーション
だから…
かつてはコメントに書いた
/**
* 合計値を返す
*
* @param {...number} values 合計を求める数値
* @returns {number} `values` の合計値
*/
function sum(...values) {
return values.reduce((a, b) => a + b, 0)
}
人はコメントを忖度しない
/**
* @param {...number} values 合計を求める数値
*/
/**
* @returns {number} `values` の合計値
*/