オブジェクト(またはより正確にはノードにmodule.exports
に割り当てられたオブジェクト)があり、このオブジェクトのプロパティが関数で構成されている場合、どのようにパラメータを記述し、関数?オブジェクトのプロパティにJSDocを使用して関数のパラメータを記述する
例:
module.exports = {
/**
* Adds two numbers together.
* @param {number} first The first number
* @param {number} second The second number
* @return {number} The sum of the two numbers
*/
"add": function(first, second) {
return first + second;
}
}
これは(少なくともないVSCodeで)サポートされていないようだと、私は、関数の引数を文書化する方法を説明しJSDocのドキュメントの任意の場所で見つけることができませんでしたこのシナリオ(または単なるオブジェクトの場合)。 JSDocの説明が機能します(VSCodeのIntellisenseによって表示されます)。しかし、paramの定義と戻り値の定義は異なります。
関数をドキュメント化して、それらを参照するオブジェクトに表示する方法はありますか?
'vscode'タグは、そのプログラムに固有のものかもしれないので、あなたの質問に追加したいかもしれません。これはIDEの一般的な問題のようです。別の質問があります:http://stackoverflow.com/questions/40877203/intellisense-from-jsdoc-not-working-for-imported-types-in-vscode、これは大文字の詳細です。 https://github.com/Microsoft/vscode/issues/3842も参照してください。これは、最新バージョンのVSCodeで修正されているようです。 –
ありがとうございます。大文字の使用に関するリンクから、私は答えにつながった。 –