Skip to content
← Back to rules

jsdoc/require-property-description 正确性

它的作用

要求所有 @property 标签都必须有描述。

为什么这是不好的?

属性的描述应当被记录。

示例

此规则的错误代码示例:

javascript
/**
 * @typedef {SomeType} SomeTypedef
 * @property {number} foo
 */

此规则的正确代码示例:

javascript
/**
 * @typedef {SomeType} SomeTypedef
 * @property {number} foo Foo.
 */

如何使用

要通过配置文件或 CLI 启用此规则,可以使用:

json
{
  "plugins": ["jsdoc"],
  "rules": {
    "jsdoc/require-property-description": "error"
  }
}
bash
oxlint --deny jsdoc/require-property-description --jsdoc-plugin

参考资料