JSON

json.encode

Сериализует значение Luau в JSON, используя дополнительные правила форматирования и кодирования.

Синтаксис

json.encode(value: any, options?: EncodeOptions): string

Аргументы

ИмяТипОписание
valueanyНовое значение для записи.
options?EncodeOptionsДополнительная таблица настроек, которая управляет поведением операции.

Возвраты

ИмяТипОписание
jsonstringРезультат строки JSON.

Описание

Сериализует значение Luau в JSON, используя дополнительные правила форматирования и кодирования.

Вызывай с 2 параметрами: value, options. Таблица аргументов показывает обязательные значения и настройки поведения.

Возвращает json (string). Используй таблицу возвращаемых значений, чтобы отличать успех, nil и обрабатываемые ошибки.

Пример

Закодируйте таблицу в формате JSON со стабильным порядком ключей.

local payload = {
    name = "Real",
    enabled = true,
    tags = { "api", "docs" },
}

local text = json.encode(payload, {
    pretty = true,
    sortKeys = true,
})

print(text)

Типы

EncodeOptions

Управляет сериализацией и форматированием JSON.

pretty? boolean Включает форматированный многострочный вывод JSON.sortKeys? boolean Сортирует ключи объекта перед кодированием.emptyTableAsArray? boolean Кодирует пустую таблицу как массив вместо объекта.errorOnUnsupported? boolean Вызывает ошибку вместо замены неподдерживаемых значений.encodeInvalidNumbersAsNull? boolean Кодирует NaN и бесконечные числа как значение JSON null.maxDepth? integer Устанавливает максимальную глубину вложенности от 1 до 4096.indent? string Устанавливает строку отступа, ограниченную 32 символами.