Confusing hybrid mode on Cookie

[jamesli2021]

📝 Issue Description

Unclear about hybrid mode.

📋 On which page(s) it occurs

https://docs.astro.build/en/guides/server-side-rendering/#on-demand-rendering-features

🤔 Expected Behavior

What do the readers understand from this?

Extract from doc:
In server and hybrid (with opt-out prerender) modes, a page or API endpoint can check, set, get, and delete cookies.

👀 Current Behavior

When I set to output: hybrid in astro config file, the terminal can confusing for newbies, I know we need to opt-out of pre-render. But this warning need to be clear.

4:15:15 [WARN] `Astro.request.headers` is not available in "static" output mode. To enable header access: set `output: "server"` or `output: "hybrid"` in your config file.

🖥️ Browser

NA

📄 Additional Information

No response

[sarah11918]

Thank you for raising this @jamesli2021 ! I agree and it's actually on my list to convert some of our wording over from "modes" (server, hybrid) to the actual individual pages themselves, because you can have pre-rendered modes in ANY mode, and yes, that is what the error message should be explaining. You might have one of the correct modes configured, but it will only work on a page that's rendered on-demand.

@Princesseuh - I went to look in https://github.com/withastro/astro/blob/main/packages/astro/src/core/errors/errors-data.ts for this error but I'm having trouble finding it. Is it possible we don't have a docs entry for this one?

In general, I think we'll make a task to do a sweep of SSR related errors and make sure they refer to the specific endpoint/route being prerendered or not, vs the output mode, since that doesn't guarantee that every page uses SSR.

[Princesseuh]

We only have pages for errors, this seems to be a random warning in the console, so it's most likely somewhere random in Astro.

[sarah11918]

Alright, treasure hunt, it is! Let's find this warning in the Astro code base 😅

[mingjunlu]

Gotcha!

Here's where the warning comes from:
https://github.com/withastro/astro/blob/7eac778cce4429059d433fa22bf8f44555e2965f/packages/astro/src/core/request.ts#L71-L74

And here's a minimal reproduction example:
https://stackblitz.com/edit/github-a8vhdv?file=src%2Fpages%2Findex.astro