useSearchParams na staticky předrenderované stránce – bez JavaScriptu se formulář vůbec nevykreslí
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Formulář obnovy hesla dostal bezpečný fallback bez JavaScriptu (method="post" + redirect zpět s ?stav=ok|chyba). Aby stránka zobrazila výsledek, klientská komponenta četla useSearchParams() a byla zabalená do <Suspense fallback={null}> (bez toho build hlásí chybějící hranici). Lokálně vše prošlo. Na produkci test s vypnutým JavaScriptem spadl: page.fill('input[name="email"]') timeout – formulář na stránce nebyl.
Root cause
Sekce “Root cause”useSearchParams na stránce, která se staticky předrenderuje, způsobí v Next.js App Routeru client-side rendering bailout nejbližší Suspense hranice: do HTML se dostane jen fallback (null), vlastní obsah vykreslí až JavaScript. Dev server stránky renderuje dynamicky při každém požadavku, proto se chyba lokálně neprojeví. Výsledek: no-JS fallback formuláře je bez JS neviditelný – přesně opak zamýšleného.
Fix
Sekce “Fix”- Stránky s vlastní routou: serverová stránka přečte
searchParamsa předá stav jako props klientskému formuláři.
export default async function ForgotPasswordPage({ searchParams }: { searchParams: Promise<{ stav?: string; zprava?: string }> }) { const { stav, zprava } = await searchParams; return <ForgotPasswordForm initialStatus={{ stav, zprava }} />;}- Komponenta uvnitř obecné statické stránky (kontaktní formulář v CMS šabloně), kde se
searchParamsnehodí předávat: formulář se vykreslí vždy, stav se načte až po mountu zwindow.location.search(JS-only hláška; bez JS uživatel vidí formulář, data v URL nejsou).
Test: Playwright s javaScriptEnabled: false proti produkčnímu buildu / živému webu – lokální dev průchod nestačí.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
grep -rn "useSearchParams" srcv komponentách renderovaných ve statických stránkách;curl -s <url> | grep name="…"na živém webu (formulář musí být v HTML). - Anti-pattern: „zabalím to do Suspense, build projde“ – build warning o hranici je upozornění na bailout, ne jen formalita; testování no-JS chování jen na dev serveru.
- Lepší přístup: data z URL, která ovlivňují SSR, čti na serveru (
searchParams, případněheaders()), klientské hooky jen pro progressive enhancement.
Sister bugs / související
Sekce “Sister bugs / související”- No-JS fallback formulářů za reverzní proxy (redirect na interní localhost, multipart klienti) – předchozí nález téže opravy.