ENATIV Logo
ENATIV
Powrót
© 2026 ENATIV
ProjektyOfertaBaza wiedzyKontakt
kontakt@enativ.pl
  1. Baza wiedzy
  2. ›
  3. Frontend
  4. ›
  5. TypeScript

TypeScript

JavaScript ze składnią typów: kompilator sprawdza kształt danych, a w wyniku zostaje zwykły JavaScript.

FrontendUżywam od 2015 · Wyróżniony projekt: Budzowska Fiutowski i Partnerzy

Kategoria
Frontend
Używam od
2015
Wyróżniony projekt
Budzowska Fiutowski i Partnerzy

W praktyce

TypeScript traktuję jak domyślny język projektu, bo typy łapią błędy tam, gdzie dane zmieniają rękę: między formularzem, API a bazą. W Gaia Lens frontend przeszedł z JavaScriptu na TypeScript, a formularz kontaktowy w ENATIV Portfolio ma jeden schemat dla przeglądarki i serwera. Skrypt na jedno popołudnie piszę w zwykłym JavaScripcie.

Czym jest TypeScript?

TypeScript to JavaScript ze składnią typów. Każdy działający kod JavaScript jest też poprawnym kodem TypeScript, więc projekt można przenosić stopniowo. Kompilator sprawdza typy i usuwa je z wyniku, dlatego w przeglądarce i na serwerze działa zwykły JavaScript.

System typów jest strukturalny: o zgodności decyduje kształt obiektu, a nie nazwa jego typu. Typy znikają przy kompilacji, więc w czasie działania niczego nie sprawdzają. Dane z zewnątrz, na przykład z formularza albo odpowiedzi API, trzeba zwalidować osobno.

System typów
Strukturalny
Typy po kompilacji
Usuwane z wyniku

Jak pracuję z TypeScript

Zaczynam od miejsc, w których dane wchodzą do aplikacji z zewnątrz, bo tam typy bez sprawdzenia w czasie działania mylą najłatwiej. Wnętrza kodu pilnuje kompilator, a granic walidacja. W środku opisuję mniej typów, a na brzegach więcej: nie adnotuję każdej zmiennej, bo kompilator sam wnioskuje typy tam, gdzie może.

  1. Granica z zewnątrz

    Dane z formularza i tras API przechodzą przez schemat Zod, a typ wynika ze schematu. W ENATIV Portfolio formularz kontaktowy i trasa API korzystają z jednego schematu, więc nie mogą się rozjechać.

  2. Tryb strict od początku

    Włączam tryb strict w pierwszym commicie i nie uciszam kompilatora komentarzami. Tak działa ENATIV Portfolio: tryb strict jest włączony, a w kodzie nie ma komentarzy wyłączających sprawdzanie typów.

  3. Migracja bez przepisywania

    Istniejący JavaScript przenoszę stopniowo, od miejsc, w których błędy kosztują najwięcej. W Gaia Lens frontend przeszedł na TypeScript wtedy, gdy rozwijanie starego kodu stawało się coraz cięższe.

Kiedy tak, a kiedy nie

TypeScript dokłada do projektu konfigurację i naukę, więc pytam, czy ten koszt się zwróci.

Sprawdza się, gdy

  • Aplikacja, którą będzie rozwijać więcej niż jedna osoba albo dłużej niż rok.
  • Projekt z API, formularzami i bazą, w którym dane zmieniają kształt po drodze.
  • Kod współdzielony między frontendem a backendem, na przykład schematy walidacji.
  • Istniejący JavaScript, który robi się trudny do zmiany.

Nie sprawdza się, gdy

  • Skrypt na jedno popołudnie albo prototyp, który trafi do kosza.
  • Kilka linijek skryptu na stronie, bez własnej logiki.
  • Krótki projekt, w którym nikt nie zdąży skorzystać z typów.

W tych przypadkach zostaje zwykły JavaScript. Przy projektach w Reakcie i Next.js wybieram TypeScript domyślnie.

Często zadawane pytania

Na starcie trochę, bo trzeba opisać kształt danych i skonfigurować kompilator. Zwraca się przy zmianach: kompilator wskazuje miejsca, które pękły po zmianie typu, zanim zobaczy je użytkownik. Przy kodzie na jedno popołudnie ten zwrot nie nastąpi, więc tam TypeScript pomijam.
Da się i bez wstrzymywania prac, bo działający plik JavaScript jest też poprawnym TypeScriptem, a kompilator może przyjmować pliki JavaScript. Przenoszę kod stopniowo, od miejsc, gdzie błędy kosztują najwięcej. W Gaia Lens migracja objęła cały frontend.
Same nie, bo typy znikają przy kompilacji i w czasie działania niczego nie sprawdzają. Dane z zewnątrz waliduję osobno schematem Zod, a typ wyprowadzam z tego schematu. Tak działa formularz kontaktowy w ENATIV Portfolio: jeden schemat obsługuje i formularz, i trasę API.
Zmiany treści nie wymagają programisty, bo redaktor pracuje w panelu CMS. Zmiany w kodzie już tak, więc zanim wybiorę TypeScript, pytam, kto będzie rozwijał projekt po wdrożeniu. Jeśli nikt, rozważam prostsze narzędzie, żeby nie zostawić Ci kodu, którego nie da się ruszyć.
Nie. Wyłapuje niezgodność typów, ale nie sprawdzi, czy logika robi to, czego potrzebujesz, ani czy dane z zewnątrz mają obiecany kształt. Dlatego typy traktuję jak siatkę bezpieczeństwa obok walidacji i przeglądu kodu, a nie zamiast nich.

Na tej stronie

  • W praktyce
  • Czym jest TypeScript?
  • Jak pracuję z TypeScript
  • Kiedy tak, a kiedy nie
  • Często zadawane pytania

Powiązane hasła

  • TypeScript
  • React
  • Next.js
  • React Native
  • Payload CMS

W ofercie

  • Aplikacje WeboweNowoczesne, szybkie i skalowalne aplikacje webowe w React i Next.js.
  • Aplikacje MobilneNatywne aplikacje na iOS i Android zbudowane w React Native i Expo.

Masz kod w JavaScripcie, który trudno zmieniać?

Opisz, gdzie błędy pojawiają się najczęściej i kto pracuje w kodzie. Wskażę miejsca, od których zacząłbym typowanie, i powiem, czy to ma sens przy Twoim projekcie.

Opisz swój projektZobacz Budzowska Fiutowski i Partnerzy