0007-関数定義のサンプルコードには極力functionを使う
- ステータス: 採用
- 提案者: suin
- 決定者: suin, reoring, クロレ, jamashita
- 更新日: 2020-02-21
解決する問題とその背景
TypeScript/JavaScriptの関数定義のサンプルコードを示すとき、関数(function)でもアロー関数(arrow function)でもどちらでも解説に影響がないとき、どちらの書き方を優先して使ったらいいか？
JavaScriptでは、関数を定義するとき、functionを使う方法と、arrow functionを使う方法の2つがある。どのような基準でどちらを使うか明確にしておくことで、ひとつの書籍としての一体感が出るとともに、読者の混乱を避けることができる。
決定事項
関数定義のサンプルコードには極力functionを使う。その理由は、
- functionのほうが関数であることが、読み手にとって読み取りやすいから。
- TypeScript公式のハンドブックでfunctionのほうを使っているから。
ただし、arrow functionを使うべきところ、使わないと解説できないところは、arrow functionを使う。たとえば、
- 高階関数などが、thisへの参照を持ちたい場合。
- arrow functionそのものについての説明をする場合。
- フレームワークなどのしきたりでarrow functionのほうが現実でよく使われる場合。