Čitelný JavaScript: co psát, aby kód nebolel

Z Mazovia

Migraci spouštějte na kopii dat a s reálnou zátěží, ne na prázdné databázi. Po importu porovnejte počty řádků v každé tabulce, kontrolní součty u číselných sloupců a náhodné vzorky textů. Spusťte testovací sadu aplikace a projděte ručně scénáře, které sahají na datum, vyhledávání a stránkování. Teprve potom naplánujte odstávku nebo postupný přechod. Zálohu z původní databáze uchovejte aspoň do doby, než nový provoz poběží stabilně několik dní.

Kontrola změny nemá být formální. Jeden člověk by měl mít na starost maximálně krátký seznam změn a měl by vědět, co hledá. Komentáře pište k řádkům, ne obecně k celku. Pokud je změna příliš velká na rozumnou kontrolu, požádejte o rozdělení. Až je změna schválená, sloučte ji a větev smažte. to, co má v historii smysl, a tým neztrácí čas dohledáváním, která verze je vlastně aktuální.

Začněte tím, že si tým sladí pojmenování větví. Osvědčuje se krátký prefix podle typu práce a číslo úkolu, například oprava-loginu nebo funkce-export. Délka života větve by neměla přesáhnout několik dní. Dlouho otevřená větev znamená bolestivé slučování a konflikty, které nikdo nechce řešit. Když práce nejde dokončit rychle, rozdělte ji na menší části, které jdou sloučit samostatně.

Před odesláním změny k revizi si projděte vlastní rozdíl. Často se do commitu dostanou pomocné soubory, dočasné výpisy nebo zakomentovaný kód. Tyto věci patří do ignorovaného seznamu, ne do historie. Zároveň zkontrolujte, že změna nesahá do nesouvisejících souborů. Malý, soustředěný rozdíl se kontroluje rychle a snadno se vrací, pokud se něco pokazí.

Jak vypadá každodenní rytmus bez zbytečných kolizí Před začátkem práce si vezměte nejnovější stav hlavní větve a teprve pak vytvořte svou větev. Během práce průběžně stahujte změny z hlavní větve, ne až na konci. Čím dřív se konflikt objeví, tím levněji se řeší. Commity pište po logických celcích, ne po jednotlivých uloženích souborů. Zpráva commitu má říct, co se změnilo a proč, ne jak. Pokud commit opravuje chybu, uveďte v textu, co bylo příčinou.

Swift není jen náhrada Objective-C. Od svého vzniku se stal hlavním jazykem pro vývoj aplikací na platformách Applu a postupně nahrazuje starší základy i v existujících projektech. Pokud s vývojem pro iOS začínáte, Swift je přirozená volba: moderní syntaxe, bezpečnost typů a nástroje, které jsou s ním sladěné. Objective-C se hodí znát hlavně při údržbě staršího kódu, ale nové části aplikace pište ve Swiftu.

Pro psaní kódu stačí obvyklý odhad. U review ale nepočítejte jen dobu, kterou recenzent stráví nad soubory. Započítejte i latenci mezi odevzdáním a prvním komentářem. Když vývojář čeká půl dne, než se kolega k review dostane, úkol se posouvá, i když samotné čtení kódu zabere dvacet minut. Do odhadu proto dejte realistickou prodlevu podle toho, jak tým funguje, a ne ideál, kdy všichni reagují okamžitě.

Uložené procedury a triggery je nejlepší přepsat ručně. Jazyk PL/pgSQL se od MySQL procedur liší v deklaraci proměnných, v práci s kurzory i v ošetření výjimek. Zvláštní pozornost věnujte transakcím: PostgreSQL je plně transakční i u DDL, což je výhoda, ale některé dřívější zvyky z MySQL přestanou platit. Naplánujte testovací běh na kopii dat a porovnejte výsledky dotazů před a po migraci.

Čistý kód v JavaScriptu není otázka vkusu, ale údržby. Kód se čte mnohokrát častěji, než se píše, a většinu času ho bude měnit někdo jiný — nebo vy za půl roku. Základ je jednoduchý: pište tak, aby bylo z názvů a struktury zřejmé, co se děje, a nedělejte z jednoho řádku hlavolam. Když váháte mezi krátkým a srozumitelným zápisem, vyberte srozumitelný.

Malé funkce a jedna odpovědnost Funkce, která dělá tři věci, se špatně testuje i čte. Rozdělte ji: načtení, transformace a zápis patří zvlášť. Pomáhá i brzký návrat místo hlubokého vnořování. Místo if (a) if (b) { … } použijte if (!a) return; a pak if (!b) return;. Snižte počet parametrů; tři a víc uživatele nutí hledat pořadí v definici. Objekt s pojmenovanými poli je čitelnější než dlouhý seznam argumentů. A vyhněte se vedlejším efektům, pokud to jde — funkce, která jen vrací hodnotu, se snadno skládá a testuje.

Syntaxe dotazů se liší v detailech, které se snadno přehlédnou: zpětné apostrofy kolem názvů nahraďte dvojitými uvozovkami, funkce IFNULL změňte na COALESCE, GROUP_CONCAT na STRING_AGG, LIMIT x, y na LIMIT x OFFSET y. INSERT IGNORE a ON DUPLICATE KEY UPDATE přepište na ON CONFLICT DO NOTHING nebo DO UPDATE. Fulltext v MySQL nahradí v PostgreSQL tsvector s GIN indexem, což znamená přepsat dotazy i naplnění indexu. Ověřte také, jak aplikace pracuje s transakcemi: MySQL v režimu InnoDB a PostgreSQL se chovají podobně, ale úrovně izolace a chování při chybách se liší.