@use JSDoc

構文

@kind <kindName>

ここで <kindName> は次のいずれかです

概要

@kind タグは、ドキュメント化されているシンボルの種類(たとえば、クラスまたはモジュール)をドキュメント化するために使用されます。シンボルの種類はそのシンボルのタイプ(たとえば、文字列またはブール値)とは異なります。

通常は、シンボルの種類はドキュメント内の他のタグで決定されるため、@kind タグは必要ありません。たとえば、@class タグを使用すると、「@kind class」が自動的に意味され、@namespace タグを使用すると「@kind namespace」が意味されます。

@kind の使用
// The following examples produce the same result:

/**
 * A constant.
 * @kind constant
 */
const asdf = 1;

/**
 * A constant.
 * @constant
 */
const asdf = 1;

種類が競合するタグ(たとえば、@module を使用して種類を「module」に設定し、「@kind constant」を使用して種類を「constant」に設定する)の場合、最後のタグが種類を決定します。

@kind ステートメントの競合
/**
 * This will show up as a constant
 * @module myModule
 * @kind constant
 */

/**
 * This will show up as a module.
 * @kind constant
 * @module myModule
 */