Jak Postavit REST API S Node.js A Express

Testování jednotek je nedílnou součástí vývoje kvalitního softwaru. Pokud používáte C# a chcete mít jistotu, že váš kód funguje tak, jak má, NUnit je solidní volbou. Tento framework je snadno integrovatelný do .NET projektů a nabízí přehlednou syntaxi pro psaní testů. V tomto článku se podíváme na praktické kroky, jak testy psát, na co si dát pozor a jaké chyby při tom nejčastěji vznikají.

Nejprve si vytvořte testovací projekt. Ve Visual Studiu nebo v .NET CLI použijte šablonu projektu pro NUnit. Do projektu pak přidejte odkaz na testovaný projekt – to je důležité, aby testy viděly třídy a metody, které chcete ověřit. Základní struktura testu vypadá takto: třída s atributem [TestFixture] a metody s atributem [Test]. Každá metoda testuje jednu konkrétní věc. Například pokud máte třídu Calculator, test metody Add ověří, že součet dvou čísel je správný.

Většina začínajících vývojářů řeší stejný paradox: firmy chtějí zkušenosti, ale odkud je vzít, když vás nikdo nechce zaměstnat? Řešení neleží v neustálém posílání životopisů, ale v cíleném budování dovedností, které jsou na trhu žádané. Než začnete rozesílat přihlášky, zjistěte si, jaké technologie se ve vašem regionu skutečně používají. Projděte si inzeráty na pozice juniorů a všimněte si, které jazyky a frameworky se opakují. Tento průzkum vám ušetří měsíce učení něčeho, co nikdo nehledá.

Při návrhu REST API v Node.js se Express stal de facto standardem. Než začnete psát první endpoint, mějte jasno v tom, co vaše API skutečně potřebuje. Základní kostra je jednoduchá – stačí vytvořit instanci aplikace, nadefinovat port a spustit posluchač. Ale pozor, samotné spuštění serveru nestačí. Důležité je hned na začátku nastavit správné middleware, jako je parsování JSON těla a logování požadavků. Bez nich narazíte na problémy, když začnete testovat reálné požadavky z prohlížeče nebo z externího klienta.

Při psaní testů se vyplatí používat přípravné metody Assert.That s constrainty. Tyto konstrukce jsou čitelnější než klasické Assert.AreEqual. Například Assert.That(result, Is.EqualTo(5)) je přehledné a navíc poskytuje detailnější výstup při selhání. Pozor na porovnávání desetinných čísel – s plovoucí přesností se může stát, že očekávaná hodnota nebude přesně sedět. V tom případě použijte Is.EqualTo(vyhledávaná_hodnota).Within(0.001), abyste povolili malou odchylku.

Na závěr si osvojte pravidlo: Grid pro makro, Flexbox pro mikro. Když řešíte celou stránku, sáhněte po Gridu. Když řešíte zarovnání pár prvků v řadě, použijte Flexbox. Kombinací obou technik dosáhnete responzivního designu, který se snadno čte a přizpůsobuje. Testujte v prohlížeči na různých šířkách, používejte DevTools pro ladění a hlavně se nebojte experimentovat – obě metody mají bohatou dokumentaci a příkladů najdete dost.

Když procházíte historii projektu, každá commit zpráva by měla odpovědět na dvě otázky: co se změnilo a proč. Většina vývojářů ale píše zprávy jako „oprava bugu" nebo „úpravy". Takové popisy jsou k ničemu, protože neříkají, co přesně se dělo, a hlavně proč. Bez kontextu se po pár měsících vracíte k hádankám a musíte ručně procházet diff, abyste zjistili, co se vlastně stalo. Cílem není psát romány, ale dodat dostatek informací, aby se kdokoli v historii rychle zorientoval.

Dalším bodem je délka zprávy. Krátké shrnutí je povinné, ale podrobný popis by měl být maximálně pár odstavců. Pokud potřebujete vysvětlit více, je lepší rozdělit změny na menší commity. Nepište ale ani zprávy, které jsou jen shrnutím diffu – to je zbytečné. Místo toho se zaměřte na kontext: jaké problémy změna řeší, jaké jsou její vedlejší účinky, co by mohlo být překvapivé. Tím pomůžete kolegům i budoucímu sobě.

Dalším častým problémem je testování příliš mnoha věcí v jednom testu. Metoda by měla ověřovat jen jednu chování. Pokud máte metodu, která počítá a zároveň ukládá do souboru, rozdělte test na dvě části – jednu pro výpočet a druhou pro uložení. Tím snadněji najdete příčinu, když test selže. Používejte také srozumitelné názvy testů, které popisují očekávané chování, například Add_ReturnsCorrectSum_WhenGivenTwoPositiveNumbers. Takový název je samodokumentující a usnadňuje údržbu.

Nejprve je potřeba pytest nainstalovat. To provedete příkazem pip install pytest v terminálu. Po instalaci vytvořte soubor s názvem test_example.py. Název musí začínat nebo končit slovem test, aby pytest soubor automaticky našel. V tomto souboru definujte funkce, jejichž názvy také začínají test_. Uvnitř funkcí použijte běžné assert pro ověření výsledku. Pytest pak spustíte příkazem pytest v adresáři s testem.