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.
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ć.
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.
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
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.