coding-standards

Zbiór uniwersalnych standardów kodowania, najlepszych praktyk i wzorców dla projektów TypeScript, JavaScript, React i Node.js. Dowiesz się, jak pisać czytelny kod, unikać powtórzeń, stosować niezmienność danych i obsługiwać błędy. Materiał obejmuje konkretne przykłady nazewnictwa zmiennych i funkcji, wzorce obsługi wyjątków oraz asynchroniczne operacje. Skup się na prostocie i czytelności zamiast na nadmiernej złożoności.

1. Zapoznaj się z czterema głównymi zasadami jakości kodu: priorytet czytelności (kod czyta się znacznie częściej niż pisze), zasada KISS (wybieraj najprostsze rozwiązanie, które działa), zasada DRY (nie powtarzaj kodu, wyodrębniaj logikę do funkcji) oraz YAGNI (nie buduj funkcjonalności, których jeszcze nie potrzebujesz).

2. Zastosuj konwencje nazewnictwa dla zmiennych — używaj opisowych nazw zamiast skrótów (np. marketSearchQuery zamiast q, isUserAuthenticated zamiast flag). Dla funkcji stosuj wzorzec czasownik-rzeczownik (fetchMarketData, calculateSimilarity, isValidEmail).

3. Implementuj niezmienność danych w swoim kodzie — zawsze używaj operatora spread do aktualizacji obiektów i tablic (const updatedUser = {...user, name: 'New Name'}) zamiast bezpośredniej mutacji (user.name = 'New Name').

4. Wdrażaj kompleksową obsługę błędów w funkcjach asynchronicznych — używaj try-catch, sprawdzaj status odpowiedzi HTTP i rzucaj opisowe błędy zamiast ignorować wyjątki.

5. Optymalizuj operacje asynchroniczne — gdy to możliwe, wykonuj wiele operacji równolegle za pomocą Promise.all zamiast czekać na każdą sekwencyjnie.