JSON Dize Kaçış Aracı

JSON Dize Kaçışı Nedir?

JSON dize kaçışı, bir dize içindeki özel karakterleri JSON ayrıştırıcılarının yapıyı bozmadan okuyabileceği kaçış dizilerine dönüştürme işlemidir. JSON belirtimi (ECMA-404 / RFC 8259), dize değerleri içindeki belirli karakterlerin önüne ters eğik çizgi konulmasını zorunlu kılar. Doğru kaçış uygulanmadığında, dize içindeki gerçek bir çift tırnak veya satır sonu karakteri dizeyi erken sonlandırır ve ayrıştırma hatasına yol açar.

Her JSON dizesi çift tırnakla sınırlandırılır. Dizenin kendisi bir çift tırnak, ters eğik çizgi veya kontrol karakteri (U+0000 ile U+001F arası) içerdiğinde, bu karakterin kaçış dizisiyle değiştirilmesi gerekir. Örneğin gerçek bir satır sonu \n, sekme karakteri \t ve çift tırnak \" olur. Herhangi bir Unicode kod noktası, XXXX'in dört basamaklı onaltılık değer olduğu \uXXXX biçimiyle de temsil edilebilir.

Geri çözme (ters işlem), bu ters eğik çizgi dizilerini özgün karakterlere dönüştürür. Dize değerlerinin çift kaçışlı olduğu bir JSON yükü aldığınızda ya da bir JSON günlük girdisinden ham metni kullanıcı arayüzünde veya terminalde göstermek için çıkarmanız gerektiğinde kullanın. Günlük toplama hatları bu sorunla sürekli karşılaşır: JSON ile kodlanmış bir ileti başka bir JSON belgesinde dize değeri olarak saklandığında, iç dizedeki her ters eğik çizgi çift gelir.

Neden JSON Kaçış Aracı Kullanmalısınız?

Ters eğik çizgileri elle eklemek veya kaldırmak sıkıcı ve hata yapmaya açıktır; özellikle çok satırlı metinler, dosya yolları veya gömülü kod parçacıklarıyla çalışırken. Özel bir kaçış aracı, elle düzenlemenin gözden kaçırdığı uç durumları yakalar.

JSON Dize Kaçışı Kullanım Senaryoları

JSON Kaçış Dizisi Başvurusu

JSON belirtimi tam olarak iki zorunlu kaçış (çift tırnak ve ters eğik çizgi) ve yaygın kontrol karakterleri için altı kısa kaçış dizisi tanımlar. Diğer tüm kontrol karakterleri (U+0000 ile U+001F arası) \uXXXX biçimini kullanmak zorundadır. U+FFFF'nin üzerindeki karakterler (emoji gibi) UTF-16 vekil çifti olarak temsil edilebilir: \uD83D\uDE00.

JSON Kaçışı ile JSON Kodlaması Karşılaştırması

Geliştiriciler bazen bir dizeyi kaçırmayı tam JSON belgesini kodlamayla karıştırır.

Kod Örnekleri

Her büyük dilde bunun için yerleşik işlevler vardır. JavaScript, Python, Go ve jq örnekleri:

// 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"

Sıkça Sorulan Sorular