Генератор TypeScript Enum

Перечисления строковых типов присваивают строковые значения каждому элементу, как Color.Red равен строке RED. Числовые перечисления присваивают возрастающие числа, начиная с 0 по умолчанию, поэтому Color.Red равен 0 и Color.Blue равен 1. Строковые перечисления удобнее для отладки, так как значения читаемы в логах и запросах на сети. Числовые перечисления немного компактнее и поддерживают обратное отображение корректно, что позволяет находить имя по числу. Большинство современных проектов на TypeScript предпочитают строковые перечисления для ясности.

Константные перечисления полностью встраиваются на этапе компиляции. Компилятор TypeScript заменяет каждую ссылку на член константного перечисления его литеральным значением, поэтому не существует объекта перечисления во время выполнения. Это приводит к меньшему размеру сборки и быстрее выполнению. Однако константные перечисления нельзя проiterate (нет Object.values), они не поддерживают обратное отображение и могут вызывать проблемы с файлами объявлений в библиотечном коде. Используйте константные перечисления для внутренних констант приложения, где вы хотите нулевой перегрузка во время выполнения. Используйте обычные перечисления, когда вам нужно проiterate значения или при публикации библиотеки.

Объект с `as const` использует простой объект JavaScript вместе с утверждением `const`, чтобы достичь поведения, напоминающего перечисления. Например, `const Color = { Red: 'RED', Blue: 'BLUE' } as const` создаёт неизменяемый объект, где TypeScript инфицирует литеральные типы. Этот подход работает как в TypeScript, так и в JavaScript, лучше поддерживает устранение дублирующегося кода по сравнению с перечислениями и избегает некоторых проблем при транслировании перечислений. Недостатком является немного более объёмное извлечение типов: для получения объединённого типа нужно использовать `type Color = typeof Color[keyof typeof Color]`. Многие команды предпочитают объекты `as const` вместо перечислений по этим практическим причинам.

Гармонизация типа — это функция, сужающая тип значения на уровне выполнения. Для перечислений (enum) гарант типа проверяет, является ли строка или число действительным членом перечисления и сообщает системе типов TypeScript об этом результате. Например, функция `isColor(value: string): value is Color` возвращает `true`, только если значение соответствует члену перечисления. Это полезно при валидации ответов от API, данных форм или любых внешних данных, когда необходимо подтвердить принадлежность значения вашему перечислению перед использованием в коде с гарантией типов.