Formulář čte z API jiné klíče, než služba vrací (doplní se jen jedno pole)
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Ve formuláři faktury uživatel zadá IČO, klikne „načíst z rejstříku“ a toast hlásí úspěch. Doplní se ale jen DIČ; název subjektu i adresa zůstanou prázdné. Stejná funkce v jiném formuláři (karta klienta) funguje správně, takže chyba vypadá jako závislá na typu subjektu nebo na datech v rejstříku.
Root cause
Sekce “Root cause”Endpoint /api/registry/{ico} vrací objekt ve tvaru služby:
{ ico, dic, nazev, pravniForma, sidlo: { ulice, obec, psc } }Druhý konzument (formulář faktury) byl napsán bez pohledu na službu a četl klíče, které si autor domyslel:
setBuyerName(d.companyName || d.name || buyerName); // neexistujeif (d.dic) setBuyerDic(d.dic); // jediná shodaconst addr = [d.street, d.city, d.zip].filter(Boolean); // neexistujeVšechno je undefined, filter(Boolean) vyhodí prázdné hodnoty, žádná výjimka nenastane, a protože res.ok platí, zobrazí se toast o úspěchu. Odpověď byla typována jako any, takže typecheck nic nechytil.
Fix
Sekce “Fix”Mapování sjednoceno s prvním (funkčním) konzumentem:
const nazev = typeof d.nazev === "string" ? d.nazev.trim() : "";if (nazev) setBuyerName(nazev);if (d.dic) setBuyerDic(d.dic);const sidlo = d.sidlo || {};const addr = [sidlo.ulice, [sidlo.psc, sidlo.obec].filter(Boolean).join(" ")] .filter(Boolean).join(", ");if (addr) setBuyerAddress(addr);Ověřeno v prohlížeči: název, DIČ i adresa se po kliknutí doplní.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
grep -rn "fetch(\/api/” src` a porovnat klíče čtené v každém konzumentu s návratovým typem služby; podezřelý je toast „načteno“ bez kontroly, že se něco opravdu změnilo. - Anti-pattern:
const d = await res.json()bez typu a čteníd.foo || d.bar || fallback(řetězení „možná se to jmenuje jinak“ maskuje, že žádný z klíčů neexistuje). - Lepší přístup: exportovat návratový typ ze služby (
AresResult) a v klientovi psátconst d: AresResult = await res.json(); ještě lépe sdílený klientský helperapplyRegistryResult(d, setters)použitý všemi formuláři. Úspěšný toast zobrazit jen tehdy, když se změnilo aspoň jedno pole.
Sister bugs / související
Sekce “Sister bugs / související”- Stejný vzor hrozí u každého endpointu s více než jedním konzumentem napsaným v různé době (vyhledávání, našeptávače adres, kurzovní lístky).