نسخت نص JSON من رسالة واتساب أو ملف Word فصار غير صالح مع أنه يبدو سليمًا، ما السبب؟
السبب غالبًا علامات التنصيص. برامج المحادثة ومعالجات النصوص تستبدل أحيانًا علامة التنصيص المستقيمة " بعلامتين منحنيتين “ و”، وهذه لا يقبلها JSON. منسّق JSON يشير إلى أول علامة منحنية بالسطر والعمود بالضبط، فتراها وتعيد كتابتها بنفسك، ولا يستبدلها نيابة عنك.
علامتان تبدوان متشابهتين
JSON لا يعرف إلا علامة تنصيص واحدة: المستقيمة التي على لوحة المفاتيح. أما العلامتان المنحنيتان، الفاتحة “ والغالقة ”، فهما حرفان مختلفان تمامًا في يونيكود، ويضعهما Word وبعض لوحات مفاتيح الجوال تلقائيًا لأنهما أجمل في النص العادي. على الشاشة، وخصوصًا بخط صغير، لا يكاد الفرق يُرى.
لذلك يحدث السيناريو المعتاد: مطوّر أو دعم فني يرسل لك قطعة إعدادات في رسالة، أو تنسخها من مستند شرح في Word، فتلصقها في لوحة متجرك أو في ملف، فيُرفض النص مع أن كل شيء يبدو في مكانه.
كيف تبدو في الأداة؟
هذا نص قصير فيه علامتان منحنيتان حول اسم المفتاح:
{“name”: "oud"}
تعرض الأداة: JSON غير صالح، خطأ عند السطر 1، العمود 2. وفي متصفح مبني على Chromium تكون رسالة المحلّل شيئًا مثل: Expected property name or '}'. العمود 2 هو موضع “ مباشرة بعد القوس، حيث كان المحلّل ينتظر علامة تنصيص مستقيمة تبدأ اسم المفتاح. وتظلل الأداة الحرف المخالف في السطر المعروض.
وإن كانت العلامة المنحنية في قيمة لا في مفتاح، مثل "note": “gift” في آخر سطر طويل، فستشير الأداة إلى عمودها كذلك، في مثالنا العمود 25. وحين لا تذكر رسالة المتصفح موقعًا، تحدده الأداة بمسح النص وتخبرك بذلك.
طريقة الإصلاح
- افتح منسّق ومدقّق JSON والصق النص كما نسخته.
- اقرأ السطر والعمود، واضغط «انتقل إلى موضع الخطأ» ليقف المؤشر على العلامة.
- احذف العلامة المنحنية واكتب مكانها علامة مستقيمة من لوحة المفاتيح.
- ستنتقل الأداة فورًا إلى الخطأ التالي إن وُجد، فكرر حتى تظهر رسالة «JSON صالح».
- انسخ الناتج المنسّق، وهو الآن نص نظيف يمكنك لصقه حيث تريد.
إن كان النص طويلًا وفيه علامات منحنية كثيرة، فاستبدلها كلها مرة واحدة ببحث واستبدال في محرر نصوص عادي قبل اللصق، ثم مرّره على الأداة للتأكد. الأداة نفسها لا تستبدل شيئًا، لأن الإصلاح التلقائي قد يغيّر علامة داخل نص عربي أو اقتباس كنت تريدها كما هي.
مسببات أخرى من النوع نفسه
- مسافة غير منقسمة أو حرف خفي في آخر النص: بعض التطبيقات تضيفها عند النسخ، والأداة تشير إليها كحرف غير متوقع بعد نهاية JSON. وإن أردت تنظيف المسافات الغريبة من نص عادي فجرّب تنظيف المسافات.
- علامة تنصيص مفردة ' بدل المزدوجة: ليست منحنية، لكنها غير مقبولة في JSON أيضًا.
- علامة الاقتباس العربية « » إن كتبها أحد بدل التنصيص.
لتجنب المشكلة من الأساس
اطلب ممن يرسل لك JSON أن يرسله ملفًا مرفقًا لا نصًا داخل الرسالة، أو داخل كتلة كود إن كانت المنصة تدعمها. ولا تحرر ملفات JSON في Word، بل في محرر نصوص عادي.
أسئلة شائعة
هل تستبدل الأداة العلامات المنحنية تلقائيًا؟
لا. تريك مكان كل خطأ فقط، وأنت تقرر التصحيح.
هل تؤثر العلامات المنحنية داخل قيمة نصية صحيحة؟
لا. إن كانت داخل قيمة محاطة بعلامتين مستقيمتين، مثل اسم منتج فيه اقتباس، فهي مجرد حرف في النص وتبقى صالحة.
لماذا رسالة الخطأ بالإنجليزية؟
لأنها تأتي من محلّل المتصفح نفسه، وتختلف صياغتها قليلًا بين المتصفحات. السطر والعمود هما المعلومة الأهم.