jsdoc/check-tag-names Correctness
What it does
Reports invalid block tag names. Additionally checks for tag names that are redundant when using a type checker such as TypeScript.
Why is this bad?
Using invalid tags can lead to confusion and make the documentation harder to read.
Examples
Examples of incorrect code for this rule:
javascript
/** @Param */
/** @foo */
/**
* This is redundant when typed.
* @type {string}
*/Examples of correct code for this rule:
javascript
/** @param */Options
Configuration for allowed tags is done via settings.jsdoc.tagNamePreference. There is no CLI-only parameter for this rule.
You can add custom tags by adding a key-value pair where both match the name of the tag you want to add, like so:
json
{
"plugins": ["jsdoc"],
"rules": {
"jsdoc/check-tag-names": "error"
},
"settings": {
"jsdoc": {
"tagNamePreference": {
"customTagName": "customTagName"
}
}
}
}Examples of correct code for this rule with the above configuration, adding the customTagName tag:
js
/**
* @customTagName
*/How to use
To enable this rule in the CLI or using the config file, you can use:
bash
oxlint --deny jsdoc/check-tag-names --jsdoc-pluginjson
{
"plugins": ["jsdoc"],
"rules": {
"jsdoc/check-tag-names": "error"
}
}