TypeScript Academy · Lekcja

Typy dostępu indeksowanego

Pobieraj typy właściwości za pomocą składni T[K]

Typy dostępu indeksowanego to bezpłatna lekcja TypeScript Academy na CoddyKit. To lekcja 3 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.

Sprawdzanie typów właściwości

Typy dostępu indeksowanego pozwalają sprawdzić typ właściwości za pomocą składni nawiasów w pozycji typu: Obj['prop']. Przypomina to odczytywanie wartości, ale odbywa się na poziomie typów.

Podstawowy dostęp indeksowany

Zindeksuj typ za pomocą klucza literałowego, aby wyodrębnić typ danej właściwości. User['name'] daje typ string.

interface User { id: number; name: string }
type NameType = User["name"] // string
const n: NameType = "Ada"
console.log(n)

Dlaczego nie zapisać po prostu typu

Dostęp indeksowany utrzymuje typy w synchronizacji. Jeśli User.name zmieni się z string na coś innego, każdy zapis User['name'] zostanie automatycznie zaktualizowany — bez ręcznych zmian.

interface Product { price: { amount: number; currency: string } }
type Price = Product["price"] // { amount: number; currency: string }
const p: Price = { amount: 10, currency: "USD" }
console.log(p)

Dostęp za pomocą unii kluczy

Zindeksuj typ za pomocą unii kluczy, aby uzyskać unię ich typów wartości. User['id' | 'name'] daje number | string.

interface User { id: number; name: string }
type IdOrName = User["id" | "name"] // number | string
const v: IdOrName = 5
console.log(v)

Obj[keyof Obj] dla wszystkich wartości

Zindeksuj typ za pomocą keyof Obj, aby uzyskać unię wszystkich typów wartości w obiekcie — pełny zbiór jego typów wartości.

interface Config { host: string; port: number; secure: boolean }
type Values = Config[keyof Config] // string | number | boolean
const v: Values = true
console.log(v)

Typ elementu tablicy za pomocą [number]

W przypadku typu tablicy zindeksuj go za pomocą number, aby uzyskać typ jego elementów. string[][number] daje typ string.

type Names = string[]
type Item = Names[number] // string
const x: Item = "Ada"
console.log(x)

Typ elementu krotki

Zindeksowanie krotki za pomocą number daje unię typów wszystkich jej elementów — jest to przydatne do wyprowadzania typu wartości ze stałej listy.

type Pair = [string, number]
type Element = Pair[number] // string | number
const e: Element = 42
console.log(e)

Łączenie z typeof

Uzyskaj typ wartości za pomocą typeof. W połączeniu z [number] na tablicy z as const pozwala to wyprowadzić unię dosłownych wartości tablicy.

const colors = ["red", "green", "blue"] as const
type Color = typeof colors[number] // "red" | "green" | "blue"
const c: Color = "green"
console.log(c)

Zagnieżdżony dostęp indeksowany

Łącz odwołania, aby zagłębiać się w zagnieżdżone typy. Każda para nawiasów kwadratowych przenosi o jeden poziom niżej w strukturze.

interface Data { user: { profile: { age: number } } }
type Age = Data["user"]["profile"]["age"] // number
const a: Age = 36
console.log(a)

Dostęp indeksowany w generykach

Wzorzec T[K] z K extends keyof T stanowi podstawę bezpiecznych typowo getterów: typ zwracany jest dokładnie typem wyszukanej właściwości.

function get<T, K extends keyof T>(obj: T, key: K): T[K] {
  return obj[key]
}
const port = get({ host: "x", port: 80 }, "port")
console.log(port) // 80, typed as number

Praktyczne wyprowadzenie

Dostęp indeksowany pozwala uniknąć duplikowania typów: typ argumentu funkcji można wyprowadzić bezpośrednio z obiektu domenowego zamiast deklarować go ponownie.

interface Order { items: { sku: string; qty: number }[] }
type LineItem = Order["items"][number] // { sku: string; qty: number }
const li: LineItem = { sku: "A1", qty: 2 }
console.log(li)

Szybkie sprawdzenie

Proszę sprawdzić swoją wiedzę na temat typów dostępu indeksowanego.

Podsumowanie

Typy dostępu indeksowanego (Obj['prop']) wyszukują typ właściwości i pozostają zsynchronizowane ze źródłem. Indeksowanie unią kluczy daje unię typów wartości, indeksowanie za pomocą keyof Obj — wszystkie wartości, a za pomocą number — typy elementów tablicy lub krotki. Nawiasy kwadratowe można łączyć w celu zagnieżdżonego wyszukiwania, a także używać ich razem z typeof i generykami (T[K]) do bezpiecznego typowo wyprowadzania typów.

Często zadawane pytania

Czy lekcja „Typy dostępu indeksowanego” jest bezpłatna?

Tak — pełny tekst „Typy dostępu indeksowanego” 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 „Typy dostępu indeksowanego”?

Pobieraj typy właściwości za pomocą składni T[K] Ć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 3 z 4.

Ile czasu zajmuje lekcja „Typy dostępu indeksowanego”?

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