json.encode - Real Function Reference

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

Argumentos

any

requerido

Value que se encode. nil, booleans, numbers, strings, tables y json.null se manejan directamente. Unsupported Lua types se encode como null salvo que errorOnUnsupported sea true.

EncodeOptions

Optional encode options. Un boolean alterna pretty output. Un number activa pretty output con esa cantidad de spaces clamped a 0.16. Un string activa pretty output con ese indent. Una table puede establecer pretty, sortKeys, emptyTableAsArray, errorOnUnsupported, encodeInvalidNumbersAsNull, maxDepth e indent.

Retornos

string

Encoded JSON string. Encoding errors se lanzan como Luau errors.

Tipos

EncodeOptions

Controla la serialización y el formato JSON.

Name	Type	Required	Descripción
`pretty`	`boolean`	No	Habilita la salida JSON formateada y de varias líneas.
`sortKeys`	`boolean`	No	Ordena las claves de los objetos antes de codificar.
`emptyTableAsArray`	`boolean`	No	Codifica una tabla vacía como una matriz en lugar de un objeto.
`errorOnUnsupported`	`boolean`	No	Genera un error en lugar de sustituir valores no admitidos.
`encodeInvalidNumbersAsNull`	`boolean`	No	Codifica NaN y números infinitos como JSON nulo.
`maxDepth`	`integer`	No	Establece la profundidad máxima de anidamiento, sujeta de 1 a 4096.
`indent`	`string`	No	Establece la cadena de sangría, limitada a 32 caracteres.

Ejemplo

Encode JSON-compatible values usando json.array cuando un empty array debe seguir siendo array.

local payload = {
    name = "Real",
    enabled = true,
    tags = json.array({ "api", "docs" }),
    missing = json.null,
}

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

print(text)

​Argumentos

​Retornos

​Tipos

​EncodeOptions

​Ejemplo

Argumentos

Retornos

Tipos

EncodeOptions

Ejemplo