fix: stop reporting for async functions with throw missing @throws; fixes #722

(To ensure the rejected value is documented, we may need a custom tag rule.)

Author: brettz9

README.md

@@ -18051,6 +18051,12 @@ const itself = (n) => n;
  * Not tracking on nested function
  */
 const nested = () => () => {throw new Error('oops');};
+
+/**
+ */
+async function foo() {
+  throw Error("bar");
+}
 ````
 
 

src/jsdocUtils.js

@@ -997,7 +997,7 @@ const hasThrowValue = (node, innerFunction) => {
   case 'FunctionExpression':
   case 'FunctionDeclaration':
   case 'ArrowFunctionExpression': {
-    return !innerFunction && hasThrowValue(node.body, true);
+    return !innerFunction && !node.async && hasThrowValue(node.body, true);
   }
   case 'BlockStatement': {
     return node.body.some((bodyNode) => {

test/rules/assertions/requireThrows.js

@@ -418,5 +418,17 @@ export default {
       const nested = () => () => {throw new Error('oops');};
       `,
     },
+    {
+      code: `
+      /**
+       */
+      async function foo() {
+        throw Error("bar");
+      }
+      `,
+      parserOptions: {
+        ecmaVersion: 8,
+      },
+    },
   ],
 };