JSON

json.encode

Membuat serial nilai Luau ke dalam JSON menggunakan aturan pemformatan dan pengkodean opsional.

Sintaks

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

Argumen

NamaTipeDeskripsi
valueanyNilai baru untuk ditulis.
options?EncodeOptionsTabel pengaturan opsional yang mengontrol perilaku operasi.

Return

NamaTipeDeskripsi
jsonstringHasil string JSON.

Deskripsi

Membuat serial nilai Luau ke dalam JSON menggunakan aturan pemformatan dan pengkodean opsional.

Panggil dengan 2 parameter: value, options. Tabel argumen menjelaskan nilai wajib dan nilai yang hanya menyempurnakan perilaku.

Mengembalikan json (string). Gunakan tabel returns untuk memisahkan nilai sukses, hasil nil, dan error yang bisa dipulihkan.

Contoh

Enkode tabel sebagai JSON yang diformat dengan pengurutan kunci yang stabil.

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

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

print(text)

Tipe

EncodeOptions

Mengontrol serialisasi dan pemformatan JSON.

pretty? boolean Mengaktifkan keluaran JSON multi-baris yang diformat.sortKeys? boolean Mengurutkan kunci objek sebelum pengkodean.emptyTableAsArray? boolean Mengkodekan tabel kosong sebagai array, bukan objek.errorOnUnsupported? boolean Menimbulkan kesalahan alih-alih mengganti nilai yang tidak didukung.encodeInvalidNumbersAsNull? boolean Mengkodekan NaN dan angka tak terbatas sebagai JSON null.maxDepth? integer Menyetel kedalaman sarang maksimum, dijepit dari 1 hingga 4096.indent? string Menyetel string indentasi, dibatasi hingga 32 karakter.