{"record":{"id":"f6eb05edd035088d","repo":"oxc-project/oxc","slug":"no-empty-blocks","errorCode":null,"errorMessage":"No empty blocks","messagePattern":"No empty blocks","errorType":"validation","errorClass":"OxcDiagnostic","httpStatus":null,"severity":"error","filePath":"crates/oxc_linter/src/rules/jsdoc/no_blank_blocks.rs","lineNumber":13,"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};\n\nfn no_blank_blocks_diagnostic(span: Span) -> OxcDiagnostic {\n    OxcDiagnostic::warn(\"No empty blocks\").with_label(span)\n}\n\n#[derive(Debug, Default, Clone, Deserialize, JsonSchema)]\n#[serde(rename_all = \"camelCase\", default, deny_unknown_fields)]\npub struct NoBlankBlocks {\n    /// Whether to automatically remove blank JSDoc blocks.\n    enable_fixer: bool,\n}\n\ndeclare_oxc_lint!(\n    /// ### What it does\n    ///\n    /// Reports and optionally removes blocks with whitespace only.\n    ///\n    /// ### Why is this bad?\n    ///\n    /// Blank JSDoc blocks add noise without providing any documentation.\n    ///","sourceCodeStart":1,"sourceCodeEnd":31,"githubUrl":"https://github.com/oxc-project/oxc/blob/e1e7af627c8843ab64044ed466b128fcc21a035b/crates/oxc_linter/src/rules/jsdoc/no_blank_blocks.rs#L1-L31","documentation":"Fires from jsdoc/no-blank-blocks when a JSDoc comment block contains no content (empty /** */ block). The diagnostic helper adds only a label — no help text — and the rule offers an optional enableFixer to strip such blocks automatically.","triggerScenarios":"Thrown at crates/oxc_linter/src/rules/jsdoc/no_blank_blocks.rs:13 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Delete the empty JSDoc block","Fill it with a meaningful description","Enable the rule's fixer to auto-remove blank blocks"],"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"}