JSON 이스케이프

JSON 이스케이프란?

// Input text
She said "hi"
then left.

// Escaped (Wrap on) — identical to JSON.stringify(input)
"She said \"hi\"\nthen left."

// Escaped (Wrap off) — just the body, for hand-built JSON
She said \"hi\"\nthen left.

// JSON-in-JSON
{"a":1}  ->  "{\"a\":1}"  ->  {"payload": "{\"a\":1}"}

주요 기능

예시

{"event":"signup","user":{"id":42,"name":"Alice"}}

function greet(name) {
  return `Hello, ${name}!`;
}

She said "hello"	then left.

Price: 9.99€ — café société

사용 방법

1. 1

   텍스트나 JSON 붙여넣기

   입력 필드에 무엇이든 입력하거나 붙여넣으세요 — JSON 객체, 코드 조각, 로그 줄, 일반 텍스트. 이스케이프된 결과가 즉시 나타납니다. 'Load example'을 클릭하면 JSON-in-JSON 페이로드나 여러 줄 함수 같은 샘플을 시도할 수 있습니다.

2. 2

   이스케이프 옵션 선택

   완전한 JSON 문자열 리터럴(JSON.stringify와 동일)을 원하면 'Wrap in double quotes'를 켜고, 이스케이프된 본문만 원하면 끄세요. 순수 ASCII \uXXXX 출력을 위해 'Escape non-ASCII'를 토글하고, HTML <script> 태그 안에 JSON을 인라인할 때 'Escape forward slash'를 토글하세요.

3. 3

   이스케이프된 문자열 복사

   Copy를 클릭하면 JSON 문서, REST 요청 본문, 설정 파일에 붙여넣을 수 있는 결과를 가져옵니다. Swap direction을 클릭하면 unescape 모드로 전환되어 손실 없는 왕복을 검증할 수 있습니다.

흔한 이스케이프 함정

Input already escaped: line1\nline2
Escaped again -> line1\\nline2  (literal backslash-n)

Raw input: line1
line2
Escaped once -> line1\nline2  (real newline encoded)

{"msg": hello \"world\"}
// Missing quotes around the value -> invalid JSON

{"msg": "hello \"world\""}
// Wrap on supplies the quotes -> valid JSON

café  ->  caf\u00e9   (no downstream need; just noise)

café  ->  café         (valid JSON, readable, smaller)

일반적인 사용 사례

JSON-in-JSON 웹훅 페이로드

요청 본문을 이스케이프하여 웹훅 봉투, Kafka 메시지, 감사 로그 안의 문자열 필드로 저장할 수 있게 합니다. Wrap을 켜 두면 출력이 바깥 문서의 키에 할당할 준비가 됩니다.

설정 안의 여러 줄 조각

여러 줄 셸 스크립트, SQL 쿼리, 코드 조각을 단일 JSON 문자열 값으로 바꿉니다. 모든 줄바꿈이 \n이 되어 JSON 설정 파일이 한 줄에서 유효하게 유지됩니다.

손으로 만든 REST 요청 본문

JSON 문자열을 이스케이프하여 curl --data 인수나 HTTP 클라이언트에 넣으면, 따옴표와 줄바꿈이 셸과 네트워크를 통과하면서 요청을 깨뜨리지 않습니다.

로그 안전 문자열 인코딩

사용자가 제공한 내용을 구조화된 로그 줄에 기록하기 전에 이스케이프하여, 삽입된 따옴표나 줄바꿈이 로그 형식이나 다운스트림 JSON 로그 파서를 손상시키지 않게 합니다.

ASCII 전용 레거시 통합

전송 중 UTF-8을 망가뜨리는 SOAP 게이트웨이, 이메일 헤더, 오래된 시스템을 위해 순수 ASCII \uXXXX 출력을 만들면서도, 현대 JSON 파서로 완전히 디코딩 가능하게 유지합니다.

HTML 안에 JSON 인라인

슬래시를 이스케이프하여 JSON 덩어리를 서버 렌더링 페이지의 <script> 태그 안에 직접 넣되, 데이터 안의 </script>가 태그를 조기에 닫지 않게 합니다.

기술 세부 사항

이스케이프 알고리즘

이 도구는 JSON 사양의 문자열 규칙으로 입력을 직렬화합니다: U+0022 (") → \", U+005C (\) → \\, U+0008 → \b, U+000C → \f, U+000A → \n, U+000D → \r, U+0009 → \t, 그리고 U+0020 미만의 다른 모든 문자 → \u00XX. Wrap을 켜면 둘러싸는 큰따옴표가 포함되고, 끄면 제거됩니다. 이는 준수 직렬화기의 출력과 정확히 일치하여 손실 없는 왕복을 보장합니다.

유니코드와 Surrogate Pair

기본적으로 U+007F를 초과하는 문자는 JSON이 허용하는 리터럴 UTF-8로 방출됩니다. Escape non-ASCII를 켜면 그런 각 문자가 UTF-16 코드 단위를 사용해 \uXXXX로 변환되고, Basic Multilingual Plane 밖의 문자(이모지, 희귀 문자)는 두 \uXXXX 이스케이프의 surrogate pair로 인코딩됩니다 — 예를 들어 😀 (U+1F600)는 \ud83d\ude00이 되며, 이는 JSON 직렬화기가 생성하는 표현과 같습니다.

슬래시와 HTML 맥락

JSON은 /를 이스케이프할 필요가 없으므로 기본적으로 보존됩니다. Escape forward slash를 켜면 모든 /가 \/가 됩니다. 이렇게 할 유일한 실용적 이유는 HTML 임베딩입니다: <script> 태그 안에서는 리터럴 부분 문자열 </script>가 JSON 맥락과 무관하게 태그를 닫으므로, 슬래시를 <\/script>로 이스케이프하면 인라인된 JSON을 온전하게 유지하면서 사양에 맞게 유효합니다.

모범 사례

완전한 리터럴을 위해 Wrap 켜 두기

코드에서 할당하거나 JSON에서 콜론 뒤에 붙여넣을 값이 필요하면 Wrap in double quotes를 켜 두세요 — 출력은 JSON.stringify와 동일한 완전하고 파싱 가능한 JSON 문자열입니다. 둘러싸는 따옴표를 직접 손으로 입력할 때만 끄세요.

필요하지 않으면 유니코드 이스케이프 끄기

원시 UTF-8은 유효한 JSON이며 훨씬 읽기 쉽습니다. Escape non-ASCII는 UTF-8을 잘못 처리하는 특정 다운스트림 시스템(레거시 SOAP, 일부 로그 파이프라인, ASCII 전용 소스 파일)에만 켜세요. 기본적으로 전부 이스케이프하면 출력이 더 지저분해질 뿐입니다.

HTML 임베딩에만 슬래시 이스케이프

슬래시 이스케이프가 중요한 곳은 정확히 한 군데뿐입니다: HTML <script> 태그 안에 인라인된 JSON. 그 맥락 밖에서는 이점 없이 혼잡함만 더하므로 REST 본문, 설정 파일, 메시지 페이로드에서는 꺼 두세요.

Swap으로 왕복 검증

이스케이프된 데이터를 파이프라인에 보내기 전에 Swap direction을 클릭하여 unescape하고 원래 텍스트를 돌려받는지 확인하세요. 이는 우발적 이중 이스케이프 — \n을 의도한 곳에 \\n이 나타나는 흔한 원인 — 를 잡아냅니다. JSON Unescape 도구로 언제든 되돌리세요.

자주 묻는 질문