メインコンテンツまでスキップ

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のほうが現実でよく使われる場合。
  • 質問する ─ 読んでも分からなかったこと、TypeScriptで分からないこと、お気軽にGitHubまで🙂
  • 問題を報告する ─ 文章やサンプルコードなどの誤植はお知らせください。