ترميز سلاسل JSON

ما هو ترميز سلاسل JSON؟

ترميز سلاسل JSON هو عملية تحويل الأحرف الخاصة داخل السلسلة النصية إلى تسلسلات ترميز يستطيع محلل JSON قراءتها دون كسر البنية. تشترط مواصفات JSON (ECMA-404 / RFC 8259) أن تسبق بعض الأحرف داخل قيم السلاسل شرطةٌ مائلة عكسية. وبدون الترميز الصحيح، فإن علامة اقتباس مزدوجة حرفية أو سطراً جديداً داخل سلسلة سيُنهي السلسلة مبكراً ويُنتج خطأ في التحليل.

كل سلسلة JSON تُحدَّد بعلامات اقتباس مزدوجة. حين تحتوي السلسلة ذاتها على علامة اقتباس مزدوجة أو شرطة مائلة عكسية أو حرف تحكم (من U+0000 إلى U+001F)، يجب استبدال الحرف بتسلسل الترميز المقابل. على سبيل المثال، يصبح السطر الجديد الحرفي \n، والجدولة \t، وعلامة الاقتباس المزدوجة \". كما يمكن تمثيل أي نقطة ترميز Unicode بالصيغة \uXXXX، حيث XXXX هي القيمة الست عشرية المكونة من أربعة أرقام.

فك الترميز (العملية العكسية) يحول تسلسلات الشرطة المائلة العكسية تلك إلى أحرافها الأصلية. استخدمه حين تتلقى حمولة JSON تحتوي فيها قيم السلاسل على ترميز مضاعف، أو حين تحتاج إلى استخراج نص خام من إدخال سجل JSON لعرضه في واجهة مستخدم أو طرفية. تصطدم بخطوط أنابيب تجميع السجلات بهذا الأمر باستمرار: حين تُخزَّن رسالة مشفرة بـ JSON كقيمة سلسلة داخل مستند JSON آخر، تصل كل شرطة مائلة عكسية في السلسلة الداخلية مضاعفة.

لماذا استخدام أداة ترميز JSON؟

إضافة الشرطات المائلة العكسية أو إزالتها يدوياً أمر مرهق وعرضة للأخطاء، خاصة عند التعامل مع نصوص متعددة الأسطر أو مسارات الملفات أو مقتطفات الكود المضمنة. تُعالج الأداة المتخصصة الحالات الطرفية التي يُفوّتها التحرير اليدوي.

حالات استخدام ترميز سلاسل JSON

مرجع تسلسلات ترميز JSON

تُحدد مواصفات JSON بالضبط تسلسلَي ترميز إلزاميَّين (علامة الاقتباس المزدوجة والشرطة المائلة العكسية) وستة تسلسلات قصيرة لأحرف التحكم الشائعة. يجب استخدام الصيغة \uXXXX لجميع أحرف التحكم الأخرى (من U+0000 إلى U+001F). أما الأحرف فوق U+FFFF (كالرموز التعبيرية) فيمكن تمثيلها كزوج بديل UTF-16: \uD83D\uDE00.

ترميز JSON مقابل تشفير JSON

يخلط المطورون أحياناً بين ترميز سلسلة ما وتشفير مستند JSON كامل.

أمثلة برمجية

لكل لغة رئيسية دوال مدمجة لهذا الغرض. أمثلة بـ 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"

الأسئلة الشائعة