Конвертер 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, а повторяющиеся соседние элементы — массивами. При необходимости настройте отступ (2 или 4 пробела).

3. 3

   Скопируйте или скачайте

   Нажмите «Скопировать», чтобы поместить JSON в буфер обмена, или «Скачать», чтобы сохранить его в виде файла .json для вашего приложения, API или конвейера обработки данных.

Типичные ловушки конвертации

// 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 API

Устаревшие корпоративные сервисы (банковские, страховые, логистические) нередко предоставляют SOAP API, возвращающие XML. Конвертируйте ответ в JSON для работы с данными с помощью современных JavaScript-инструментов, хранения в документоориентированной базе данных или передачи потребителю REST API.

Обработка 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 API.

Технические детали

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-ориентированном контексте.

Часто задаваемые вопросы