Что такое…

Что такое enum — и почему в JavaScript его нет, а в TypeScript от него отказываются

Иллюстрация: органайзер ровно на четыре ячейки и лишняя фишка, которой места нет

В коде есть статус заказа. Где-то пишут "paid", где-то "Paid", а в одном месте — "payed" с ошибкой. Программа не падает. Она просто молча решает, что заказ не оплачен, и не отправляет его. Ищешь такой баг час.

Против этого придумали enum — перечисление. И вот неожиданная штука: в JavaScript его нет вовсе, а в TypeScript он есть, но всё больше команд им не пользуются. Разберёмся, почему, и что писать вместо него.

Что такое enum

Enum — это закрытый список допустимых значений с именами. Не «любая строка», а «одно из вот этих».

Статус заказа: новый, оплачен, отправлен, доставлен. Четыре варианта, пятого не бывает. Дни недели — семь. Роль пользователя — гость, участник, админ.

Когда такой список объявлен, ты пишешь не строку руками, а выбираешь вариант по имени: Status.Paid. Опечатка в имени — и редактор подчеркнёт её сразу, до запуска. Строку "payed" он бы пропустил.

В этом вся польза: ошибка переезжает из работающего приложения в момент, когда ты печатаешь.

Как это выглядит в коде

В TypeScript есть отдельное слово enum:

enum Status {
  New = "new",
  Paid = "paid",
  Shipped = "shipped",
}

function ship(status: Status) { /* ... */ }

ship(Status.Paid);   // ок
ship("payed");       // ошибка прямо в редакторе

В Python — модуль enum:

from enum import Enum

class Status(Enum):
    NEW = "new"
    PAID = "paid"

А в JavaScript слова enum нет. Там обычно делают объект и замораживают его:

const Status = Object.freeze({
  New: "new",
  Paid: "paid",
  Shipped: "shipped",
});

Object.freeze не даёт случайно дописать в список новый вариант. Но опечатку в строке "payed" чистый JavaScript всё равно не поймает — языку не на чем проверять. Это одна из причин, по которой проекты переходят на TypeScript. Подробнее — в сравнении TypeScript и JavaScript.

Почему в TypeScript от enum отказываются

Тут и сидит сюрприз. Почти вся «типовая» часть TypeScript при запуске просто стирается — остаётся чистый JavaScript. А enum стереть нельзя: он превращается в настоящий объект с кодом.

Из-за этого две проблемы.

Первая — странный объект. У числового enum TypeScript делает таблицу в обе стороны: из имени в число и из числа в имя. Попроси список ключей у enum из двух вариантов — получишь четыре: ["0", "1", "Up", "Down"]. Мы проверили это на скомпилированном коде. Цикл по такому «перечислению» пройдётся дважды.

Вторая — не везде запускается. Node.js теперь умеет выполнять TypeScript-файлы напрямую, просто вырезая типы. Но enum он вырезать не может — и отказывается. В TypeScript 5.8 даже появился флаг erasableSyntaxOnly, который запрещает enum заранее, чтобы ты узнал об этом в редакторе, а не при запуске.

Поэтому современный вариант выглядит так:

const Status = {
  New: "new",
  Paid: "paid",
  Shipped: "shipped",
} as const;

type Status = (typeof Status)[keyof typeof Status];
// "new" | "paid" | "shipped"

Это обычный объект, плюс as const, плюс одна строчка, вытаскивающая из него тип. Опечатки ловятся так же. Стирается без остатка. Сама документация TypeScript пишет, что в современном коде enum часто не нужен — хватает объекта с as const.

Если варианты нужны только как типы, ещё проще — список строк через черту:

type Role = "guest" | "member" | "admin";

Когда тебе это пригодится

Ты встретишь перечисления везде, где у поля есть конечный набор значений: статусы, роли, тарифы, категории, размеры. Особенно в коде от ИИ — модели любят раскидывать одни и те же строки по десяти файлам.

Заметил, что "admin" написано в пяти местах? Это кандидат в перечисление. Попроси агента:

Слабый промптСделай роли нормально
Сильный промптРоли пользователя сейчас разбросаны строками по коду ("admin", "member", "guest"). Вынеси их в один объект Role с as const в src/types/role.ts, выведи из него тип, замени все строки на Role.Admin и т.д. Не используй enum. Покажи список изменённых файлов.

Проверить результат легко: поищи по проекту старую строку "admin" в кавычках. Если она осталась только в одном файле — перечисление на месте.

Enum — это то же самое, что массив вариантов?

Похоже, но нет. Массив хранит значения, а enum ещё и даёт тип: редактор знает, что других вариантов не бывает, и подсказывает их по имени. Массив про допустимость ничего не говорит.

Если в проекте уже есть enum — переписывать?

Не обязательно. Если проект собирается обычным компилятором TypeScript, enum работает. Переписывать стоит, когда хочешь запускать код через Node без сборки или когда цикл по enum выдаёт лишние ключи.

Строковый или числовой enum?

Строковый. Его значение видно в логах и базе: "paid" читается, 1 — нет. И у строкового нет таблицы «в обе стороны», так что лишних ключей не появится.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →