Урок 051 минута чтения
Оператор keyof
На этой странице
Кратко
keyof получает union ключей объектного типа. Например, keyof User превращается в "id" | "name" | "email".
Вопрос
Что делает оператор keyof?
Базовый пример
type User = {
id: number;
name: string;
email: string;
};
type UserKey = keyof User;
// "id" | "name" | "email"Безопасный доступ к полю
function getValue<T, K extends keyof T>(object: T, key: K): T[K] {
return object[key];
}
const user = { id: 1, name: "Анна" };
const name = getValue(user, "name");
// stringkeyof не дает передать несуществующий ключ.
В mapped types
type Optional<T> = {
[K in keyof T]?: T[K];
};Так работает множество utility-типов.
С index signature
type Dictionary = {
[key: string]: number;
};
type DictionaryKey = keyof Dictionary;
// string | numberЧисла попадают в ключи из-за правил JavaScript: числовые ключи приводятся к строкам.
Что важно помнить
keyof Tвозвращает union ключей объектного типа.- Для типа с index signature
[k: string]keyofдаетstring | number. keyof typeof objполучает ключи из значения.- Пересечение с
string(keyof T & string) убирает числовые и символьные ключи там, где нужны строки.
Мини-шпаргалка
keyof Tвозвращает union ключейT.- Часто используется с
K extends keyof T. - В mapped types перебирает поля объекта.
- Вместе с
T[K]дает точную типизацию доступа к свойствам.
Документация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.