Como converter XML em JSON (atributos, arrays, namespaces e CDATA explicados)
Converta XML em JSON e veja como ficam atributos, tags repetidas, texto, namespaces e CDATA, com um exemplo de antes e depois. Tudo no seu dispositivo.
Atualizado em 7 de novembro de 20269 min de leitura
Para converter XML em JSON, cole o XML ou solte o arquivo no conversor de XML para JSON, escolha a forma do resultado, clique em Converter para JSON e baixe ou copie o resultado. O que confunde as pessoas não é o botão, é a correspondência: o XML tem atributos, texto, tags repetidas, namespaces e CDATA, e o JSON só tem objetos, arrays e valores simples. Este guia mostra em que cada recurso do XML se transforma com as configurações padrão, quais opções mudam isso e quando a volta para XML não devolve o mesmo documento.
Converter XML em JSON, passo a passo
Adicione o seu XML
Abra o conversor de XML para JSON. Cole o código no editor ou solte um arquivo na página. Ele abre .xml, .rss, .atom, .svg, .kml, .gpx, .plist, .opml, .xsd, .wsdl, .xsl e mais alguns, e detecta a codificação de caracteres para você.
Escolha a forma de saída
Forma de saída tem cinco opções: Compacta, BadgerFish, GData, Parker e JsonML. Compacta é a padrão e a que a maioria espera. A correspondência abaixo usa Compacta, a menos que se diga outra coisa.
Ajuste atributos, arrays e namespaces
Decida se os atributos serão mantidos, que prefixo suas chaves levam, se uma tag que aparece uma única vez deve virar array mesmo assim e o que fazer com os prefixos de namespace. A pré-visualização acompanha cada mudança.
Converta e leve o resultado
Clique em Converter para JSON, escolha 2 espaços, 4 espaços, tabulações ou saída minificada em Recuo, e baixe o arquivo .json ou copie-o. Se o arquivo não estiver bem formado, você vê a linha, a coluna e a linha de origem com o erro, em vez de um JSON quebrado.
Um exemplo de antes e depois
Aqui está um documento pequeno que usa quase todos os recursos do XML ao mesmo tempo, convertido com as configurações padrão (forma Compacta, prefixo de atributo @_, chave de texto #text, recuo de 2 espaços).
| XML de entrada | JSON de saída |
|---|---|
<order id="A7" xmlns:s="urn:shop"> | "order": { "@_id": "A7", "@_xmlns:s": "urn:shop", ... } |
<s:item sku="007">Pen</s:item> e <s:item sku="008">Ink</s:item> | Um array de dois objetos: "s:item": [ { "@_sku": "007", "#text": "Pen" }, { ... } ] |
<note><![CDATA[a < b & c]]></note> | "note": "a < b & c" |
<gift/> | "gift": "" |
De cima para baixo, as linhas são os filhos de um único objeto order. Repare em quatro coisas: os atributos levam o prefixo @_, as duas tags s:item viraram um array, o texto CDATA perdeu o invólucro e o sku 007 continua sendo a string "007", não o número 7.
Como cada recurso do XML vira JSON
| No XML | No JSON (Compacta) | Por quê |
|---|---|---|
<a>text</a> | "a": "text" | Um elemento só com texto e sem atributos vira um valor simples |
<a id="1">text</a> | "a": { "@_id": "1", "#text": "text" } | Atributos precisam de um objeto, então o texto vai para a chave de texto |
<a/> | "a": "" | Um elemento vazio vira string vazia, a menos que você escolha null ou objeto vazio |
<i>1</i><i>2</i> | "i": ["1", "2"] | Irmãos com o mesmo nome viram um array, em ordem |
Um único <i>1</i> | "i": "1" | Uma única ocorrência continua sendo um valor simples, a menos que Arrays esteja em Sempre |
<![CDATA[x < y]]> | fundido ao texto | CDATA é só texto com os caracteres especiais sem escape |
<p>Hello <b>x</b></p> | "p": { "b": "x", "#text": "Hello" } | O conteúdo misto mantém tanto o filho quanto o texto ao redor |
<s:item> | "s:item" | O prefixo do namespace fica como foi escrito |
Atributos: o prefixo e a chave de texto
O JSON não tem atributos, então todo conversor precisa de uma convenção. Este escreve cada atributo como uma chave que começa com @_ e coloca o texto do elemento em #text. O prefixo existe para que um atributo nunca colida com um elemento filho de mesmo nome: <book title="A"><title>B</title></book> precisaria, sem ele, de duas chaves chamadas title. Você pode mudar o Prefixo de atributo e a Chave de texto, ou desligar Manter atributos se quiser apenas o conteúdo dos elementos.
Duas outras formas dão nomes diferentes. O BadgerFish usa @name para atributos e $ para texto. O GData escreve os atributos como chaves simples e o texto como $t. O Parker descarta os atributos e também o nome do elemento raiz, de modo que você recebe só o conteúdo; é essa a ideia dele, e por isso os controles de atributos não fazem nada nessa forma.
Elementos repetidos e arrays
Quando uma tag se repete entre irmãos, ela vira um array, na ordem em que apareceu. A armadilha é o caso único. Um feed com três entradas <item> dá um array, e o mesmo feed com uma entrada dá um objeto, então o código que percorre os itens quebra justamente no dia tranquilo. Se o JSON vai para um código, coloque Arrays em Sempre: todo elemento que pode se repetir vira um array mesmo havendo só um. A opção padrão, Quando repetido, dá uma saída mais curta e legível.
Isso importa principalmente em feeds RSS e Atom: channel, item, category e atom:link podem se repetir. O texto do feed costuma vir dentro de CDATA, como em content:encoded, e acaba como strings comuns.
Namespaces: manter, remover ou expandir
| Configuração | <soap:Body> vira | Use quando |
|---|---|---|
| Manter prefixo (padrão) | "soap:Body" | Você lê SOAP ou WSDL e quer que o JSON corresponda ao documento |
| Remover | "Body" | Você quer chaves curtas e o documento não tem nomes que colidam |
| Expandir para URI | "{http://schemas.xmlsoap.org/soap/envelope/}Body" | O JSON será comparado ou validado e nada pode ser ambíguo |
Remover é a única configuração que pode perder informação. Se a:id e b:id viram id, eles se fundem em uma chave só, como se fossem repetições do mesmo elemento. A ferramenta conta essas colisões e avisa, em vez de deixar a fusão passar em silêncio. Um prefixo usado sem declaração é um erro, porque adivinhar um namespace colocaria dados inventados na sua saída.
As cinco formas, o tratamento de namespaces e as opções de tipos são grátis. Grátis: um arquivo de até 25 MB por vez. Pro: até 50 arquivos e um único download em ZIP. Tudo roda no seu dispositivo, não nos nossos servidores.
Converter XML em JSONA volta para XML é sem perdas?
Na maioria das vezes não, e depende da forma. Todas as formas baseadas em chaves (Compacta, BadgerFish, GData, Parker) guardam os filhos por nome em um objeto, e um objeto não tem ordem entre chaves diferentes. Pegue <a>1</a><b>2</b><a>3</a>. A Compacta dá "a": ["1", "3"], "b": "2", e nada ali diz que o b ficava entre os dois elementos a. O conteúdo misto tem o mesmo problema: em <p>Hello <b>x</b> there</p> o texto é reunido em #text e se perde onde ficava a parte em negrito. Comentários e instruções de processamento são descartados por padrão, então ative Manter comentários ou Manter instruções de processamento se precisar deles.
A única exceção é o JsonML. Ele escreve cada elemento como um array com o nome, um objeto de atributos opcional e os filhos em ordem, de modo que <a>1</a><b>2</b><a>3</a> dentro de uma raiz vira ["root", ["a", "1"], ["b", "2"], ["a", "3"]]. Nada é reordenado. É mais incômodo de ler, mas é a forma certa quando o documento precisa voltar exatamente igual.
Quando a ordem não importa, voltar com JSON para XML funciona bem, com uma configuração que vale conhecer. A opção que transforma chaves com @ em atributos vem desligada por padrão e remove apenas o @ inicial da chave. Como o XML para JSON escreve @_id por padrão, defina o Prefixo de atributo como @ antes de converter, ou você receberá na volta um atributo chamado _id. Duas outras coisas não sobrevivem: um número inferido a partir do texto perde a grafia original, e um array de um só item volta como um elemento solto.
Elementos vazios, espaços em branco e CDATA
Elementos vazios podem virar uma string vazia, null ou um objeto vazio. Escolha null se um valor ausente e um valor em branco significam coisas diferentes adiante, como em um campo que aceita nulo. Espaços em branco vem em Aparar por padrão, para que o recuo de um arquivo formatado não entre nas suas strings. Colapsar reduz sequências de espaços e quebras de linha a um único espaço, e Como escrito deixa o texto exatamente como está.
Fundir CDATA com o texto vem ativado por padrão, que normalmente é o que se quer, pois CDATA é só uma forma de escrever caracteres como < e & sem escape. Se você desativar, cada seção CDATA é mantida em sua própria chave #cdata. No GData e no Parker a opção fica oculta, porque essas formas não têm chave para uma seção separada.
Limites, formatos e erros
| Grátis | Pro | |
|---|---|---|
| Tamanho do arquivo | 25 MB por arquivo | Sem limite imposto pela ferramenta, só o que o seu dispositivo aguentar |
| Arquivos por vez | 1 | Até 50, entregues em um ZIP |
| Opções de conversão | Todas | Todas |
| Saídas extras | JSON | Também um registro por linha (NDJSON) e um JSON Schema |
A entrada pode estar em UTF-8, UTF-16, Windows-1252 ou ISO-8859-1, e Codificação vem em Detectar por padrão. O analisador é rígido de propósito. Uma tag de fechamento que não combina, um & solto, um atributo duplicado ou uma entidade desconhecida como interrompem a conversão com uma mensagem que indica a linha e a coluna. Se você tem certeza de que o arquivo está certo, exceto pelas entidades desconhecidas, ative Permitir entidades desconhecidas e ele passa. Para escolher entre os formatos, veja JSON, CSV e XML: qual usar, e, com o JSON em mãos, o formatador de JSON e o validador de JSON ajudam a conferir.
Perguntas frequentes
Como converto XML em JSON online?
Cole o XML ou solte o arquivo no conversor de XML para JSON, escolha uma forma de saída (Compacta é a padrão), clique em Converter para JSON e baixe ou copie o resultado. A versão grátis aceita um arquivo de até 25 MB por vez, e tudo roda no seu dispositivo.
O que acontece com os atributos do XML no JSON?
Por padrão cada atributo vira uma chave que começa com @_, como "@_id": "A7", e o texto do elemento fica em #text quando o elemento também tem atributos. Você pode mudar o prefixo e a chave de texto ou desligar os atributos. O Parker é a única forma que sempre os descarta.
Por que um elemento XML vira objeto e outro vira array?
Uma tag que se repete entre irmãos vira array, e uma que aparece uma vez continua sendo um valor simples. Se o seu código sempre espera um array, coloque Arrays em Sempre para que até um único elemento venha dentro de um array.
Como converto um feed RSS em JSON?
Cole o feed ou solte o arquivo .rss ou .xml no conversor. Cada item vira uma entrada de um array, os prefixos atom: e content: são mantidos por padrão e o texto CDATA vira strings comuns. Coloque Arrays em Sempre se o feed puder ter um único item.
Posso converter o JSON de volta para o mesmo XML?
Só se nada depender da ordem. A Compacta e as outras formas baseadas em chaves perdem a ordem de tags diferentes e a posição do texto entre elementos. O JsonML mantém a ordem do documento exatamente. Ao voltar com JSON para XML, defina o prefixo de atributo como @ para que os atributos sejam mapeados corretamente.
Por que meu XML mostra um erro de análise?
O conversor é rígido. As causas comuns são uma tag não fechada ou que não combina, um e comercial sem escape (use &), um atributo duplicado, um prefixo de namespace não declarado ou uma entidade desconhecida como . A mensagem informa a linha, a coluna e a linha de origem para você corrigir.