@use JSDoc

同義語

構文

@function [<関数の名前>]

概要

これはオブジェクトを関数としてマークするものであり、パーサーにはそう見えない場合でもです。これにより、そのドキュレットの @kind が「関数」に設定されます。

@function を使用して関数をマークする
/** @function */
var paginate = paginateFactory(pages);

@function タグがないと、paginate オブジェクトは一般オブジェクト(@member)としてドキュメント化されます。コードの行の検査からは、paginate が実行されたときにどのような値が保持されるかを特定することはできないからです。

@function と名前を一緒に使用
/** @function myFunction */

// the above is the same as:
/** @function
 * @name myFunction */