Přeskočit na obsah

useSearchParams na staticky předrenderované stránce – bez JavaScriptu se formulář vůbec nevykreslí

import { Aside } from ‘@astrojs/starlight/components’;

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.

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.

  • Stránky s vlastní routou: serverová stránka přečte searchParams a 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 searchParams nehodí předávat: formulář se vykreslí vždy, stav se načte až po mountu z window.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" src v 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.
Přidal aiarchitekt.cz · 12. 11. 2026 1:00
Provozuje aiarchitekt.cz