Паттерн перечислений (Enum) в Luau

Программы часто работают со значениями из небольшого фиксированного набора: заказ ожидает обработки, отправлен или доставлен; игрок смотрит вверх, вниз, влево или вправо. Во многих языках для этого есть ключевое слово enum. В Luau его нет, и оно не нужно, потому что эту задачу решают два уже знакомых тебе инструмента.

Шаблон 1: таблица констант. Обычная таблица сопоставляет осмысленные имена со значениями, заменяя «магические числа», разбросанные по коду:

local Status = {
    Pending = 1,
    Active = 2,
    Done = 3,
}

print(Status.Active) -- 2

Это настоящее значение во время выполнения: ты можешь прочитать Status.Active, сравнить с ним и передавать его дальше — точно так же, как и таблицы, с которыми ты работал до сих пор.

Шаблон 2: объединение литеральных типов. Тип, состоящий из точных строковых значений, с использованием литеральных типов, которые ты изучил в главе об объединениях:

type Color = "red" | "green" | "blue"
local favorite: Color = "green" -- ✓
local oops: Color = "yellow"    -- ✗ ошибка типа

Объединение существует только для проверки типов и не требует ресурсов во время выполнения, но гарантирует, что переменная не сможет содержать значения за пределами набора. Эти два шаблона дополняют друг друга: таблица предоставляет тебе значения во время выполнения под одним именем, а объединение даёт гарантию на этапе компиляции. Позже в этой главе ты также познакомишься с table.freeze, которое защищает таблицу констант от изменений во время выполнения.