JSON

json.format

Analysiert und kodiert JSON neu, um die Formatierung zu normalisieren.

Syntax

json.format(json: string, encodeOptions?: EncodeOptions, decodeOptions?: DecodeOptions): string

Argumente

NameTypBeschreibung
jsonstringJSON-Zeichenfolge zum Parsen, Formatieren, Minimieren oder Validieren.
encodeOptions?EncodeOptionsOptionale Kodierungseinstellungen wie hübsche Ausgabe oder Schlüsselreihenfolge.
decodeOptions?DecodeOptionsOptionale Parsing-Einstellungen, die beim Lesen von JSON verwendet werden.

Rückgaben

NameTypBeschreibung
formattedstringFormatierte JSON-Zeichenfolge.

Beschreibung

Analysiert und kodiert JSON neu, um die Formatierung zu normalisieren.

Rufe es mit 3 Parameter(n) auf: json, encodeOptions, decodeOptions. Die Argumenttabelle erklärt, welche Werte erforderlich sind und welche nur das Verhalten verfeinern.

Es gibt formatted (string) zurück. Nutze die Rückgabetabelle, um erfolgreiche Werte von nil-Ergebnissen und behandelbaren Fehlern zu trennen.

Beispiel

Normalisieren Sie vorhandenes JSON in eine lesbare Darstellung.

local compact = '{"b":2,"a":1}'
local formatted = json.format(compact, {
    pretty = true,
    sortKeys = true,
})

print(formatted)

Typen

EncodeOptions

Steuert die JSON-Serialisierung und -Formatierung.

pretty? boolean Ermöglicht eine formatierte, mehrzeilige JSON-Ausgabe.sortKeys? boolean Sortiert Objektschlüssel vor der Codierung.emptyTableAsArray? boolean Kodiert eine leere Tabelle als Array statt als Objekt.errorOnUnsupported? boolean Löst einen Fehler aus, anstatt nicht unterstützte Werte zu ersetzen.encodeInvalidNumbersAsNull? boolean Kodiert NaN und unendliche Zahlen als JSON-Null.maxDepth? integer Legt die maximale Verschachtelungstiefe fest, geklemmt von 1 bis 4096.indent? string Legt die Einrückungszeichenfolge fest, begrenzt auf 32 Zeichen.

DecodeOptions

Steuert das JSON-Parsing-Verhalten.

useNull? boolean Stellt JSON Null mit dem Null-Sentinel der Bibliothek anstelle von Null dar.maxDepth? integer Legt die maximale Verschachtelungstiefe fest, geklemmt von 1 bis 4096.