jsdoc/check-property-names 正しさ
何を実行するか
JSDoc 内のプロパティ名が同じブロック内で重複していないこと、およびネストされたプロパティに定義されたルートがあることを確認します。
なぜ悪いのか
同じ名前の @property タグは混乱を引き起こす可能性があり、誤りの兆候である場合があります。
例
このルールに対して 誤った 例:
javascript
/**
* @typedef {object} state
* @property {number} foo
* @property {string} foo
*/
/**
* @typedef {object} state
* @property {number} foo.bar
*/このルールに対して 正しい 例:
javascript
/**
* @typedef {object} state
* @property {number} foo
*/
/**
* @typedef {object} state
* @property {object} foo
* @property {number} foo.bar
*/使用方法
設定ファイルまたは CLI でこのルールを 有効化 するには、次のように使用できます:
json
{
"plugins": ["jsdoc"],
"rules": {
"jsdoc/check-property-names": "error"
}
}bash
oxlint --deny jsdoc/check-property-names --jsdoc-plugin