TypeScript Academy · Lekcja

Narzędzia Flatten i UnwrapPromise

Pisz typy rozwijające zagnieżdżone struktury generyczne.

Narzędzia Flatten i UnwrapPromise to bezpłatna lekcja TypeScript Academy na CoddyKit. To lekcja 2 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej TypeScript Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs TypeScript Academy zawiera 4 lekcji w sumie.

Problem spłaszczania

Tablice JavaScriptu mogą być zagnieżdżone. Narzędziowy typ Flatten rekurencyjnie usuwa opakowania tablicowe z typu, zwracając typ najbardziej wewnętrznego elementu.

type Flatten<T> = T extends (infer U)[] ? Flatten<U> : T;
type A = Flatten<number[][][]>; // number
type B = Flatten<string[]>;     // string

Spłaszczanie nierekurencyjne (jeden poziom)

Spłaszczanie jednego poziomu odpowiada działaniu Array.prototype.flat(1) — usuwa dokładnie jeden poziom zagnieżdżenia.

type FlatOnce<T> = T extends (infer U)[] ? U : T;
type A = FlatOnce<number[][]>; // number[]
type B = FlatOnce<string[]>;   // string

Rekurencyjne spłaszczanie

Wersja rekurencyjna naśladuje działanie Array.prototype.flat(Infinity), rekurencyjnie usuwając kolejne opakowania tablicowe, aż nie pozostanie żadne.

type Flatten<T> = T extends (infer U)[] ? Flatten<U> : T;
type C = Flatten<boolean[][][]>; // boolean

UnwrapPromise: jeden poziom

Usuń jedną warstwę Promise za pomocą infer.

type UnwrapPromise<T> = T extends Promise<infer U> ? U : T;
type D = UnwrapPromise<Promise<string>>; // string
type E = UnwrapPromise<number>;          // number

Głębokie UnwrapPromise

Rekurencyjnie usuwaj zagnieżdżone promisy — jest to odpowiednik wbudowanego typu Awaited.

type DeepUnwrap<T> = T extends Promise<infer U> ? DeepUnwrap<U> : T;
type F = DeepUnwrap<Promise<Promise<number>>>; // number

Łączenie Flatten i UnwrapPromise

Połączony typ obsługuje zarówno promisy, jak i tablice, co jest przydatne w funkcjach asynchronicznych zwracających tablice.

type Simplify<T> =
  T extends Promise<infer U> ? Simplify<U>
  : T extends (infer V)[] ? Simplify<V>
  : T;

type G = Simplify<Promise<string[][]>>; // string

Wbudowany Awaited<T>

TypeScript 4.5+ zawiera Awaited, który rekurencyjnie usuwa opakowanie z typów thenable, w tym z thenable niebędących promisem.

type H = Awaited<Promise<Promise<string>>>; // string
// Also handles custom thenables with .then()

Usuwanie opakowania z wartości Map

Ten sam wzorzec z infer wyodrębnia typy wartości z Map.

type MapValue<T> = T extends Map<any, infer V> ? V : never;
type I = MapValue<Map<string, number[]>>; // number[]

FlattenObject: scalanie zagnieżdżonych interfejsów

Spłaszczacz obiektów na poziomie typów scala zagnieżdżone typy obiektów — jest bardziej złożony, ale przydatny do głębokiego scalania konfiguracji.

// This requires recursive mapped types + intersection spreading
// See the DeepPartial lesson for the base pattern

Zastosowanie w praktyce: usuwanie opakowania z odpowiedzi API

Usuń zagnieżdżone opakowania odpowiedzi API, aby uzyskać typ danych bez ręcznych asercji typów.

type ApiData<T> = { data: T; status: number };
type ExtractData<T> = T extends ApiData<infer D> ? D : T;
type J = ExtractData<ApiData<User[]>>; // User[]

Podsumowanie: spłaszczanie i usuwanie opakowań

Flatten i UnwrapPromise używają rekurencyjnych typów warunkowych z infer do usuwania opakowań typów. Używaj Awaited do usuwania opakowania z promisu, a dla innych struktur twórz własną rekurencję.

Szybkie sprawdzenie

Co zwraca Flatten?

Czego się Państwo nauczyli

Flatten i UnwrapPromise to rekurencyjne typy warunkowe, które usuwają opakowania generyczne. Połącz je, aby uprościć złożone zagnieżdżone typy, a do łańcuchów promisu używaj wbudowanego Awaited.

Często zadawane pytania

Czy lekcja „Narzędzia Flatten i UnwrapPromise” jest bezpłatna?

Tak — pełny tekst „Narzędzia Flatten i UnwrapPromise” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu TypeScript Academy, przejdź na CoddyKit PRO. Kurs TypeScript Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Narzędzia Flatten i UnwrapPromise”?

Pisz typy rozwijające zagnieżdżone struktury generyczne. Ćwiczysz TypeScript Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć TypeScript Academy?

Nie wymagamy żadnego doświadczenia. TypeScript Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 2 z 4.

Ile czasu zajmuje lekcja „Narzędzia Flatten i UnwrapPromise”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji TypeScript Academy?

Tak. Każda lekcja TypeScript Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do TypeScript Academy