コメントに書く型記述

https://github.com/wooorm/trough/blob/main/index.js を読んで、「たぶんこうだ」と思ったこと。

  1. 型名/型表現はブレイスで囲って書く。
  2. @typedf {型表現} 名前 でだいたい type 名前 = 型表現; と同じ意味。
  3. @param {型名/型表現} で関数の引数の型を記述。
  4. @return {型名/型表現} で関数の戻り値の型を記述。
  5. @type {型名/型表現} で直後の変数の型を記述。
  6. 関数の型〈プロファイル〉も直前の @type {型名/型表現} で記述可能。
  7. @this {型名/型表現} で暗黙〈hidden〉状態の型を記述。