Chyba není katastrofa

Když člověk, který neprogramuje, uvidí červený text s anglickými slovy a čísly, má instinkt zavřít okno.

To je přesně opačně, než by měl. Chybová hláška je nejlepší věc, kterou můžeš dostat. Říká ti, co se pokazilo a často i kde.

Co je horší než chyba

Tichá nefunkčnost. Aplikace se tváří, že běží, ale dělá něco jiného, než má.

Objednávky, které se tiše neuloží, jsou horší než aplikace, která spadne. Ta aspoň křičí.

Tři druhy chyb

1. Nespustí se to

   Build selže, server nenastartuje, stránka je bílá. Nejhlasitější a nejsnáze opravitelné – chyba je téměř vždy v poslední změně.

2. Spustí se, ale něco nefunguje

   Tlačítko nereaguje, formulář se neodešle, data se nenačtou. Chyba bývá vidět v konzoli prohlížeče nebo v logu serveru.

3. Funguje to špatně

   Nic nehlásí, ale výsledek je nesprávný. Špatně spočítaná cena, přehozené datum, chybějící položka. Nejzákeřnější druh – tady žádná hláška nepomůže, jen kontrola.

Chybová hláška má strukturu

Vypadá to jako zeď textu. Není. Obvykle jsou v ní tři informace:

TypeError: Cannot read properties of undefined (reading 'nazev')
    at ProduktKarta (src/components/produkt-karta.tsx:14:23)
    at ProduktSeznam (src/app/produkty/page.tsx:31:9)

1. Co se stalo

   První řádek. „Snažil jsem se přečíst nazev z něčeho, co neexistuje.“

2. Kde

   Soubor a číslo řádku. Tady produkt-karta.tsx, řádek 14.

3. Jak se to tam dostalo

   Zbytek řádků je cesta – kdo tu funkci zavolal a odkud. Čte se odshora dolů: nejbližší místo je nahoře.

Co s tím udělat

Nejrychlejší postup je zkopírovat celou hlášku – celou, ne první řádek – a poslat ji Claudovi.

Dostal jsem tuhle chybu:

---
[CELÁ CHYBOVÁ HLÁŠKA]
---

Než něco opravíš:
1. Vysvětli mi česky a bez žargonu, co ta chyba znamená.
2. Řekni mi, kde se stala a co ji nejspíš způsobilo.
3. Navrhni opravu a vysvětli, proč by měla pomoct.

Až potom to oprav.

Body 1 a 2 nejsou zdvořilost. Nutí Clauda pojmenovat příčinu, místo aby zkusil první opravu, která ho napadne – a tobě přitom rostou znalosti.