fix: Stop warning missing param and returns tags if @type is present

Author: golopot

README.md

@@ -4252,6 +4252,9 @@ function quux (foo) {
 // issue 182: optional chaining
 /** @const {boolean} test */
 const test = something?.find(_ => _)
+
+/** @type {RequestHandler} */
+function foo(req, res, next) {}
 ````
 
 
@@ -4857,6 +4860,11 @@ function quux () {
 }
 // Settings: {"jsdoc":{"forceRequireReturn":true}}
 
+/** @type {RequestHandler} */
+function quux (req, res , next) {
+  return;
+}
+
 /** foo class */
 class foo {
   /** foo constructor */

src/rules/requireParam.js

@@ -12,6 +12,11 @@ export default iterateJsdoc(({
     return;
   }
 
+  // Param type is specified by type in @type
+  if (utils.hasTag('type')) {
+    return;
+  }
+
   functionParameterNames.some((functionParameterName, index) => {
     const jsdocParameterName = jsdocParameterNames[index];
 

src/rules/requireReturns.js

@@ -26,6 +26,9 @@ const canSkip = (utils) => {
     'class',
     'constructor',
 
+    // Return type is specified by type in @type
+    'type',
+
     // This seems to imply a class as well
     'interface'
   ]) ||

test/rules/assertions/requireParam.js

@@ -567,6 +567,12 @@ export default {
           const test = something?.find(_ => _)
       `,
       parser: 'babel-eslint'
+    },
+    {
+      code: `
+          /** @type {RequestHandler} */
+          function foo(req, res, next) {}
+      `
     }
   ]
 };

test/rules/assertions/requireReturns.js

@@ -487,6 +487,14 @@ export default {
         }
       }
     },
+    {
+      code: `
+          /** @type {RequestHandler} */
+          function quux (req, res , next) {
+            return;
+          }
+      `
+    },
     {
       code: `
       /** foo class */