require-returns-check: False positive for function returning function

[iliubinskii]

Expected behavior

Should pass without errors

Actual behavior

Getting error:

JSDoc @returns declaration present but return expression not available

ESLint Config

rules: { "jsdoc/require-returns-check": "warn" }

ESLint sample

export const f =
  /**
   * Description.
   *
   * @returns Result.
   */
  () => {
    return () => {};
  };

Environment

• Node version: 18.12.1
• ESLint version 8.28.0
• eslint-plugin-jsdoc version: 39.6.2

[brettz9]

The top comment block was mistakenly being found by the inner function as though that were its return statement. Surprising this hadn't been caught before. Thanks for the report!

[gajus]

🎉 This issue has been resolved in version 39.6.3 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀