fulmine.js 5.19.2 → 5.19.4

package/src/route.js

@@ -25,9 +25,8 @@ const SYNC_LIMIT = 100;
 /**
  * The handlers registered for one path, and the walk over them.
  *
- * Express exports this, and code that builds a route by hand rather than through a router uses it:
- * `new Route(path)`, a handler per verb, then `dispatch(req, res, done)`. It does no matching, the
- * caller having decided the route is the right one; all it knows is which verb a handler answers.
+ * Express exports this, and code that builds a route by hand uses it: `new Route(path)`, a handler
+ * per verb, then `dispatch(req, res, done)`. It does no matching, only which verb a handler answers.
  */
 class Route {
     /**
@@ -69,9 +68,9 @@ class Route {
     /**
      * Runs the handlers this request's verb reaches, one after another through next().
      *
-     * @param {any} req
-     * @param {any} res
-     * @param {(err?: any) => void} done called when the route is finished with the request, with
+     * @param {any} req a Request, or whatever a caller that built this Route by hand is serving
+     * @param {any} res the matching response
+     * @param {(err?: unknown) => void} done called when the route is finished with the request, with
      *   whatever error it ended on
      */
     dispatch(req, res, done) {
@@ -114,7 +113,7 @@ class Route {
                 return done(err);
             }
 
-            const handle = /** @type {any} */ (layer).handle;
+            const handle = /** @type {{handle: Function}} */ (layer).handle;
             // an error only reaches the four-argument handlers, and everything else only runs
             // while there is no error, which is the same rule ordinary dispatch follows
             if (err) {
@@ -147,7 +146,7 @@ class Route {
  * Refuses a handler that could never be called, worded as express words it.
  *
  * @param {string} method the verb this was registered for, for the message
- * @param {any[]} handlers
+ * @param {unknown[]} handlers
  */
 function checkRouteHandlers(method, handlers) {
     for (const handle of handlers) {