Escape สตริง JSON

JSON String Escaping คืออะไร?

JSON string escaping คือกระบวนการแปลงอักขระพิเศษภายในสตริงให้เป็น escape sequence ที่ JSON parser สามารถอ่านได้โดยไม่ทำให้โครงสร้างเสียหาย ข้อกำหนด JSON (ECMA-404 / RFC 8259) กำหนดให้อักขระบางตัวภายใน string value ต้องนำหน้าด้วย backslash หากไม่ escape อย่างถูกต้อง เครื่องหมายคำพูดคู่หรือขึ้นบรรทัดใหม่ที่อยู่ในสตริงจะทำให้สตริงจบก่อนกำหนดและเกิด parse error

JSON string ทุกตัวถูกกำหนดขอบเขตด้วยเครื่องหมายคำพูดคู่ เมื่อสตริงมีเครื่องหมายคำพูดคู่ backslash หรืออักขระควบคุม (U+0000 ถึง U+001F) อักขระนั้นต้องถูกแทนที่ด้วย escape sequence ตัวอย่างเช่น ขึ้นบรรทัดใหม่กลายเป็น \n, tab กลายเป็น \t และเครื่องหมายคำพูดคู่กลายเป็น \" นอกจากนี้ยังสามารถแทน Unicode code point ใดๆ ด้วย \uXXXX โดย XXXX คือค่าเลขฐานสิบหกสี่หลัก

Unescaping (การดำเนินการย้อนกลับ) แปลง backslash sequence กลับเป็นอักขระดั้งเดิม ใช้เมื่อได้รับ JSON payload ที่ string value ถูก escape ซ้อนกัน หรือเมื่อต้องการดึงข้อความดิบจาก JSON log entry เพื่อแสดงใน UI หรือ terminal pipeline การรวมรวมข้อมูล log พบปัญหานี้บ่อยครั้ง: เมื่อข้อความที่เข้ารหัส JSON ถูกเก็บเป็น string value ภายใน JSON document อีกชั้น backslash ทุกตัวในสตริงชั้นในจะถูก escape ซ้ำ

ทำไมต้องใช้เครื่องมือ JSON Escape?

การเพิ่มหรือลบ backslash ด้วยมือเป็นงานที่น่าเบื่อและเกิดข้อผิดพลาดได้ง่าย โดยเฉพาะเมื่อจัดการกับข้อความหลายบรรทัด path ของไฟล์ หรือ code snippet ที่ฝังอยู่ เครื่องมือ escape เฉพาะทางจัดการ edge case ที่การแก้ไขด้วยมือมักพลาด

กรณีการใช้งาน JSON String Escape

ตารางอ้างอิง JSON Escape Sequence

ข้อกำหนด JSON กำหนด escape บังคับ 2 ตัวได้แก่เครื่องหมายคำพูดคู่และ backslash และ escape sequence สั้นๆ 6 ตัวสำหรับอักขระควบคุมที่ใช้บ่อย อักขระควบคุมอื่นๆ (U+0000 ถึง U+001F) ต้องใช้รูปแบบ \uXXXX อักขระที่สูงกว่า U+FFFF (เช่นอีโมจิ) สามารถแทนได้ด้วย UTF-16 surrogate pair: \uD83D\uDE00

JSON Escaping เทียบกับ JSON Encoding

นักพัฒนามักสับสนระหว่างการ escape สตริงกับการ encode JSON document ทั้งฉบับ

ตัวอย่างโค้ด

ภาษาหลักทุกภาษามีฟังก์ชันในตัวสำหรับงานนี้ ตัวอย่างใน JavaScript, Python, Go และ jq:

// JSON.stringify escapes a value and wraps it in quotes
JSON.stringify('Line 1\nLine 2')       // → '"Line 1\\nLine 2"'

// To get just the inner escaped string (no surrounding quotes):
const escaped = JSON.stringify('She said "hello"').slice(1, -1)
// → 'She said \\"hello\\"'

// Parsing reverses the escaping
JSON.parse('"tabs\\tand\\nnewlines"')  // → 'tabs\tand\nnewlines'

// Handling Unicode: emoji in JSON
JSON.stringify('Price: 5\u20ac')       // → '"Price: 5\u20ac"' (raw euro sign)

import json

# json.dumps escapes and quotes a string
json.dumps('Line 1\nLine 2')           # → '"Line 1\\nLine 2"'

# Ensure ASCII: replace non-ASCII with \uXXXX sequences
json.dumps('Caf\u00e9', ensure_ascii=True)   # → '"Caf\\u00e9"'

# Keep UTF-8 characters as-is (default in Python 3)
json.dumps('Caf\u00e9', ensure_ascii=False)  # → '"Caf\u00e9"'

# Unescape by round-tripping through json.loads
json.loads('"She said \\"hello\\""')      # → 'She said "hello"'

package main

import (
	"encoding/json"
	"fmt"
)

func main() {
	// json.Marshal escapes a Go string for JSON
	raw := "Line 1\nLine 2\tindented"
	b, _ := json.Marshal(raw)
	fmt.Println(string(b))
	// → "Line 1\nLine 2\tindented"

	// Unescape with json.Unmarshal
	var out string
	json.Unmarshal([]byte(`"She said \"hello\""`), &out)
	fmt.Println(out)
	// → She said "hello"
}

# Escape a raw string into a JSON-safe value
echo 'Line 1
Line 2	with tab' | jq -Rs '.'
# → "Line 1\nLine 2\twith tab\n"

# Unescape a JSON string back to raw text
echo '"She said \"hello\""' | jq -r '.'
# → She said "hello"

คำถามที่พบบ่อย