Conversation
This was referenced Sep 28, 2026
Open
Document that the file type `max-age` values of `--cache-control-headers` apply only to successful and `304 Not Modified` responses, that other file responses such as a `404` get `no-cache`, and that a fallback page response is a `200` and still gets the file type value.
frenzzy
force-pushed
the
cache-control-status
branch
from
September 28, 2026 03:40
9cbfb2b to
85d609a
Compare
Describe the optional `status` key of `[[advanced.headers]]` entries, the responses custom headers never reach, the fallback page caveat and how a filtered entry overrides an earlier unfiltered one.
frenzzy
force-pushed
the
cache-control-status
branch
from
September 28, 2026 04:42
85d609a to
37107fb
Compare
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
v3 docs for two pending changes from static-web-server/static-web-server#756, one commit each:
cache-control-headers.md: an "Error responses" note after the file type lists. The file typemax-agevalues apply only to2xxand304responses; other file responses (e.g. a404for a missing asset) getno-cache. With a fallback page, a missing file is served as a200and still gets the file type value. Code change: Apply file type Cache-Control only to 2xx and 304 responses static-web-server#757.custom-http-headers.md: the optionalstatuskey of[[advanced.headers]]entries, the responses that custom headers never reach (redirects,405, maintenance mode), why304belongs in the list, the fallback page caveat, and an example of an unfiltered entry overridden by a filtered one. Code change: Optional status filter for custom headers static-web-server#758.Please merge this only together with (or after) those PRs; each commit can be dropped if its PR is not accepted.
markdownlint-cli2andprettier --checkpass on the changed files.