TypeScript Enums

TLDR: Используйте обычные объекты + as const / satisfies, забудьте про enum.

Енамы - один из немногих активно используемых атавизмов, оставшихся от экспериментов TS над расширением языка и одна из немногих его НЕ type-level фичей.
Область применения понятна - именованная группа констант-токенов, что же с ними не так и что делать?

Не нативная конструкция

TS давно изменил свою стратегию на "Мы не расширяем язык", enum (как и `namespace/experimentalDecorators`) - древний реликт вне современного TS.

Контринтуитивный результат

В рантайме мы получаем специфичный отзеркаленный объект, из которого банально нельзя понять, что ключ, а что значение.
Mind blowing решение, удачи с Object.keys/values.

const enum просто не работают

Казалось бы, красивое решение - в рантайме инлайним значение и enum испарился, но, помимо того, что это не работает нигде, кроме tsc, у const enum есть целый спектр фундаментальных дыр (`isolatedModules`, type import, импорт из библиотек), что подробно описано в хендбуке самого TS: https://www.typescriptlang.org/docs/handbook/enums.html#const-enum-pitfalls.
Это мертворожденная фича.

enum - номинальная типизация, а ВЕСЬ TS - структурная

TS построен на структурной типизации с понятными бенефитами, но enum, просто берет и работает по-другому!
Значения разных енамов не равны ни друг другу, ни литералам, ничему, кроме себя самих (да, изредка мы хотим такое поведение, но, блин, не в енамах).
Это накладывает окраску кода, хардкод, приведение типов и прочие приседания ради классического "шоб TS не ругался".

Обычные объекты + as const

Всё, что дают енамы, можно выразить через обычные объекты + as const / satisfies!
Всё (в 100 раз больше) 🥹
Можно не создавать лишнюю прослойку c токенами, а сразу писать конфиг.
Можно прозрачно работать как с ключами, так и со значениями.

Можно использовать все возможности TS и почти ничего не терять.
Не теряйте :)

P.S. Ложка мёда: благодаря номинальному дизайну енамов нам легко искать места использования 😏

#typescript