Volba mezi REST a GraphQL: Chyba, která vás stojí výkon i čas

Moderní JavaScript není o tom, používat všechno najednou. Začněte s destructuringem, spread operátorem a async/await – tyto tři osvětlení v obývákuěci změní váš kód nejvýrazněji. Postupně přidávejte volitelné řetězení a nullish coalescing, které zpřehlední práci s daty. Vyhnete se tím mnoha bugům a kód bude srozumitelnější pro ostatní vývojáře.

Další častá chyba je špatně sestavený požadavek. Před odesláním si ověřte, jestli používáte správnou metodu HTTP. GET slouží ke čtení, POST k vytváření, PUT k aktualizaci, DELETE k mazání. Pokud použijete GET tam, kde se čeká POST, dostanete chybu. Také si dejte pozor na hlavičky. Některá API vyžadují hlavičku Content-Type s hodnotou application/json. Bez ní server nerozpozná, že posíláte JSON, a vrátí chybu. Zkontrolujte si proto v dokumentaci, jaké hlavičky jsou povinné.

Pojmenovávání proměnných a funkcí rozhoduje o tom, jestli kódu rozumí i za tři měsíce Názvy proměnných musí vypovídat o tom, co obsahují. Místo x nebo tmp použijte uzivatelJmeno nebo celkovaCena. Ale pozor na příliš dlouhé názvy – seznamVsechObjednavekZakaznikaJeUzavrenychKontrola. Ideál je jedno slovo, maximálně tři. Funkce by měly být pojmenované slovesem: ziskejUzivatele, spoctiDan, uloz do Pameti. Vyhněte se obecným názvům jako proces, spocitej nebo doSomething. Když název neříká, Here is more info in regards to barvy stěn do Obýváku look at the webpage. co se děje, je lepší přidat komentář, ale ještě lepší je zvolit lepší název. Komentáře by měly vysvětlovat proč, ne co. Kód už říká co – pokud je napsaný čistě.

Jakmile máš základní představu, přejdi k praktickému testování. Místo abys hned psal celý program, použij nástroj na testování API. Takový nástroj ti umožní zadat endpoint, metodu a případně hlavičky (headers) a pak vidíš kompletní odpověď. Tímto způsobem snadno zjistíš, jestli API funguje, jaká data vrací a jaké chyby se objevují. Typická chyba začátečníka je, že přeskočí tuto fázi a rovnou píše kód. Pak tráví hodiny hledáním chyby, která je jen v tom, že špatně zadal hlavičku nebo zapomněl na parametr. Testováním ušetříš spoustu času.

Než začneš psát první kód, je důležité znát tři základní věci. Za prvé, endpoint – to je adresa, na kterou posíláš požadavky. Za druhé, metoda – nejčastěji GET pro čtení dat a POST pro vytváření nových. Za třetí, autentizace – mnoho API vyžaduje klíč, který tě identifikuje. Bez něj server neví, kdo jsi, a odmítne ti odpovědět. Pro začátek si vyber API, které nevyžaduje žádný klíč, třeba veřejné API s daty o počasí nebo knihách. Otevři si prohlížeč a zkus na adresu napsat endpoint s parametrem – uvidíš data v surové podobě, obvykle ve formátu JSON.

Základním pravidlem je psát krátké funkce, které dělají jen jednu věc. Pokud má funkce více než deset řádků, skoro vždy ji lze rozdělit. Typická chyba začátečníků je vytvořit funkci s názvem zpracujData, která načítá data, validuje je, mění formát a ukládá do databáze. Místo toho vytvořte tři funkce: nactiData, validujData a ulozData. Každá má jasný název, jasný vstup a výstup. Když pak něco nefunguje, nemusíte procházet sto řádků – stačí spustit testy a zjistíte, která část selhala. To je obrovská úspora času při ladění i při přidávání nových funkcí.

Při práci s daty mějte na paměti, že JSON může obsahovat vnořené struktury. Pokud s daty pracujete v jazyce, jako je Python, použijte knihovnu requests a převeďte odpověď na slovník. Pak můžete snadno přistupovat k jednotlivým položkám. Ujistěte se, že zpracováváte i prázdné odpovědi nebo odpovědi s chybovým objektem. Pokud na to zapomenete, program spadne s výjimkou, kterou neumíte vysvětlit.

Promises a async/await jsou standard pro asynchronní kód. Místo řetězení .then().catch() můžete psát async function load() try const data = await fetch(url); catch (e) { ... } . Vyhněte se časté chybě – zapomenutí await u volání funkce vracející Promise, což vede k tomu, že pracujete s objektem Promise místo výsledku. Pokud potřebujete paralelní volání, použijte Promise.all, ale chraňte se před chybou jednoho z nich – buď přidejte .catch na každý promise, nebo použijte Promise.allSettled.

Druhá oblast, kde dělají mnozí chyby, je manipulace s proměnnými a stavem. Vyhněte se změnám globálních proměnných a sdílenému stavu. Když funkce mění data mimo sebe, je těžké sledovat, odkud se chyba vzala. Používejte parametry a návratové hodnoty. Pokud potřebujete pracovat s komplexním objektem, vytvořte si z něj nový objekt s upravenými hodnotami, neměňte původní. Tím se vyhnete vedlejším efektům, které způsobují nepredikovatelné chování. V moderním JavaScriptu k tomu máte skvělé nástroje – metody map, filter a reduce. Místo cyklu for, kde měníte pole, použijte map a vytvoříte nové pole. Je to nejen čistší, ale často i rychlejší.