re:re:actable
Урок 041 минута чтения

Index Access Types

На этой странице
Кратко

Indexed access types позволяют достать тип свойства по ключу: T[K]. Это type-level аналог обращения object[key].

Вопрос

Что такое Index Access Types?

Базовый пример

type User = {
  id: number;
  name: string;
  email: string;
};
 
type UserName = User["name"];
// string

Ключ указывается в квадратных скобках на уровне типов.

Несколько ключей

type UserPublicValue = User["id" | "name"];
// number | string

Если ключей несколько, результатом будет union типов значений.

С keyof

type UserValue = User[keyof User];
// number | string

Так можно получить union всех типов значений объекта.

В generic-функции

function getProperty<T, K extends keyof T>(object: T, key: K): T[K] {
  return object[key];
}

T[K] делает результат точным: для ключа "name" вернется string, для "id" - number.

С массивами

type Users = User[];
type UserItem = Users[number];
// User

ArrayType[number] достает тип элемента массива.

Что важно помнить

  • T["key"] получает тип свойства, T["a" | "b"] — union типов свойств.
  • T[number] получает тип элемента массива или кортежа: (typeof list)[number].
  • T[keyof T] — union типов всех значений объекта.
  • Индексный тип работает только с типами, а не со значениями — для значения нужен typeof.

Мини-шпаргалка

  • T[K] достает тип значения по ключу.
  • T["a" | "b"] возвращает union значений.
  • T[keyof T] - union всех значений объекта.
  • Array[number] достает тип элемента массива.

Документация

TypeScript Handbook: Indexed Access Types.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам