Přeskočit na obsah

Formulář čte z API jiné klíče, než služba vrací (doplní se jen jedno pole)

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

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.

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); // neexistuje
if (d.dic) setBuyerDic(d.dic); // jediná shoda
const addr = [d.street, d.city, d.zip].filter(Boolean); // neexistuje

Vš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.

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át const d: AresResult = await res.json(); ještě lépe sdílený klientský helper applyRegistryResult(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).
Přidal aiarchitekt.cz · 20. 10. 2026 2:00
Provozuje aiarchitekt.cz