JSON String Escape

Apa itu JSON String Escaping?

JSON string escaping adalah proses mengonversi karakter khusus di dalam sebuah string menjadi urutan escape yang dapat dibaca oleh JSON parser tanpa merusak struktur dokumen. Spesifikasi JSON (ECMA-404 / RFC 8259) mengharuskan karakter-karakter tertentu di dalam nilai string didahului oleh backslash. Tanpa escaping yang tepat, tanda kutip ganda atau baris baru literal di dalam sebuah string akan mengakhiri string lebih awal dan menghasilkan parse error.

Setiap string JSON dibatasi oleh tanda kutip ganda. Ketika string itu sendiri mengandung tanda kutip ganda, backslash, atau karakter kontrol (U+0000 hingga U+001F), karakter tersebut harus diganti dengan urutan escape-nya. Misalnya, baris baru literal menjadi \n, tab menjadi \t, dan tanda kutip ganda menjadi \". Setiap code point Unicode juga dapat direpresentasikan sebagai \uXXXX, di mana XXXX adalah nilai heksadesimal empat digit.

Unescaping (operasi kebalikannya) mengonversi urutan backslash tersebut kembali menjadi karakter aslinya. Gunakan ini ketika Anda menerima payload JSON di mana nilai string di-escape ganda, atau ketika Anda perlu mengekstrak teks mentah dari entri log JSON untuk ditampilkan di UI atau terminal. Pipeline agregasi log sering menghadapi ini: ketika pesan yang di-encode JSON disimpan sebagai nilai string di dalam dokumen JSON lain, setiap backslash dalam string bagian dalam tiba dengan jumlah ganda.

Mengapa Menggunakan Alat JSON Escape?

Menambah atau menghapus backslash secara manual itu membosankan dan rawan kesalahan, terutama saat menangani teks multi-baris, path file, atau potongan kode yang disematkan. Alat escape khusus menangkap kasus tepi yang terlewatkan saat pengeditan manual.

Kasus Penggunaan JSON String Escape

Referensi Urutan Escape JSON

Spesifikasi JSON mendefinisikan tepat dua escape yang diwajibkan (tanda kutip ganda dan backslash) dan enam urutan escape pendek untuk karakter kontrol umum. Semua karakter kontrol lainnya (U+0000 hingga U+001F) harus menggunakan bentuk \uXXXX. Karakter di atas U+FFFF (seperti emoji) dapat direpresentasikan sebagai pasangan surrogate UTF-16: \uD83D\uDE00.

JSON Escaping vs. JSON Encoding

Developer kadang mencampuradukkan escaping sebuah string dengan encoding dokumen JSON secara keseluruhan.

Contoh Kode

Setiap bahasa pemrograman utama memiliki fungsi bawaan untuk ini. Contoh dalam JavaScript, Python, Go, dan 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"

Pertanyaan yang Sering Diajukan