re:re:actable
Урок 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.

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

Поиск

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