JSON

json.encode

선택적 형식 지정 및 인코딩 규칙을 사용하여 Luau 값을 JSON으로 직렬화합니다.

문법

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

인수

이름타입설명
valueany쓸 새로운 가치.
options?EncodeOptions작업 작동 방식을 제어하는 선택적 설정 테이블입니다.

반환값

이름타입설명
jsonstringJSON 문자열 결과.

설명

선택적 형식 지정 및 인코딩 규칙을 사용하여 Luau 값을 JSON으로 직렬화합니다.

2개 파라미터로 호출합니다: value, options. 인수 표는 필수 값과 동작을 조정하는 값을 설명합니다.

json (string)을 반환합니다. 반환 표를 사용해 성공 값, nil 결과, 복구 가능한 오류를 구분하세요.

예제

안정적인 키 순서를 사용하여 테이블을 형식화된 JSON으로 인코딩합니다.

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

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

print(text)

타입

EncodeOptions

JSON 직렬화 및 형식화를 제어합니다.

pretty? boolean 형식이 지정된 여러 줄 JSON 출력을 활성화합니다.sortKeys? boolean 인코딩하기 전에 객체 키를 정렬합니다.emptyTableAsArray? boolean 빈 테이블을 개체 대신 배열로 인코딩합니다.errorOnUnsupported? boolean 지원되지 않는 값을 대체하는 대신 오류가 발생합니다.encodeInvalidNumbersAsNull? boolean NaN 및 무한 숫자를 JSON null로 인코딩합니다.maxDepth? integer 1부터 4096까지 고정된 최대 중첩 깊이를 설정합니다.indent? string 32자로 제한되는 들여쓰기 문자열을 설정합니다.