Typy danych w TypeScript: kompletny przewodnik
Typy danych w TypeScript
Typy danych w TypeScript: każdy typ w jednej tabeli | We.Inc
string, number, boolean, bigint, symbol, null, undefined, any, unknown, never, void, object, tablice, krotki, enumy, literały i unie, każdy z przykładem.
Podstawowe typy danych w TypeScript to siedem prymitywów JavaScriptu: string, number, bigint, boolean, symbol, null i undefined, pisane małymi literami. Ponadto TypeScript dodaje typy specjalne (any, unknown, never, void, object), struktury takie jak tablice, krotki i enumy oraz sposoby łączenia typów: typy literałowe, unie i przecięcia.
Cztery grupy
- Grupa
- Typy
- Zastosowanie
- Prymitywy
- string, number, bigint, boolean, symbol, null, undefined
- Pojedyncze wartości
- Specjalne
- any, unknown, never, void, object
- Opisywanie granic systemu typów
- Struktury
- Tablice, krotki, enumy, typy obiektowe
- Grupy wartości
- Kombinacje
- Typy literałowe, unie, przecięcia
- Precyzyjne lub elastyczne kształty
Przeszukuj zestawienie po nazwie albo filtruj je według grupy. Każdy wiersz ma jednolinijkowy przykład, który możesz wkleić do pliku .ts, a kolumna uwag wskazuje zachowania, na których ludzie się potykają, na przykład różnicę między void a undefined albo powód, dla którego unknown jest bezpieczniejsze niż any.
- Wpisz tekst w polu wyszukiwania, aby dopasować nazwę typu, przykład lub uwagę.
- Użyj przycisków grup, aby pokazać tylko prymitywy, typy specjalne, struktury lub kombinacje.
- Przeczytaj przykład i uwagę w każdym wierszu; licznik nad tabelą pokazuje, ile wierszy pasuje.
- Gdy wiersz wymaga głębszego omówienia, skorzystaj z powiązanych przewodników o enumach, interfejsach i Record.
- Pisz string, number i boolean małymi literami. String, Number i Boolean z wielkiej litery to typy obiektów opakowujących i rzadko są tym, czego chcesz.
- Wartości spoza Twojego kodu, takie jak JSON i dane z formularzy, typuj jako unknown, a potem je zawężaj. any wyłącza sprawdzanie wszystkiego, czego dotknie.
- Pozwól, by inferencja wykonała pracę przy zmiennych lokalnych. Adnotuj parametry funkcji, typy zwracane eksportowanych funkcji oraz puste tablice i obiekty Map.
- W switch po unii dodaj gałąź default, która przypisuje wartość do never. Gdy ktoś doda nowy element, build wskaże każdy switch, który go pominął.
Najczęściej zadawane pytania
Ile typów prymitywnych ma TypeScript?
Siedem, tyle samo co JavaScript: string, number, bigint, boolean, symbol, null i undefined. number obejmuje zarówno liczby całkowite, jak i ułamkowe; nie ma osobnego typu int ani float.
Jaka jest różnica między any a unknown?
Oba akceptują dowolną wartość. any pozwala zrobić z nią wszystko, więc błędy przechodzą niezauważone. unknown nie pozwala zrobić nic, dopóki nie zawęzisz typu sprawdzeniem, na przykład przez typeof, dlatego to bezpieczny wybór dla niezaufanych danych.
Do czego służy typ never?
never opisuje wartości, które nie mogą wystąpić: typ zwracany funkcji, która zawsze rzuca wyjątek, oraz to, co zostaje z unii po obsłużeniu każdego jej elementu. To drugie zastosowanie napędza sprawdzanie wyczerpalności.
Czy void to to samo co undefined?
Nie. void to typ zwracany funkcji, której wartość zwracana powinna zostać zignorowana. Funkcji o typie zwracanym void można przekazać callback, który coś zwraca, natomiast undefined oznacza, że wartość naprawdę jest undefined.
Jaka jest różnica między object, Object i {}?
object oznacza dowolną wartość nieprymitywną, taką jak obiekty, tablice i funkcje. {} oznacza dowolną wartość z wyjątkiem null i undefined, w tym prymitywy. Globalny typ Object rzadko się przydaje; lepiej używać object lub konkretnego typu obiektowego.
Prymitywy: co zwraca typeof
- Typy prymitywne pisane małymi literami odpowiadają temu, co operator typeof w JavaScripcie zwraca w czasie działania, dlatego sprawdzenia typeof zawężają je tak czysto. Wyjątkiem jest null: typeof null zwraca "object", więc sprawdzaj go przez === null.
- bigint wymaga docelowej wersji ES2020 lub nowszej dla składni literału 123n. Wartości symbol są unikalne, nawet gdy utworzono je z tym samym opisem.
Typy specjalne wyznaczają granice
- any i unknown leżą na szczycie: mieści się w nich każda wartość. never leży na dnie: nie mieści się w nim żadna wartość, a sam mieści się w każdym innym typie. void dotyczy wartości zwracanych, a object służy do wykluczania prymitywów.
- Wiedza o tym, przy której granicy jesteś, sprawia, że komunikaty kompilatora stają się czytelne. Błąd wspominający never po zawężeniu zwykle oznacza gałąź, która według kodu nigdy nie może się wykonać.
Łączenie typów
- Typ literałowy zawęża prymityw do dokładnych wartości, na przykład "left" | "right". Unia mówi, że wartość jest jednym z kilku typów; przecięcie mówi, że jest wszystkimi naraz, i tak właśnie łączy się dwa typy obiektowe.
- Unie literałów tekstowych często zastępują enumy, bo są całkowicie usuwane podczas kompilacji i naturalnie czyta się je w kodzie. Przewodnik o enumach na tej stronie porównuje oba podejścia.
Od unknown do użytecznego typu
Zawężaj niezaufane dane krok po kroku
Każde sprawdzenie usuwa kolejne możliwości. W ostatniej gałęzi kompilator wie, że value jest typu string.
never jako sprawdzenie wyczerpalności
Jeśli do unii dołączy nowy status, przypisanie do never przestanie się kompilować, dopóki nie dodasz dla niego case.
Tekst dowolnej długości. Template literals to również stringi.
Zarówno liczby całkowite, jak i ułamkowe, w tym NaN i Infinity.
Liczby całkowite spoza bezpiecznego zakresu. Przyrostek n wymaga docelowej wersji ES2020.
Tylko true lub false.
Każde wywołanie Symbol() tworzy unikalną wartość.
Przy włączonym strictNullChecks null musi być wymieniony w typie, aby był dozwolony.
Wartość zadeklarowanej, ale nieprzypisanej zmiennej oraz brakującej opcjonalnej właściwości.
Wyłącza sprawdzanie tej wartości. noImplicitAny zgłasza miejsca, w które wkrada się bez zapowiedzi.
Przechowuje dowolną wartość, ale nie pozwala na nic, dopóki jej nie zawęzisz.
Żadna wartość nigdy nie ma tego typu: funkcje, które zawsze rzucają wyjątek, i unie, w których nic nie zostało.
Wartość zwracana, którą należy zignorować. To nie to samo co undefined.
Dowolna wartość nieprymitywna: obiekty, tablice i funkcje.
Tablica
string[] i Array<string> oznaczają to samo.
Tablica readonly
To samo co ReadonlyArray<number>. push i inne metody modyfikujące są usunięte.
Krotka (tuple)
Stała długość z typem dla każdej pozycji. Elementy opcjonalne idą na koniec: [number, number?].
W przeciwieństwie do większości składni TypeScript tworzy prawdziwy obiekt w czasie działania.
Typ obiektowy
Opisuje właściwości inline. Nazwij go przez type lub interface, aby użyć ponownie.
Typ funkcji
Typy parametrów i wartości zwracanej. Lepszy niż luźny typ Function.
Typ literałowy
Dokładne wartości zamiast całego prymitywu.
Unia
Jeden z kilku typów. Przed użyciem elementów zawęź przez typeof, in lub wspólne pole.
Przecięcie
Wszystkie typy naraz. Używane głównie do łączenia typów obiektowych.
Prymitywy
Specjalne
Struktury
Kombinacje
Przeszukiwalne zestawienie typów
Szukaj typów
unknown, tuple, null...
Filtruj według grupy
Wszystkie
Wyświetlono {n} z {v} typów
Żaden typ nie pasuje do wyszukiwania.
Typy TypeScript z przykładami
Typ
Grupa
Przykład
Uwaga
Zbuduj stronę za darmo · Za darmo, bez karty
Powiązane: Poradniki
- Enumy w TypeScript i ich alternatywy
- Interfejsy w TypeScript
- Pętle w TypeScript i typy, które z nich wynikają
- Map w TypeScript
- Typ Record w TypeScript wyjaśniony na Twoich kluczach
- TypeScript vs JavaScript
- User flow i wireframe'y stron
- UUID v4 vs v7
Produkt
Dla kogo
- Dla agencji
- Dla freelancerów
- Dla firm hostingowych
- Dla platform SaaS
- Dla startupów
- Usługi finansowe
- Rozwiązania dla ochrony zdrowia
Funkcje
Zasoby
- Blog
- Centrum pomocy
- Darmowe narzędzia dla firm
- Free UI Components
- Szablony
- Kolekcje szablonów
- Przykłady stron
- Poradniki
- Porównania
- Alternatywy
- Najlepsze
- Recenzje
- Przewodniki po cenach
- Zastosowania
- Słownik i poradniki
- Integracje
- Dla programistów
- Benchmark
- Windows App