NATIVE

settings_applicationsObject  >   settings_applicationsJSON

NATIVE

Editing
  • account_tree
  • bug_report

stringJSONStringstringify(Objectvalue, Functionreplacer | Arrayreplacer, string, Numberspace]])

자바스크립트 값이나 객체를 JSON 문자열로 변환한다.

설명

선택적으로 replacer를 함수로 전달할 경우 변환 전 값을 변형할 수 있고, 배열로 전달할 경우 지정한 속성만 결과에 포함한다

구문

형식
JSON.stringify(value[, replacer[, space]])

매개 변수

Objectvalue필수

JSON 문자열로 변환할 값을 지정한다.

Functionreplacer선택

문자열로 변경할 때 변형이 필요한 경우에 적용하는 함수를 지정할 수 있다. 만약이 null을 지정하거나 생략한 경우에는 객체의 모든 속성들이 JSON 문자열로 변환된다.

또는 다른 타입
Arrayreplacer선택

JSON 문자열에 포함될 속성들을 선택하기 위한 화이트리스트(Whitelist)로 쓰이는 String과 Number 객체들의 배열을 지정할 수 있다. 만약이 null을 지정하거나 생략한 경우에는 객체의 모든 속성들이 JSON 문자열로 변환된다.

string, Numberspace선택

가독성을 목적으로 JSON 문자열 출력에 공백을 삽입하는 데 사용되는 문자열 또는 숫자이다. 숫자로 지정한 경우 공백으로 사용되는 스페이스(Space)의 수를 나타내며 10이 최대 값이다. 문자열로 지정한 경우 지정된 문자열이 공백으로 사용되며 글자수는 10개를 넘을 수 없고 10개를 넘는 경우 10번째까지의 문자열로 처리한다. 이 매개변수가 생략되거나 null 이라면 공백이 사용되지 않는다.

반환

stringJSONString

JSON 문자열을 반환한다.

다음의 경우 TypeError 예외가 발생한다.

  • 값에 순환 참조가 포함되었다.
  • BigInt 값이 존재한다.

Exception

TypeError

동적 타입의 값이 흐름상 맞지 않는 자료형이라 연산을 할 수 없을 때 발생하는 오류를 다루는 객체이다.

예제

(1) replacer가 사용된 경우
(2) replacer와 space가 사용된 경우

버전 명세

ECMAScript 2024(15th Edition)
#sec-json.stringify

지원 웹브라우저