První kroky s API: průvodce pro úplné začátečníky

Nakonec se zaměřte na pojmenování testů. Název by měl popisovat očekávané chování, ne název funkce. Místo testAdd() pište testAddReturnsSumOfTwoNumbers nebo testAddThrowsWhenInputIsNegative. Když test selže, hned z názvu víte, co se rozbilo. Pokud máte problém vymyslet název, pravděpodobně nerozumíte tomu, co funkce dělá. V takovém případě se vraťte o krok zpět a nejprve si ujasněte chování. První test nemusí být dokonalý, ale musí být poctivý. Jakmile jednou projdete celým procesem, další testy půjdou rychleji.

Při psaní prvního testu se také vyplatí myslet na okrajové případy. Prázdný vstup, nulová hodnota, extrémně velké číslo nebo prázdný řetězec. Tyto případy často odhalí chyby, které běžné použití neukáže. Začněte s jedním šťastným scénářem, ale hned poté přidejte test pro neplatný vstup. Funkce by měla selhat elegantně, ne spadnout s nesrozumitelnou výjimkou. Pokud testujete funkci, která dělí, přidejte test pro dělení nulou. Pokud parsujete text, otestujte prázdný řetězec.

Časté chyby, které vás připraví o smysl testů První typická chyba je testování implementace místo chování. Když testujete, že funkce volá jinou funkci s určitými argumenty, svazujete si ruce pro budoucí refaktoring. Test by měl selhat pouze tehdy, když se změní výsledek, ne když se změní vnitřní struktura kódu. Druhá častá chyba je psaní testů, které projdou i bez testované funkce. Typicky jde o testy, které kontrolují jen to, že funkce nevyhodí výjimku, ale nekontrolují návratovou hodnotu. Takový test je k ničemu.

Další osvědčený postup je normalizace stavu. Pokud ukládáte pole objektů, snažte se je ukládat jako objekt s id jako klíčem a pomocí pole id uchovávat pořadí. To usnadňuje aktualizace a vyhledávání. V praxi to znamená, že v slice budete mít strukturu: items: [id]: item , order: [] . Při přidání nové položky stačí upravit jeden uzel, nikoliv celé pole. Tím se výrazně zlepší výkon při velkých seznamech.

Prvním krokem k čistšímu kódu je správná struktura složek. Místo dělení na actions, reducers a types podle typu, seskupte soubory podle feature – například userSlice, cartSlice nebo productsSlice. Dnes se doporučuje používat Redux Toolkit, který výrazně redukuje psaní boilerplate kódu. Pomocí funkce createSlice definujete state, reducers a akce na jednom místě. To eliminuje chyby z přepisování názvů akcí a usnadňuje údržbu. Nezapomeňte, že každý slice by měl být nezávislý a měl by obsahovat jak data, tak i stav načítání a chybové stavy.

Klíčová je jednotná struktura a pojmenování Zvolte si systém pojmenování, který srozumitelně popisuje účel textu, ne jeho doslovný překlad. Místo názvů jako button_save nebo error_404 používejte sémantické názvy jako action.save nebo message.not_found. Taková konvence vám umožní snadno přidávat nové jazyky, aniž byste museli přepisovat stávající klíče. Důležité je také sjednotit formát čísel, dat a měn napříč jazyky – vždy používejte lokalizační funkce, nikoliv pevně zapsané oddělovače. Tím se vyhnete chybám, které vznikají při ručním formátování.

Na závěr – efektivní použití Reduxu vyžaduje nejen znalost API, ale i disciplínu. Pravidelně kontrolujte, zda se ve store nehromadí nepotřebná data. Pokud některý stav nepoužívá více komponent, zvažte jeho přesun do lokálního stavu. A pamatujte, že Redux není výkonnostní nástroj – je to nástroj pro předvídatelnost a debuggování. S Redux Toolkit a správnými návyky se psaní React aplikací stane přehlednější a méně náchylné k chybám.

Velkým problémem bývá překlad dynamických textů, které se skládají z více částí. Typická chyba je spojovat věty pomocí řetězců, což vede k neohrabaným formulacím v některých jazycích. Místo toho používejte tzv. pluralizaci a interpolaci proměnných, které jsou součástí většiny moderních překladových knihoven. Například místo „Máte X zpráv" nadefinujete zvlášť tvary pro jeden, několik a mnoho kusů. Tím zajistíte, že věta bude gramaticky správně v češtině i v angličtině, a to bez dodatečných podmínek v kódu.

Na závěr si vyzkoušejte složitější scénář: požadavek, který vyžaduje autentizaci. Registrace a získání klíče je běžná praxe, ale dávejte pozor na to, abyste klíč nikdy nezveřejnili. Používejte proměnné prostředí nebo konfigurační soubory, které ignoruje vaše verze správy zdrojového kódu. Soustřeďte se na správné zasílání klíče v hlavičce, které je dnes standardem. Postupně tak zvládnete i pokročilejší techniky a vaše aplikace začnou skutečně využívat sílu cizích služeb.

První reálný požadavek a časté chyby Jakmile máte adresu koncového bodu, pošlete svůj první požadavek metodou GET. Většina API očekává určité parametry, které se předávají buď přímo v adrese, nebo v hlavičce. Nejdřív si přečtěte dokumentaci – i když vás to láká přeskočit, najdete tam povinné parametry a omezení. Typická chyba začátečníků je posílat požadavky bez správných hlaviček, jako je definice formátu. Když server odpoví chybou 400 nebo 404, nepropadejte panice: zkuste si přečíst odpověď, často obsahuje přesné vysvětlení.