Referência técnica e guia de arquitetura

Conversor de XML para JSON e Parser de Árvore Cheat Sheet — Guia de referência

Manual técnico de conversão entre W3C XML e RFC 8259 JSON, prefixos de atributos (@_), seções CDATA, agrupamento de listas e mensagens SOAP.

Parâmetros principais e controles

Sentido de Conversãostring

Direção da transformação: XML para JSON ou JSON para XML.

Padrão: xml-to-json
Prefixo de Atributostring

Prefixo utilizado para diferenciar atributos de tags de elementos filhos (ex. @_).

Padrão: @_
Chave de Conteúdo Textualstring

Propriedade utilizada para o valor do texto em nós que possuem atributos (#text).

Padrão: #text

Dicas profissionais e melhores práticas

Prevenção de Colisões de Atributos com Prefixo (@_)

Adicionar o prefixo '@_' aos atributos XML evita ambiguidades entre atributos de nó (<item id='1'>) e elementos filhos aninhados (<item><id>1</id></item>).

Manipulação Segura de Seções CDATA

Blocos CDATA (<![CDATA[...]]>) mantêm caracteres especiais sem escape. Na conversão para JSON, o conteúdo é decodificado em texto simples perfeitamente utilizável.

Execução Local Protege Mensagens Corporativas SOAP

Todo o processamento de XML ocorre na memória do seu navegador. Dados confidenciais de integrações empresariais jamais são enviados para a rede.

Problemas comuns e solução de problemas

Listas com item único convertidas em objeto em vez de array

Quando há apenas um elemento filho na lista, parsers comuns criam um objeto simples. Nossa ferramenta permite forçar a criação de arrays para consistência.

Falha no parser por caracteres sem escape (&, <, >)

Caracteres como '&' soltos violam a sintaxe W3C XML. Substitua por entidades formais (&amp;) ou encapsule em um bloco CDATA.

Perguntas frequentes (FAQ)

Como os atributos XML são traduzidos em estruturas JSON?▼

Como o JSON não possui atributos, eles são convertidos em propriedades com prefixo (ex. '@_id': '123') e o texto do nó é mapeado para '#text'.

A ferramenta suporta namespaces W3C e envelopes SOAP?▼

Sim. Declarações de namespace (xmlns:soap) e tags prefixadas (soap:Envelope, soap:Body) são preservadas integralmente como chaves JSON.

O que acontece com comentários XML durante a conversão?▼

Como a especificação JSON (RFC 8259) proíbe comentários, eles são removidos automaticamente para assegurar a conformidade do JSON resultante.

É seguro converter arquivos XML corporativos nesta ferramenta?▼

Sim. A ferramenta opera 100% no cliente ('use client'). Nenhum dado ou token de XML corporativo é transmitido a servidores externos.

Ferramentas e utilitários relacionados

Todas as ferramentas →