{"record":{"id":"0509d5ea05a8a86f","repo":"oxc-project/oxc","slug":"missing-name-in-property-tag","errorCode":null,"errorMessage":"Missing name in `@property` tag.","messagePattern":"Missing name in `@property` tag\\.","errorType":"validation","errorClass":"OxcDiagnostic","httpStatus":null,"severity":"error","filePath":"crates/oxc_linter/src/rules/jsdoc/require_property_name.rs","lineNumber":12,"sourceCode":"use oxc_diagnostics::OxcDiagnostic;\nuse oxc_macros::declare_oxc_lint;\nuse oxc_span::Span;\n\nuse crate::{\n    context::LintContext,\n    rule::Rule,\n    utils::{should_ignore_as_internal, should_ignore_as_private},\n};\n\nfn require_property_name_diagnostic(span: Span) -> OxcDiagnostic {\n    OxcDiagnostic::warn(\"Missing name in `@property` tag.\")\n        .with_help(\"Add a type name to this `@property` tag.\")\n        .with_label(span)\n}\n\n#[derive(Debug, Default, Clone)]\npub struct RequirePropertyName;\n\ndeclare_oxc_lint!(\n    /// ### What it does\n    ///\n    /// Requires that all `@property` tags have names.\n    ///\n    /// ### Why is this bad?\n    ///\n    /// The name of a property type should be documented.\n    ///\n    /// ### Examples\n    ///","sourceCodeStart":1,"sourceCodeEnd":30,"githubUrl":"https://github.com/oxc-project/oxc/blob/e1e7af627c8843ab64044ed466b128fcc21a035b/crates/oxc_linter/src/rules/jsdoc/require_property_name.rs#L1-L30","documentation":"Raised by the jsdoc/require_property_name rule when a `@property` tag in a JSDoc block (typically documenting a typedef or object type) omits the property name. At the throw site the tag cannot be tied to a concrete member of the documented type, making the type documentation incomplete/unresolvable. run_once() scans all `@property` tags of the file's JSDoc and reports each one lacking a name, skipping blocks marked internal or private.","triggerScenarios":"Thrown at crates/oxc_linter/src/rules/jsdoc/require_property_name.rs:12 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Add the property name after the type: `@property {string} propName`","Remove the malformed `@property` 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"}