حوّل XML إلى JSON!

أدخل XML لتحويله إلى JSON! يدعم SOAP, RSS.
XML
النتيجة
 

حوّل XML إلى JSON!

حوّل مستند XML إلى كائن JSON. تصبح السمات مفاتيح @name وتُجمَّع العناصر الأبناء المكررة في مصفوفات، فيمكن قراءة المستندات شديدة التداخل مثل استجابات SOAP أو خلاصات RSS ككائن JavaScript.

استخدمه لفهم بنية استجابة XML من نظام قديم قبل معالجتها في كود الواجهة الأمامية أو Node.js، أو لتحويلها إلى JSON وهمي للاختبارات. يتولى التحليل DOMParser في متصفحك.

طريقة الاستخدام

  1. الصق المستند في خانة XML أو أفلت ملف .xml عليها. التصريح <?xml ...?> اختياري.
  2. الوسوم غير المغلقة أو أخطاء الصيغة الأخرى تُظهر رسالة خطأ محلّل المتصفح في النتيجة.
  3. راجع JSON تحت النتيجة، ومفتاحه اسم العنصر الجذري، ثم انسخه.

مثال

المدخلات (XML)
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetRateResponse>
      <rate currency="USD">1342.5</rate>
      <note><![CDATA[rates < 1 hour old]]></note>
      <holiday/>
    </GetRateResponse>
  </soap:Body>
</soap:Envelope>
المخرجات (JSON)
{
  "soap:Envelope": {
    "@xmlns:soap": "http://schemas.xmlsoap.org/soap/envelope/",
    "soap:Body": {
      "GetRateResponse": {
        "rate": {
          "@currency": "USD",
          "#text": "1342.5"
        },
        "note": "rates < 1 hour old",
        "holiday": null
      }
    }
  }
}

أصبحت السمة currency هي @currency، وذهب الرقم داخل العنصر إلى #text كسلسلة نصية "1342.5". وتُحفظ < داخل CDATA كنص عادي، والعنصر الفارغ <holiday/> يكون null.

الميزات المدعومة

  • الناتج على شكل { "rootName": ... }، فيُحفظ اسم العنصر الجذري الأصلي.
  • تستخدم السمات مفاتيح تبدأ بـ @؛ والنص الموجود إلى جانب العناصر الأبناء أو السمات يوضع تحت #text.
  • العناصر التي لا تحوي إلا نصًا تصبح سلاسل نصية، والعناصر الفارغة تصبح null.
  • عنصران شقيقان أو أكثر بالاسم نفسه يُجمَّعان في مصفوفة.
  • تُقرأ أقسام CDATA كنص؛ وتُتجاهل التعليقات وتعليمات المعالجة.
  • تُحفظ الأسماء ذات بادئة مساحة الأسماء مثل soap:Body وسمات التصريح xmlns كمفاتيح.

حالات الاستخدام

فهم استجابة SOAP

حين تراه كـ JSON، يُظهر تداخل Envelope → Body → Response بالضبط أين يقع الـ payload، وذلك المسار يقابل مباشرة الوصول إلى الخصائص في كودك.

فحص خلاصات RSS أو Atom

تحقق من عدد مدخلات item في الخلاصة وأين تقع سمة url الخاصة بـ enclosure قبل كتابة كود التحليل.

تحويل استجابات XML إلى بيانات JSON ثابتة

عند بناء BFF أو محوّل (adapter) حول API بصيغة XML، فإن تحويل الاستجابات الحقيقية إلى JSON يعطيك بيانات اختبار ثابتة فورًا.

ملاحظات وقيود

  • كل قيمة سلسلة نصية؛ حتى <price>12.5</price> لا يُحوَّل إلى رقم، فحوّل حيث يلزم.
  • الابن المفرد يخرج ككائن لا كمصفوفة من عنصر واحد. قد يتغير شكل الاستجابة نفسها بحسب عدد العناصر، فتحقق بـ Array.isArray في الكود.
  • المحتوى المختلط مثل <p>hello <b>world</b> again</p> يُدمج نصه في #text واحد، فيضيع موضعه بين العناصر.
  • تُقص المسافات البيضاء في بداية النص ونهايته.

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

هل يمكن تحديد أنواع الأرقام والقيم المنطقية؟

لا يحمل XML أي معلومات أنواع غير النص، لذا لا تخمّن الأداة وتُبقي السلاسل النصية. وبذلك لا تُشوَّه قيم الرموز مثل "00123" بتحويلها إلى أرقام أبدًا.

أريد مصفوفة حتى حين لا يوجد إلا عنصر واحد.

لا يوجد خيار لذلك. التغليف في الكود بـ Array.isArray(x) ? x : [x] هو الحل الأبسط.

هل يمكن إعادة JSON إلى XML؟

تستخدم أداة JSON إلى XML اصطلاحات @ و#text نفسها، فإدخال هذا الناتج فيها يُنتج XML مجددًا. ولا تُستعاد التعليقات ولا التمييز بين CDATA والنص ولا موضع النص في المحتوى المختلط.