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

Produkt

Dla kogo

Funkcje

Zasoby

Firma

Mapa strony