honojs / node-server

Node.js Server for Hono
https://hono.dev
379 stars 46 forks source link

serveStatic should apply Last-Modified header #189

Open t-mart opened 2 months ago

t-mart commented 2 months ago

Clients can make requests with an If-Modified-Since header to indicate that they only want a data-ful response (200) if the file has changed since the date value in that header. If the file has not changed since that date, the server can respond with a 304 and empty body.

Clients set the value of the If-Modified-Since from an earlier response's Last-Modified header, which Hono would need to provide.

src/serve-static.ts:serveStatic doesn't seem to implement this, but seems very close to being able to. We already pull the file's stats for various size headers and the Date header.

It seems like we'd need to do two things:

  1. Add another header for Last-Modified. Something perhaps like:

    c.header('Last-Modified', stats.mTime.toUTCString())
  2. Add logic to read a If-Modified-Since header and return 304 in the appropriate case.

To maintain backwards-compatibility, a new optional property could be added to the ServeStaticOptions object, which is the parameter to serveStatic, to gate this behavior. For now, I guess it could be a boolean, named something like lastModified (I'm not sure what would be a good name here).

yusukebe commented 2 months ago

Hi @t-mart

Quick response. I think we can implement it as a middleware like the ETag Middleware.

t-mart commented 2 months ago

@yusukebe, that would make it the most "pluggable", yes.

However, with a general request/response (not a filesystem mapping like serveStatic), I'm not sure how the server would (statelessly) know how to set the Last-Modified header correctly.

yusukebe commented 2 months ago

@t-mart

However, with a general request/response (not a filesystem mapping like serveStatic), I'm not sure how the server would (statelessly) know how to set the Last-Modified header correctly.

Indeed. As you mentioned, adding this feature to serveStatic might be better. And it's a little bit of code.