Documentation Real
Docs Guides Troubleshooting Notes de version

JSON

json.encode

Sérialise une valeur Luau en JSON à l'aide de règles de formatage et d'encodage facultatives.

Syntaxe

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

Arguments

NomTypeDescription
valueanyNouvelle valeur à écrire.
options?EncodeOptionsTableau de paramètres facultatifs qui contrôle le comportement de l'opération.

Retours

NomTypeDescription
jsonstringRésultat de la chaîne JSON.

Description

Sérialise une valeur Luau en JSON à l'aide de règles de formatage et d'encodage facultatives.

Appelle le avec 2 parametre(s): value, options. La table des arguments indique les valeurs requises et celles qui affinent le comportement.

Il renvoie json (string). Utilise la table des retours pour separer les valeurs reussies, les resultats nil et les erreurs recuperables.

Exemple

Encodez une table au format JSON avec un ordre de clé stable.

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

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

print(text)

Types

EncodeOptions

Contrôle la sérialisation et le formatage JSON.

pretty? boolean Permet une sortie JSON formatée et multiligne.sortKeys? boolean Trie les clés d'objet avant l'encodage.emptyTableAsArray? boolean Encode une table vide sous forme de tableau au lieu d'un objet.errorOnUnsupported? boolean Génère une erreur au lieu de remplacer des valeurs non prises en charge.encodeInvalidNumbersAsNull? boolean Encode NaN et les nombres infinis en JSON null.maxDepth? integer Définit la profondeur d'imbrication maximale, comprise entre 1 et 4 096.indent? string Définit la chaîne d'indentation, limitée à 32 caractères.