JSON Kaçış

JSON Kaçışı Nedir?

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

Temel Özellikler

Örnekler

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

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

She said "hello"	then left.

Price: 9.99€ — café société

Nasıl Kullanılır

1. 1

   Metninizi veya JSON'unuzu yapıştırın

   Girdi alanına herhangi bir şey girin veya yapıştırın — bir JSON nesnesi, bir kod parçacığı, bir günlük satırı veya düz metin. Kaçırılmış sonuç anında belirir. Bir JSON-in-JSON yükü veya çok satırlı bir işlev gibi bir örnek denemek için 'Örnek yükle'ye tıklayın.

2. 2

   Kaçış seçeneklerini belirleyin

   Tam bir JSON dizesi değişmezi için 'Çift tırnaklara sarmala'yı açık tutun (JSON.stringify ile aynı) veya yalnızca kaçırılmış gövdeyi almak için kapatın. Saf ASCII \uXXXX çıktısı için 'ASCII olmayanı kaçır'ı ve JSON'u bir HTML <script> etiketine satır içi yerleştirirken 'Eğik çizgiyi kaçır'ı açın.

3. 3

   Kaçırılmış dizeyi kopyalayın

   Sonucu almak için Kopyala'ya tıklayın; bir JSON belgesine, REST istek gövdesine veya yapılandırma dosyasına yapıştırmaya hazırdır. Kaçış çözme moduna geçmek ve kayıpsız bir gidiş-dönüşü doğrulamak için Yön değiştir'e tıklayın.

Yaygın Kaçış Tuzakları

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)

Yaygın Kullanım Senaryoları

JSON-in-JSON Webhook Yükleri

Bir istek gövdesini kaçırın ki bir webhook zarfının, Kafka mesajının veya denetim günlüğünün içinde dize alanı olarak saklanabilsin. Sarmala'yı açık tutun ve çıktı dış belgedeki bir anahtara atanmaya hazırdır.

Yapılandırmada Çok Satırlı Parçacıklar

Çok satırlı bir kabuk betiğini, SQL sorgusunu veya kod parçacığını tek bir JSON dize değerine dönüştürün. Her satır sonu \n olur, böylece JSON yapılandırma dosyası tek satırda geçerli kalır.

Elle Oluşturulan REST İstek Gövdeleri

Bir JSON dizesini bir curl --data argümanına veya bir HTTP istemcisine bırakmadan önce kaçırın, böylece tırnaklar ve satır sonları isteği bozmadan kabuktan ve hattan sağ çıkar.

Günlük-Güvenli Dize Kodlaması

Kullanıcı tarafından sağlanan içeriği, yapılandırılmış bir günlük satırına yazmadan önce kaçırın; enjekte edilmiş tırnakların veya satır sonlarının günlük biçimini veya aşağı akıştaki bir JSON günlük ayrıştırıcısını bozmasını önleyin.

Yalnızca ASCII Eski Sistem Entegrasyonları

SOAP ağ geçitleri, e-posta başlıkları veya aktarımda UTF-8'i bozan eski sistemler için saf ASCII \uXXXX çıktısı üretin; bu arada herhangi bir modern JSON ayrıştırıcısı tarafından tamamen çözülebilir kalın.

JSON'u HTML İçine Satır İçi Yerleştirme

Eğik çizgileri kaçırarak bir JSON bloğunun, sunucu tarafından işlenen sayfalar için doğrudan bir <script> etiketinin içine, veri içindeki </script> etiketi erkenden kapatmadan gömülmesini sağlayın.

Teknik Ayrıntılar

Kaçış Algoritması

Araç, girdinizi JSON belirtiminin dize kurallarıyla dizileştirir: U+0022 (") → \", U+005C (\) → \\, U+0008 → \b, U+000C → \f, U+000A → \n, U+000D → \r, U+0009 → \t ve U+0020 altındaki diğer her karakter → \u00XX. Sarmala açıkken çevreleyen çift tırnaklar dahil edilir; kapalıyken çıkarılır. Bu, uyumlu bir dizileştiricinin çıktısıyla tam olarak eşleşir ve kayıpsız gidiş-dönüşleri garanti eder.

Unicode ve Vekil Çiftleri

Varsayılan olarak U+007F üzerindeki karakterler JSON'un izin verdiği gibi düz UTF-8 olarak yayılır. ASCII olmayanı kaçır açıkken, böyle her karakter UTF-16 kod birimi kullanılarak \uXXXX'e dönüştürülür; Temel Çok Dilli Düzlem dışındaki karakterler (emoji, nadir betikler) iki \uXXXX kaçışından oluşan bir vekil çifti olarak kodlanır — örneğin 😀 (U+1F600), bir JSON dizileştiricisinin ürettiği aynı gösterim olan \ud83d\ude00 olur.

Eğik Çizgi ve HTML Bağlamı

JSON'un / kaçırılmasını gerektirmemesi nedeniyle varsayılan olarak korunur. Eğik çizgiyi kaçır etkinleştirildiğinde her / \/ olur. Bunu yapmanın tek pratik nedeni HTML gömmedir: bir <script> etiketinin içinde, </script> düz alt dizesi JSON bağlamından bağımsız olarak etiketi kapatır, bu yüzden eğik çizgiyi <\/script> olarak kaçırmak, satır içi JSON'u belirtime uygun kalırken bütün tutar.

En İyi Uygulamalar

Tam Değişmezler için Sarmala'yı Açık Tutun

Kodda atayacağınız veya JSON'da bir iki nokta üst üstenin ardına yapıştıracağınız bir değere ihtiyacınız olduğunda Çift tırnaklara sarmala'yı açık tutun — çıktı, JSON.stringify ile aynı, tam ve ayrıştırılabilir bir JSON dizesidir. Yalnızca çevreleyen tırnakları kendiniz elle yazdığınızda kapatın.

Gerekmedikçe Unicode Kaçışını Kapalı Bırakın

Ham UTF-8 geçerli JSON'dur ve çok daha okunabilirdir. ASCII olmayanı kaçır'ı yalnızca UTF-8'i yanlış işleyen belirli bir aşağı akış sistemi için açın (eski SOAP, bazı günlük boru hatları, yalnızca ASCII kaynak dosyaları). Varsayılan olarak her şeyi kaçırmak yalnızca çıktıyı gürültülü kılar.

Eğik Çizgileri Yalnızca HTML Gömmek için Kaçırın

Eğik çizgi kaçışı tam olarak tek bir yerde önemlidir: bir HTML <script> etiketine satır içi yerleştirilmiş JSON. Bu bağlamın dışında hiçbir fayda sağlamadan karmaşa ekler, bu yüzden REST gövdeleri, yapılandırma dosyaları ve mesaj yükleri için kapalı bırakın.

Yön Değiştir ile Gidiş-Dönüşleri Doğrulayın

Kaçırılmış veriyi bir boru hattına göndermeden önce, kaçışını çözmek ve orijinal metni geri aldığınızı doğrulamak için Yön değiştir'e tıklayın. Bu, kazara çift kaçışı yakalar — \n'in amaçlandığı yerde \\n görünmesinin sık bir kaynağı. Dilediğiniz zaman JSON Kaçış Çözme aracımızla tersine çevirin.

Sıkça Sorulan Sorular