Zobrazovač hlášení (toast) připojený jen v jednom layoutu – v jiné části aplikace se hlášení nikdy neukážou
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Aplikace má dvě části s vlastním obalem (například administraci a uživatelskou sekci). V administraci se po uložení ukáže hlášení „Uloženo“, v uživatelské sekci se po kliknutí na Uložit neděje nic viditelného: data se uloží, ale potvrzení se neobjeví. Horší je opačný případ – když uložení selže na validaci, uživatel nevidí ani chybu a formulář vypadá, jako by tlačítko nefungovalo. Totéž platí pro „hesla se neshodují“ a každé další hlášení v té části.
Root cause
Sekce “Root cause”Hlášení se zapisují do společného úložiště voláním toast(), ale na obrazovku je dostane až komponenta kontejneru, která to úložiště čte. Ta byla vykreslená jen v obalu jedné části:
// obal administrace<div>…{children}<Toaster /></div>
// obal uživatelské sekce – kontejner chybí<div>…{children}</div>toast() bez kontejneru nevyhodí chybu ani varování, hlášení se jen nikdy nevykreslí. Formuláře uživatelské sekce vznikaly kopírováním vzoru z administrace, takže volání vypadala správně.
Testy to neodhalily, protože ověřovaly výsledek zápisu (odpověď API, stav v databázi, text na stránce po obnovení), ne to, co uživatel vidí hned po kliknutí. Část scénářů navíc zapisovala rovnou přes API.
Fix
Sekce “Fix”Kontejner hlášení vykreslit i v obalu druhé části (jeden řádek). K tomu dvě pojistky:
- Test zdrojů: každý soubor, který volá
useToast(), musí ležet v části aplikace, jejíž obal obsahuje<Toaster />, a každá stránka té části se v tom obalu opravdu vykresluje. - Průchod skutečným rozhraním: vyplnit formulář, kliknout na Uložit a čekat na viditelné hlášení; u neplatného vstupu čekat na viditelnou chybu a ověřit, že rozepsaná data zůstala.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: spočítej layouty a místa, kde se kontejner hlášení vykresluje (
grep -rn "<Toaster"), a porovnej s tím, kde všude se voláuseToast/toast(. Více layoutů a jeden kontejner je podezřelé. - Anti-pattern: kontejner hlášení v obalu jedné části místo ve společném kořenovém layoutu; testy, které po akci kontrolují jen databázi nebo odpověď API.
- Lepší přístup: kontejner dát do společného kořenového layoutu, nebo jeho přítomnost v každém obalu hlídat testem. U každého formuláře mít aspoň jeden test, který po kliknutí čeká na hlášení pro uživatele – úspěšné i chybové.
Sister bugs / související
Sekce “Sister bugs / související”- Tiché selhání uložení, kdy výjimka vznikne dřív, než se zobrazí chyba.
- Kontrola přístupnosti, která měří jen jednu část aplikace a ostatní obaly nevidí.