JSON

json.encode

จัดลำดับค่า Luau ให้เป็น JSON โดยใช้กฎการจัดรูปแบบและการเข้ารหัสที่ไม่บังคับ

ไวยากรณ์

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

Arguments

ชื่อชนิดคำอธิบาย
valueanyค่าใหม่ในการเขียน
options?EncodeOptionsตารางการตั้งค่าเสริมที่ควบคุมลักษณะการทำงาน

Returns

ชื่อชนิดคำอธิบาย
jsonstringผลลัพธ์สตริง JSON

คำอธิบาย

จัดลำดับค่า Luau ให้เป็น JSON โดยใช้กฎการจัดรูปแบบและการเข้ารหัสที่ไม่บังคับ

เรียกด้วย parameter 2 ค่า: value, options ตาราง arguments อธิบายค่าที่จำเป็นและค่าที่ปรับพฤติกรรม

ส่งคืน json (string) ใช้ตาราง returns เพื่อแยกค่าที่สำเร็จ ผลลัพธ์ nil และ error ที่จัดการต่อได้

ตัวอย่าง

เข้ารหัสตารางในรูปแบบ JSON พร้อมการเรียงลำดับคีย์ที่เสถียร

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

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

print(text)

Types

EncodeOptions

ควบคุมการทำให้เป็นอนุกรมและการจัดรูปแบบ JSON

pretty? boolean เปิดใช้งานเอาต์พุต JSON แบบหลายบรรทัดที่จัดรูปแบบแล้วsortKeys? boolean เรียงลำดับออบเจ็กต์คีย์ก่อนการเข้ารหัสemptyTableAsArray? boolean เข้ารหัสตารางว่างเป็นอาร์เรย์แทนที่จะเป็นวัตถุerrorOnUnsupported? boolean ทำให้เกิดข้อผิดพลาดแทนที่จะแทนที่ค่าที่ไม่รองรับencodeInvalidNumbersAsNull? boolean เข้ารหัส NaN และจำนวนอนันต์เป็น JSON nullmaxDepth? integer ตั้งค่าความลึกของการซ้อนสูงสุด โดยยึดไว้ตั้งแต่ 1 ถึง 4096indent? string ตั้งค่าสตริงการเยื้อง โดยจำกัดไว้ที่ 32 อักขระ