JSDoc
- https://github.com/Microsoft/TypeScript/wiki/JsDoc-support-in-JavaScript
- webpack のコードベースは、TS によるリンティングを使用して JSDoc を使用しています https://twitter.com/TheLarkInn/status/984479953927327744(少し無理をしています: https://twitter.com/thelarkinn/status/996475530944823296)
- JSDoc では、クロージャコンパイラを使用している場合、閉じ込め中の型が確認できます https://github.com/google/closure-compiler/wiki/Types-in-the-Closure-Type-System
注意すべき点
- 何らかの理由で
object
がany
に変換されます。 - jsdoc にエラーがある場合、警告やエラーは表示されません。TSはただ静かに機能の型注釈を追加しません。
- キャストが冗長になる場合があります
(上記のコメンタリーを共有してくれた ギル・タイアー と グレブ・バフムートフ に感謝します)