محوّل XML إلى JSON

ما هو تحويل XML إلى JSON وكيف يعمل؟

// Convert XML to JSON in Node.js using fast-xml-parser
import { XMLParser } from 'fast-xml-parser';

const xml = `<catalog>
  <product id="P01">
    <name>Wireless Headphones</name>
    <price currency="USD">79.99</price>
  </product>
</catalog>`;

const parser = new XMLParser({
  ignoreAttributes: false,      // preserve attributes
  attributeNamePrefix: '@_',    // @_ prefix for attributes
  textNodeName: '#text',        // #text for mixed element content
  parseAttributeValue: false,   // no type coercion on attributes
  parseTagValue: false,         // no type coercion on element text
});

const result = parser.parse(xml);
console.log(JSON.stringify(result, null, 2));
// {
//   "catalog": {
//     "product": {
//       "@_id": "P01",
//       "name": "Wireless Headphones",
//       "price": {
//         "@_currency": "USD",
//         "#text": "79.99"
//       }
//     }
//   }
// }

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

أمثلة

<?xml version="1.0" encoding="UTF-8"?>
<appConfig version="2.1" env="production">
  <database>
    <host>db.example.com</host>
    <port>5432</port>
    <name>myapp_prod</name>
    <pool max="10" min="2"/>
  </database>
  <cache enabled="true">
    <ttl>3600</ttl>
    <driver>redis</driver>
  </cache>
</appConfig>

<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://go-tools.org/tools/xml-to-json</loc>
    <lastmod>2026-05-29</lastmod>
    <changefreq>weekly</changefreq>
    <priority>0.8</priority>
  </url>
  <url>
    <loc>https://go-tools.org/tools/json-to-xml</loc>
    <lastmod>2026-05-29</lastmod>
    <changefreq>weekly</changefreq>
    <priority>0.8</priority>
  </url>
</urlset>

<item>
  <title>XML to JSON: A Practical Guide</title>
  <link>https://go-tools.org/blog/xml-to-json-guide</link>
  <pubDate>Thu, 29 May 2026 00:00:00 GMT</pubDate>
  <category>Developer Tools</category>
  <description>Learn how XML attributes map to @_ keys, how repeated elements become arrays, and why values stay strings in any XML-to-JSON conversion.</description>
  <guid isPermaLink="true">https://go-tools.org/blog/xml-to-json-guide</guid>
</item>

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

1. 1

   الصق XML الخاص بك

   أدخل أو الصق XML في حقل الإدخال أعلاه. يمكنك أيضاً النقر على «تحميل مثال» لتجربة عينة — ملف إعداد أو مقتطف خريطة موقع أو عنصر RSS.

2. 2

   شاهد إخراج JSON مباشرة

   يظهر JSON فوراً في لوحة الإخراج. تصبح السمات مفاتيح مسبوقة بـ @_، ومحتوى نص العناصر المختلطة يصبح #text، والعناصر المتجاورة المكررة تصبح مصفوفات. اضبط المسافة البادئة (مسافتان أو 4) حسب الحاجة.

3. 3

   انسخ أو حمّل

   انقر على «نسخ» لنقل JSON إلى الحافظة، أو «تحميل» لحفظه كملف .json جاهز لتطبيقك أو واجهة برمجية أو مسار البيانات.

مزالق التحويل الشائعة

// XML: <timeout>30</timeout>
// JSON output: { "timeout": "30" }  ← string, not number
// Dangerous: comparing as-is
if (config.timeout > 25) { ... }  // "30" > 25 coerces, but fragile

// XML: <timeout>30</timeout>
// JSON output: { "timeout": "30" }
// Safe: explicit coercion where you know the type
if (parseInt(config.timeout, 10) > 25) { ... }

// XML with one item: <root><item>a</item></root>
// JSON: { "root": { "item": "a" } }  ← string, not array
result.root.item.forEach(i => console.log(i));  // TypeError: not a function

// Normalize to array regardless of count
const items = [].concat(result.root?.item ?? []);
items.forEach(i => console.log(i));  // safe for 0, 1, or many

// XML: <price currency="USD">29.99</price>
// JSON: { "price": { "@_currency": "USD", "#text": "29.99" } }
const amount = result.price;  // { "@_currency": "USD", "#text": "29.99" }, not "29.99"

// Handle both plain string and @_/#text object
const raw = result.price;
const amount = typeof raw === 'object' ? raw['#text'] : raw;  // "29.99"

<!-- Unescaped & — well-formedness error -->
<query>name = 'Alice' & role = 'admin'</query>

<!-- Escaped & — valid XML -->
<query>name = 'Alice' &amp; role = 'admin'</query>

// XML: <zipCode>01234</zipCode>
// This tool outputs: { "zipCode": "01234" }  ← correct
// But if a downstream schema coerces:
// { zipCode: z.number() }  → 1234  ← leading zero lost

// Declare ZIP codes and other padded identifiers as strings
// { zipCode: z.string() }  → "01234"  ← correct

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

استهلاك واجهات SOAP والـ XML القديمة

الخدمات المؤسسية القديمة (البنوك والتأمين والخدمات اللوجستية) كثيراً ما تكشف عن واجهات SOAP تُعيد XML. حوّل الاستجابة إلى JSON للعمل مع البيانات باستخدام أدوات JavaScript الحديثة أو تخزينها في قاعدة بيانات مستندات أو إعادة توجيهها إلى مستهلك واجهة REST برمجية.

معالجة تغذيات RSS وAtom

تغذيات RSS 2.0 وAtom 1.0 هي XML. حوّل XML التغذية إلى JSON لاستخراج العناوين والروابط وتواريخ النشر والأوصاف لمجمّعات التغذيات ومسارات المحتوى وأنظمة الإشعارات دون اعتمادية مكتبة تحليل XML.

تحليل ملفات خرائط المواقع

تُعدّد ملفات sitemap.xml عناوين URL للموقع مع بيانات وصفية. حوّل خريطة موقع إلى JSON لتحليل تغطية URL وبناء قوائم انتظار الزحف ومقارنة خرائط المواقع عبر البيئات أو تغذية عناوين URL في أداة فاحص روابط أو تدقيق SEO.

تحويل ملفات الإعداد

كثير من الأنظمة المؤسسية (Spring وMaven وAnt وJBoss وTomcat) تستخدم ملفات إعداد XML. حوّلها إلى JSON للتحليل أو سكريبتات الترحيل أو توليد التوثيق أو الاستيراد في أدوات تتعامل مع JSON أصلاً.

تطوير تطبيقات Android للجوال

موارد Android وملفات التخطيط وAndroidManifest.xml كلها XML. حوّلها إلى JSON لسكريبتات التحليل والتدقيق الآلي أو توليد التوثيق حول الأذونات المُعلَن عنها والأنشطة وقيم الموارد.

ترحيل البيانات وETL

تصدير البيانات من الأنظمة المؤسسية (ERP وCRM والرواتب) كثيراً ما يصل كـ XML. حوّل إلى JSON كخطوة أولى في مسار ETL لتحميل البيانات في مخزن بيانات أصلي لـ JSON مثل MongoDB أو Firestore أو واجهة REST برمجية.

تفاصيل تقنية

DOMParser في المتصفح لتحليل XML

يُحلَّل مدخل XML باستخدام DOMParser الأصلي في المتصفح مع نوع MIME هو 'text/xml' — المحرك نفسه المستخدم لعرض SVG وXHTML. متوافق بالكامل مع XML 1.0 ويُبلّغ عن أخطاء الصياغة السليمة مع معلومات السطر والعمود. يتعامل هذا النهج مع مساحات الأسماء وأقسام CDATA وتعليمات المعالجة ومراجع الكيانات بشكل صحيح دون أي اعتمادية خارجية.

تسلسل DOM إلى JSON بشكل تكراري

بعد التحليل، تستعرض الأداة شجرة DOM بشكل تكراري. عقد العناصر تصبح كائنات JSON؛ سماتها تصبح مفاتيح مسبوقة بـ @_؛ العناصر النصية فحسب تصبح قيم سلسلة نصية عادية؛ العناصر التي تحتوي على سمات ومحتوى نص تكتسب مفتاح #text لمحتوى النص. تُجمَع العناصر المتجاورة بالاسم نفسه وتُخرَج كمصفوفة JSON. العقد النصية ذات المسافات البيضاء فحسب بين العناصر تُستبعَد.

بدون إكراه للأنواع — الحفاظ على السلاسل النصية

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

100% قائم على المتصفح — بدون رفع ملفات أو خادم

تتم جميع المعالجة في محرك JavaScript في متصفحك. لا تُنقَل أي بيانات عبر الشبكة في أي وقت. تتحول المدخلات الأكبر من 200 كيلوبايت تلقائياً من الوضع المباشر إلى الوضع اليدوي (مطلوب نقر «تحويل» صريح) للحفاظ على استجابة المتصفح ومنع تعطّل سلسلة المعالجة الرئيسية أثناء استعراض DOM الثقيل.

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

تحقق من صياغة XML السليمة أولاً

إذا كان مصدر XML مكتوباً يدوياً أو مُنشأً من نظام قد يُنتج إخراجاً مشوهاً أحياناً، تحقق منه قبل التحويل. استخدم زر «التحقق» في منسّق XML لتأكيد صياغة XML السليمة والحصول على مواضع أخطاء دقيقة لأي مشاكل.

طبّع الحقول ذات العنصر الواحد أو المتعدد إلى مصفوفات

عندما يسمح مخطط XML بعنصر فرعي واحد أو عدة عناصر فرعية بالاسم نفسه، سيكون إخراج JSON كائناً لعنصر واحد ومصفوفة للعدة عناصر. طبّع هذه الحقول دائماً في كود المستهلك: const items = [].concat(result.items ?? []) — وهذا آمن لصفر أو واحد أو عدة عناصر ويمنع TypeError.

طبّق إكراه الأنواع صراحةً وبشكل انتقائي

لأن هذه الأداة تحافظ على جميع القيم كسلاسل نصية، طبّق إكراه الأنواع بوعي في الكود الخاص بك للحقول المحددة التي تحتاجه. استخدام parseInt(val, 10) لحقل عدد صحيح معروف آمن. تطبيق الإكراه على نطاق واسع بـ Number(val) يخاطر بتلف القيم ذات الصفر الأمامي والسلاسل الفارغة والأعشار الحساسة للدقة.

تحقق من #text عند الوصول إلى قيم العناصر

إذا كان عنصر يمكنه امتلاك سمات في بعض الحمولات دون غيرها، فستكون قيمة JSON إما سلسلة نصية عادية (بدون سمات) أو كائناً بمفاتيح @_ ومفتاح #text (مع سمات). اكتب دوال وصول قوية: const val = typeof node === 'object' ? node['#text'] : node. هذا النمط يتعامل مع كلا الشكلين ويتجنب قيم undefined الصامتة.

للعمل مع XML بلا خسارة، استخدم منسّق XML

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

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