fix(jsdoc): prevent outer JSDoc from applying to nested functions

[camc314]

Fixes #19139

[camc314]

• fix(jsdoc): prevent outer JSDoc from applying to nested functions #19219 👈 (View in Graphite)
• main

---

How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

• 0-merge - adds this PR to the back of the merge queue
• hotfix - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

[camc314]

Merge activity

• Feb 10, 1:40 PM UTC: The merge label '0-merge' was detected. This PR will be added to the Graphite merge queue once it meets the requirements.
• Feb 10, 1:44 PM UTC: camc314 added this pull request to the Graphite merge queue.
• Feb 10, 1:50 PM UTC: Merged by the Graphite merge queue.

[Copilot]

Pull request overview

Fixes the JSDoc linter behavior where an outer function’s JSDoc could incorrectly be applied to nested function/arrow expressions (e.g., callbacks inside an exported function expression), causing false-positive require-param / require-returns diagnostics.

Changes:

• Update JSDoc lookup to stop when walking from a function into an enclosing (different) function/arrow node, preventing outer-to-inner JSDoc “leakage”.
• Add regression test cases for require-returns and require-param covering nested arrow functions inside a JSDoc-documented outer function.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File	Description
crates/oxc_linter/src/utils/jsdoc.rs	Prevents traversing past an enclosing function/arrow when searching for the “nearest” JSDoc node.
crates/oxc_linter/src/rules/jsdoc/require_returns.rs	Adds a passing test ensuring nested functions don’t inherit the outer function’s JSDoc for returns checks.
crates/oxc_linter/src/rules/jsdoc/require_param.rs	Adds a passing test ensuring nested functions don’t inherit the outer function’s JSDoc for param checks.

[codspeed-hq]

Merging this PR will not alter performance

✅ 47 untouched benchmarks
⏩ 3 skipped benchmarks¹

---

_{Comparing c/02-10-fix_jsdoc_prevent_outer_jsdoc_from_applying_to_nested_functions (22aa520) with main (b4f7e7f)²}

Footnotes

1. 3 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

2. No successful run was found on main (1b2f354) during the generation of this report, so b4f7e7f was used instead as the comparison base. There might be some changes unrelated to this pull request in this report. ↩