JSON

json.encode

Serializuje wartość Luau do formatu JSON przy użyciu opcjonalnych reguł formatowania i kodowania.

Składnia

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

Argumenty

NazwaTypOpis
valueanyNowa wartość do zapisania.
options?EncodeOptionsOpcjonalna tabela ustawień, która kontroluje zachowanie operacji.

Zwroty

NazwaTypOpis
jsonstringWynik ciągu JSON.

Opis

Serializuje wartość Luau do formatu JSON przy użyciu opcjonalnych reguł formatowania i kodowania.

Wywolaj z 2 parametrami: value, options. Tabela argumentow wyjasnia wartosci wymagane i te, ktore doprecyzowuja zachowanie.

Zwraca json (string). Uzyj tabeli zwrotow, aby oddzielic wartosci sukcesu, wyniki nil i bledy do obsluzenia.

Przykład

Zakoduj tabelę jako sformatowany JSON ze stabilną kolejnością kluczy.

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

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

print(text)

Typy

EncodeOptions

Kontroluje serializację i formatowanie JSON.

pretty? boolean Włącza sformatowane, wielowierszowe wyjście JSON.sortKeys? boolean Sortuje klucze obiektów przed kodowaniem.emptyTableAsArray? boolean Koduje pustą tabelę jako tablicę zamiast obiektu.errorOnUnsupported? boolean Zgłasza błąd zamiast zastępować nieobsługiwane wartości.encodeInvalidNumbersAsNull? boolean Koduje liczby NaN i nieskończone jako JSON null.maxDepth? integer Ustawia maksymalną głębokość zagnieżdżenia, zaciśniętą w zakresie od 1 do 4096.indent? string Ustawia ciąg wcięcia ograniczony do 32 znaków.