Skip to content

jsdoc/require-property-description Correctness

This rule is turned on by default.

What it does

Requires that all @property tags have descriptions.

Why is this bad?

The description of a property should be documented.

Examples

Examples of incorrect code for this rule:

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

Examples of correct code for this rule:

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

How to use

To enable this rule in the CLI or using the config file, you can use:

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

References

Released under the MIT License.