@jsenv/server 17.7.0 → 17.7.1

package/dist/jsenv_server.js

@@ -6317,9 +6317,7 @@ const createRouter = (
     };
   };
   const forEachMethodAllowed = (route, onMethodAllowed) => {
-    const supportedMethods =
-      route.method === "*" ? HTTP_METHODS : [route.method];
-    for (const supportedMethod of supportedMethods) {
+    for (const supportedMethod of route.methods) {
       onMethodAllowed(supportedMethod);
     }
   };
@@ -6555,7 +6553,9 @@ It should be should be one of route.${routePropertyName}: ${availableValues.join
           // matching every resource ("GET *", "GET /*") names no resource, so
           // it cannot make that assertion and an unknown address stays a 404
           if (!route.isFallback && !route.matchesEveryResource) {
-            wouldHaveMatched.methodSet.add(route.method);
+            for (const routeMethod of route.methods) {
+              wouldHaveMatched.methodSet.add(routeMethod);
+            }
           }
           continue;
         }
@@ -6876,6 +6876,14 @@ const createRoute = ({
   ) {
     availableMediaTypes.push(extensionWellKnownContentType);
   }
+  // HEAD is GET without the body (RFC 9110 §9.3.2): a GET route answers it and
+  // the server drops the body when sending
+  const methods =
+    method === "*"
+      ? HTTP_METHODS
+      : method === "GET"
+        ? ["GET", "HEAD"]
+        : [method];
   const resourcePattern = createResourcePattern(resource);
   const headersPattern = headers ? createHeadersPattern(headers) : null;
 
@@ -6895,8 +6903,11 @@ const createRoute = ({
     availableVersions,
     availableEncodings,
     acceptedMediaTypes,
+    methods,
     matchMethod:
-      method === "*" ? () => true : (requestMethod) => requestMethod === method,
+      method === "*"
+        ? () => true
+        : (requestMethod) => methods.includes(requestMethod),
     matchResource:
       resource === "*"
         ? () => true

package/docs/handling_requests.md

@@ -31,6 +31,8 @@ await startServer({
 | `GET /*`               | anything, with the path in `request.params[0]`                                                          |
 | `GET *`                | anything: a catch-all, put it last                                                                      |
 
+A `GET` route also answers `HEAD`: the response is built the same way and sent without its body.
+
 Only `*` widens a pattern. Routes are tried in order, so a route covering others (`GET /docs/*`, `GET *`) goes after them. `fetch` can be async; returning `null` or `undefined` declines the request and the next route is tried.
 
 When no route answers, the router builds the response from what almost matched:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/server",
-  "version": "17.7.0",
+  "version": "17.7.1",
   "type": "module",
   "description": "A modern Node.js HTTP server with declarative routing, content negotiation, and WebSocket support",
   "repository": {
@@ -37,7 +37,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "launch-editor": "2.14.1"
+    "launch-editor": "2.14.2"
   },
   "devDependencies": {
     "@jsenv/abort": "../../tooling/abort",

package/src/router/router.js

@@ -121,9 +121,7 @@ export const createRouter = (
     };
   };
   const forEachMethodAllowed = (route, onMethodAllowed) => {
-    const supportedMethods =
-      route.method === "*" ? HTTP_METHODS : [route.method];
-    for (const supportedMethod of supportedMethods) {
+    for (const supportedMethod of route.methods) {
       onMethodAllowed(supportedMethod);
     }
   };
@@ -359,7 +357,9 @@ It should be should be one of route.${routePropertyName}: ${availableValues.join
           // matching every resource ("GET *", "GET /*") names no resource, so
           // it cannot make that assertion and an unknown address stays a 404
           if (!route.isFallback && !route.matchesEveryResource) {
-            wouldHaveMatched.methodSet.add(route.method);
+            for (const routeMethod of route.methods) {
+              wouldHaveMatched.methodSet.add(routeMethod);
+            }
           }
           continue;
         }
@@ -683,6 +683,14 @@ const createRoute = ({
   ) {
     availableMediaTypes.push(extensionWellKnownContentType);
   }
+  // HEAD is GET without the body (RFC 9110 §9.3.2): a GET route answers it and
+  // the server drops the body when sending
+  const methods =
+    method === "*"
+      ? HTTP_METHODS
+      : method === "GET"
+        ? ["GET", "HEAD"]
+        : [method];
   const resourcePattern = createResourcePattern(resource);
   const headersPattern = headers ? createHeadersPattern(headers) : null;
 
@@ -702,8 +710,11 @@ const createRoute = ({
     availableVersions,
     availableEncodings,
     acceptedMediaTypes,
+    methods,
     matchMethod:
-      method === "*" ? () => true : (requestMethod) => requestMethod === method,
+      method === "*"
+        ? () => true
+        : (requestMethod) => methods.includes(requestMethod),
     matchResource:
       resource === "*"
         ? () => true