Guias

XML para JSON: preservando atributos, CDATA e feeds RSS

Converta arquivos XML, RSS e SVG para JSON na RAM mantendo atributos @_, blocos CDATA, tipos numéricos e estrutura XML reversível.

4 min de leitura

Resposta rápida: Para converter documentos XML, RSS ou SVG em JSON sem perder metadados, mantenha Ignorar atributos XML desativado e use o prefixo @_. O TxtTo valida erros XML por linha e coluna localmente, extrai blocos CDATA para strings JSON limpas, converte números e booleanos quando parseTagValue está ativo e reconstrói atributos @_ de volta para XML.

Por que atributos XML, nós de texto e CDATA entram em conflito com JSON

Diferente de objetos JSON que armazenam pares chave-valor simples, elementos XML combinam atributos dentro da tag de abertura, texto interno, nós irmãos repetidos e blocos CDATA com HTML ou código sem escape.

Conversores simplistas descartam atributos XML ou achatam tags item repetidas de feeds RSS de modo inconsistente, quebrando tipos TypeScript e parsers de API.

  • Atributos como id="bk101" ficam dentro da tag de abertura em vez de chaves filhas.
  • Elementos irmãos repetidos como entradas item de RSS precisam virar arrays JSON.
  • Seções CDATA embutem marcação ou scripts com < e & sem escapar entidades.
xml
<catalog currency="USD">
  <book id="bk101">
    <title><![CDATA[Browser <em>XML</em> Guide]]></title>
    <price>39.00</price>
  </book>
</catalog>

Controlando ignoreAttributes, attributePrefix (@_) e parseTagValue

O TxtTo roda o fast-xml-parser direto na RAM do navegador para você ajustar atributos e tipos em tempo real sem enviar feeds privados ou payloads SOAP pela rede.

Deixe ignoreAttributes desativado e mantenha attributePrefix em @_ para distinguir atributos de tags filhas. Desative parseTagValue sempre que zeros à esquerda em CEPs, notas fiscais ou SKUs precisarem continuar como strings em vez de números.

json
{
  "catalog": {
    "@_currency": "USD",
    "book": {
      "@_id": "bk101",
      "title": "Browser <em>XML</em> Guide",
      "price": 39
    }
  }
}

Converter XML, RSS e SVG para JSON localmente

Validando XML malformado e inspecionando árvores RSS ou SVG

Antes do parsing, o XMLValidator verifica a boa formação localmente e aponta tags abertas ou atributos inválidos pela linha e coluna exatas. Isso evita que exportações RSS quebradas ou SVGs truncados entrem no seu pipeline.

Após a conversão, abra a saída no Formatador JSON para navegar por hierarquias profundas na visualização em árvore, ordenar chaves alfabeticamente ou corrigir vírgulas finais após edições manuais.

Inspecionar e formatar árvores JSON convertidas

OpçãoPadrãoComportamentoQuando alterar
ignoreAttributesfalseMantém todos os atributos XML no JSONAtive apenas se os atributos forem ruído visual
attributePrefix@_Adiciona @_ antes das chaves de atributoMude caso o consumidor espere _ ou $
parseTagValuetrueConverte strings numéricas e booleanasDesative para preservar zeros à esquerda como 00412
indent2Formata o JSON com 2 espaços de recuoDefina 0 para saída compacta em linha única

Retornando de JSON para XML com rootName e includeDeclaration

Como todo XML válido exige um único elemento raiz, JSON para XML envolve arrays de nível superior em tags <item> dentro do rootName escolhido (padrão root) e adiciona <?xml version="1.0" encoding="UTF-8"?> quando includeDeclaration está ativo.

Qualquer chave JSON iniciada com @_ volta diretamente como atributo XML, e você pode conferir o resultado de ida e volta localmente no Comparador de Diff.

Serializar JSON de volta para XML formatado

Referências

Perguntas frequentes

Como blocos XML CDATA são tratados na conversão para JSON?

As seções CDATA são desembrulhadas em strings limpas no JSON sem escapar duplamente tags HTML ou caracteres &.

Como preservar zeros à esquerda de CEPs ou códigos SKU no XML para JSON?

Desative Converter tags numéricas e booleanas (parseTagValue) para que valores como 02139 permaneçam strings JSON em vez de virar 2139.

O JSON para XML recria atributos XML a partir do JSON convertido?

Sim. Toda propriedade iniciada por @_ no objeto JSON é gravada automaticamente como atributo no elemento XML pai.

Formatos relacionados

Comparativos relacionados

Guias relacionados