{"record":{"id":"6cdc983aadf5a9e2","repo":"oxc-project/oxc","slug":"missing-jsdoc-param-name","errorCode":null,"errorMessage":"Missing JSDoc `@param` name.","messagePattern":"Missing JSDoc `@param` name\\.","errorType":"validation","errorClass":"OxcDiagnostic","httpStatus":null,"severity":"error","filePath":"crates/oxc_linter/src/rules/jsdoc/require_param_name.rs","lineNumber":14,"sourceCode":"use oxc_ast::AstKind;\nuse oxc_diagnostics::OxcDiagnostic;\nuse oxc_macros::declare_oxc_lint;\nuse oxc_span::Span;\n\nuse crate::{\n    AstNode,\n    context::LintContext,\n    rule::Rule,\n    utils::{get_function_nearest_jsdoc_node, should_ignore_as_internal, should_ignore_as_private},\n};\n\nfn missing_name_diagnostic(span: Span) -> OxcDiagnostic {\n    OxcDiagnostic::warn(\"Missing JSDoc `@param` name.\")\n        .with_help(\"Add name to `@param` tag.\")\n        .with_label(span)\n}\n\n#[derive(Debug, Default, Clone)]\npub struct RequireParamName;\n\ndeclare_oxc_lint!(\n    /// ### What it does\n    ///\n    /// Requires that all `@param` tags have names.\n    ///\n    /// ### Why is this bad?\n    ///\n    /// The name of a param should be documented.\n    ///\n    /// ### Examples\n    ///","sourceCodeStart":1,"sourceCodeEnd":32,"githubUrl":"https://github.com/oxc-project/oxc/blob/e1e7af627c8843ab64044ed466b128fcc21a035b/crates/oxc_linter/src/rules/jsdoc/require_param_name.rs#L1-L32","documentation":"This diagnostic is raised by the jsdoc/require_param_name rule when a JSDoc comment contains a `@param` tag whose description or type is present but the parameter name is absent (e.g. `@param {string} - desc`). At the throw site it means the JSDoc block attached to the nearest function documents a parameter without identifying it, so the documentation cannot be matched to an actual function argument. It fires from run() for every `@param` tag parsed from the function's JSDoc node whose name part is empty, unless the symbol is ignored as internal or private.","triggerScenarios":"Thrown at crates/oxc_linter/src/rules/jsdoc/require_param_name.rs:14 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Add the parameter name after the `@param {type}` portion","Remove the stray `@param` tag if the parameter no longer exists"],"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-14T00:17:10.932Z"}