{"record":{"id":"101426c266ab36cf","repo":"oxc-project/oxc","slug":"invalid-tag-name-found","errorCode":null,"errorMessage":"Invalid tag name found.","messagePattern":"Invalid tag name found\\.","errorType":"validation","errorClass":"OxcDiagnostic","httpStatus":null,"severity":"error","filePath":"crates/oxc_linter/src/rules/jsdoc/check_tag_names.rs","lineNumber":14,"sourceCode":"use oxc_diagnostics::OxcDiagnostic;\nuse oxc_macros::declare_oxc_lint;\nuse oxc_span::Span;\nuse schemars::JsonSchema;\nuse serde::Deserialize;\n\nuse crate::{\n    context::LintContext,\n    rule::{DefaultRuleConfig, Rule},\n    utils::{should_ignore_as_internal, should_ignore_as_private},\n};\n\nfn check_tag_names_diagnostic(span: Span, x1: &str) -> OxcDiagnostic {\n    OxcDiagnostic::warn(\"Invalid tag name found.\").with_help(x1.to_string()).with_label(span)\n}\n\n#[derive(Debug, Default, Clone, Deserialize)]\npub struct CheckTagNames(Box<CheckTagNamesConfig>);\n\ndeclare_oxc_lint!(\n    /// ### What it does\n    ///\n    /// Reports invalid block tag names.\n    /// Additionally checks for tag names that are redundant when using a type checker such as TypeScript.\n    ///\n    /// ### Why is this bad?\n    ///\n    /// Using invalid tags can lead to confusion and make the documentation harder to read.\n    ///\n    /// ### Examples\n    ///\n    /// Examples of **incorrect** code for this rule:","sourceCodeStart":1,"sourceCodeEnd":32,"githubUrl":"https://github.com/oxc-project/oxc/blob/e1e7af627c8843ab64044ed466b128fcc21a035b/crates/oxc_linter/src/rules/jsdoc/check_tag_names.rs#L1-L32","documentation":"Fires from jsdoc/check-tag-names when a JSDoc block uses a tag not present in the rule's allowed set (built-in JSDoc tags plus any configured additional tags, minus configured blocked ones). The helper attaches the rule's explanatory help text and labels the tag's span.","triggerScenarios":"Thrown at crates/oxc_linter/src/rules/jsdoc/check_tag_names.rs:14 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Use a valid JSDoc tag name","Add the custom tag to the rule's `enabled`/additional tags setting","Remove the invalid tag"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"e1e7af627c8843ab64044ed466b128fcc21a035b","analyzedAt":"2026-08-20T07:01:07.079Z","contentChangedAt":"2026-08-20T07:01:07.079Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}