require-returns-check: warns about return in try-finally

[kevinoid]

Expected behavior

jsdoc/require-returns-check should not produce a warning or error for functions with a return statement in a try-finally statement.

Actual behavior

The following warning is produced:

1:1  warning  JSDoc @returns declaration present but return expression not available in function  jsdoc/require-returns-check

ESLint Config

{
  "extends": [
    "plugin:jsdoc/recommended"
  ]
}

ESLint sample

/** Returns true.
 *
 * @returns {boolean} true
 */
function getTrue() {
  try {
    return true;
  } finally {
    console.log('returning...');
  }
}

Environment

• Node version: v18.10.0
• ESLint version v8.26.0
• eslint-plugin-jsdoc version: 39.3.22

Related Issues

#924 #925

[gajus]

🎉 This issue has been resolved in version 39.3.23 🎉

The release is available on:

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

Your semantic-release bot 📦🚀

[kevinoid]

Thanks for the lightning-fast response!