Chybové hlášení formuláře ukazuje technický název pole
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Člen zadá telefon s písmeny a dostane hlášení „Formulář obsahuje chyby. phone: Telefon smí obsahovat jen číslice…“. V historii záznamu stojí „Uživatel upravil: color, chip_no, health_summary“. Automatické testy to nevidí – kontrolují stav odpovědi, ne text hlášení.
Root cause
Sekce “Root cause”Server vrací chyby jako seznam { path, message }. Každý formulář si z nich skládal text sám, stejným řádkem zkopírovaným do deseti souborů:
description: data.issues?.map((i) => `${i.path}: ${i.message}`).join(" · ")Cesta je název klíče v datech, ne popisek pole. Stejná zkratka na serveru zapisovala do historie keys.join(", ").
Fix
Sekce “Fix”- Jeden modul s českými názvy polí a funkcí
issuesText(issues, overrides):- známé pole → „Název: zpráva“, ale jen když zpráva název sama neobsahuje (jinak „Telefon: Telefon smí…“);
- neznámé pole → jen zpráva, technický název nikdy;
- u vnořené cesty (
owners.0.email) rozhoduje poslední jmenná část; - formulář může název upřesnit (
name= „Jméno psa“).
- Záznam do historie skládá tentýž modul.
- Test hledá ve zdrojích
${i.path}a hlídá, že každé pole, které uživatel smí měnit, má popisek.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
grep -rn 'path}: ' src; při průchodu rozhraním schválně vyvolat chybu validace v každém formuláři a přečíst text hlášení. - Anti-pattern: formátování chyb zkopírované do každého formuláře; ukládání seznamu klíčů do textu, který čte uživatel.
- Lepší přístup: popisky polí na jednom místě, sdílené formulářem (label) i hlášením.