تهريب JSON

ما هو تهريب JSON؟

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

الميزات الرئيسية

أمثلة

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

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

She said "hello"	then left.

Price: 9.99€ — café société

كيفية الاستخدام

1. 1

   الصق نصك أو JSON

   أدخل أو الصق أي شيء في حقل الإدخال — كائن JSON أو مقتطف كود أو سطر سجل أو نصًا عاديًا. تظهر النتيجة المُهرَّبة فورًا. انقر «تحميل مثال» لتجربة عيّنة مثل حمولة JSON داخل JSON أو دالة متعددة الأسطر.

2. 2

   اختر خيارات التهريب

   أبقِ «التغليف بعلامتي اقتباس مزدوجتين» مفعّلًا لسلسلة JSON نصية كاملة (مثل JSON.stringify)، أو عطّله للحصول على الجسم المُهرَّب فقط. فعّل «تهريب ما هو خارج ASCII» لخرج \uXXXX بـ ASCII صرف، و«تهريب الشرطة المائلة الأمامية» عند تضمين JSON داخل وسم <script> في HTML.

3. 3

   انسخ السلسلة المُهرَّبة

   انقر نسخ لالتقاط النتيجة، جاهزة للصق داخل مستند JSON أو جسم طلب REST أو ملف إعدادات. انقر تبديل الاتجاه للقلب إلى وضع فكّ التهريب والتحقق من دورة ذهاب وإياب بلا خسارة.

مزالق تهريب شائعة

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)

حالات استخدام شائعة

حمولات webhook بصيغة JSON داخل JSON

هرّب جسم طلب ليُخزَّن كحقل نصي داخل غلاف webhook أو رسالة Kafka أو سجل تدقيق. أبقِ التغليف مفعّلًا ويصبح الخرج جاهزًا للإسناد إلى مفتاح في المستند الخارجي.

مقتطفات متعددة الأسطر في الإعدادات

حوّل سكربت shell متعدد الأسطر أو استعلام SQL أو مقتطف كود إلى قيمة سلسلة JSON واحدة. يصبح كل سطر جديد \n فيبقى ملف إعدادات JSON صالحًا في سطر واحد.

أجسام طلبات REST مبنية يدويًا

هرّب سلسلة JSON قبل إسقاطها في وسيط curl --data أو عميل HTTP، لتنجو علامات الاقتباس والأسطر الجديدة من الصدفة والسلك دون كسر الطلب.

ترميز سلاسل آمن للسجلات

هرّب المحتوى المُقدَّم من المستخدم قبل كتابته في سطر سجل مُنظَّم، فتمنع علامات الاقتباس أو الأسطر الجديدة المحقونة من إفساد صيغة السجل أو محلل سجل JSON لاحق.

تكاملات قديمة بـ ASCII فقط

أنتج خرج \uXXXX بـ ASCII صرف لبوابات SOAP أو ترويسات البريد أو الأنظمة الأقدم التي تُفسد UTF-8 أثناء النقل، مع بقائه قابلًا للفكّ كاملًا بأي محلل JSON حديث.

تضمين JSON داخل HTML

هرّب الشرطات المائلة الأمامية ليُضمَّن كائن JSON مباشرة داخل وسم <script> للصفحات المُصيَّرة على الخادم، دون أن يُغلق </script> داخل البيانات الوسمَ مبكرًا.

تفاصيل تقنية

خوارزمية التهريب

تُسلسِل الأداة إدخالك بقواعد سلاسل مواصفة JSON: U+0022 (") → \"، U+005C (\) → \\، U+0008 → \b، U+000C → \f، U+000A → \n، U+000D → \r، U+0009 → \t، وأي حرف آخر أسفل U+0020 → \u00XX. مع التغليف، تُضمَّن علامتا الاقتباس المزدوجتان المحيطتان؛ وبدونه تُجرَّد. يطابق هذا خرج مُسلسِل متوافق تمامًا، ما يضمن دورات ذهاب وإياب بلا خسارة.

يونيكود والأزواج البديلة

افتراضيًا، تُصدَر الأحرف فوق U+007F كـ UTF-8 حرفي يسمح به JSON. مع تفعيل تهريب ما هو خارج ASCII، يُحوَّل كل حرف كهذا إلى \uXXXX باستخدام وحدة شفرته UTF-16؛ والأحرف خارج المستوى متعدد اللغات الأساسي (إيموجي، كتابات نادرة) تُرمَّز كزوج بديل من تهريبَي \uXXXX — مثلًا 😀 (U+1F600) يصبح \ud83d\ude00، التمثيل نفسه الذي ينتجه مُسلسِل JSON.

الشرطة الأمامية وسياق HTML

لا يتطلب JSON تهريب /، لذا تُحفَظ افتراضيًا. عند تفعيل تهريب الشرطة المائلة الأمامية، يصبح كل / هو \/. السبب العملي الوحيد لذلك هو التضمين في HTML: داخل وسم <script>، تُغلق السلسلة الفرعية الحرفية </script> الوسمَ بصرف النظر عن سياق JSON، فتهريب الشرطة إلى <\/script> يُبقي JSON المُضمَّن سليمًا مع بقائه صالحًا حسب المواصفة.

أفضل الممارسات

أبقِ التغليف مفعّلًا للسلاسل الكاملة

حين تحتاج قيمة للإسناد في الكود أو اللصق بعد النقطتين في JSON، أبقِ التغليف بعلامتي اقتباس مزدوجتين مفعّلًا — الخرج سلسلة JSON كاملة قابلة للتحليل مطابقة لـ JSON.stringify. عطّله فقط حين تكتب علامات الاقتباس المحيطة بنفسك.

اترك تهريب يونيكود معطّلًا ما لم يلزم

UTF-8 الخام هو JSON صالح وأكثر قابلية للقراءة بكثير. فعّل تهريب ما هو خارج ASCII فقط لنظام لاحق بعينه يُسيء معالجة UTF-8 (SOAP قديم، بعض خطوط أنابيب السجلات، ملفات مصدرية بـ ASCII فقط). تهريب كل شيء افتراضيًا يجعل الخرج أكثر ضوضاء فحسب.

هرّب الشرطات لتضمين HTML فقط

تهريب الشرطة الأمامية يهم في مكان واحد بالضبط: JSON مُضمَّن في وسم <script> بـ HTML. خارج هذا السياق يضيف فوضى بلا فائدة، فاتركه معطّلًا لأجسام REST وملفات الإعدادات وحمولات الرسائل.

تحقق من دورات الذهاب والإياب بالتبديل

قبل إطلاق بيانات مُهرَّبة في خط أنابيب، انقر تبديل الاتجاه لفكّ تهريبها وتأكيد استرجاع النص الأصلي. هذا يلتقط التهريب المزدوج العرضي — مصدر متكرر لظهور \\n حيث كان المقصود \n. اعكس في أي وقت بأداة فكّ تهريب JSON.

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