Урок 061 минута чтения
Что такое “literal types”?
На этой странице
Кратко
Literal type описывает не общий тип вроде string, а конкретное значение: 'dark', 42 или true.
Вопрос
Что такое литеральные типы в TypeScript?
Определение
Литеральный тип - тип, который допускает только одно конкретное значение. Чаще всего литеральные типы объединяют в union, чтобы описать набор допустимых вариантов.
String literal types
type Theme = 'light' | 'dark';
let theme: Theme = 'light';
theme = 'dark';
theme = 'blue'; // ошибкаNumber literal types
type Dice = 1 | 2 | 3 | 4 | 5 | 6;
const roll: Dice = 6;Boolean literal types
type Success = true;
const ok: Success = true;Практический пример
type RequestState = 'idle' | 'loading' | 'success' | 'error';
function render(state: RequestState) {
if (state === 'loading') {
return 'Loading...';
}
}Такой тип защищает от опечаток и запрещает неизвестные состояния.
as const
const config = {
theme: 'dark',
} as const;as const делает значения максимально узкими и неизменяемыми на уровне типов.
Что важно помнить
- Литеральный тип — тип из одного значения:
"admin",42,true. - Объекты и массивы расширяют литералы до общих типов;
as constсохраняет литералы и делает значения readonly. - Union литералов — удобная замена enum.
- Template literal types (
`on${string}`) строят строковые литералы по шаблону.
Мини-шпаргалка
type Size = 'sm' | 'md' | 'lg';
type StatusCode = 200 | 400 | 500;Документация
TypeScript Handbook: Literal Types, TypeScript Handbook: Template Literal Types.
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.