Converter YAML para JSON
A conversão de arquivos de configuração YAML para o formato JSON traduz estruturas de texto indentadas e legíveis por humanos em objetos de análise rigorosa por máquina para aplicações web.
Comparação de formatos e especificações técnicas
| Especificação | YAML | JSON |
|---|---|---|
| Tipo MIME | text/ | application/ |
| Tipo | serialização de dados legível por humanos | objeto de dados estruturados |
| Compressão | nenhum (texto UTF-8) | nenhum (fluxo de texto) |
| Especificação padrão | YAML 1.2 Specification | IETF RFC 8259 / ECMA-404 |
| Assinatura binária (magic bytes) | 2D 2D 2D (--- YAML document start marker) or key: value | 7B (\{) or 5B (\[) JSON root delimiter |
Visão geral e aplicações do formato
YAML é comum em manifestos do Kubernetes, arquivos do Docker Compose e fluxos de trabalho do GitHub Actions. Ele permite comentários e usa indentação; o JSON usa chaves, colchetes e nomes de propriedades entre aspas. A conversão remove os comentários do YAML e pode alterar a interpretação de datas, valores booleanos ou números. Por isso, valide o JSON com a ferramenta que vai lê-lo. Algumas ferramentas aceitam os dois formatos, enquanto outras exigem um formato ou uma versão específica do esquema. Confira a documentação de configuração da ferramenta de destino antes de converter um arquivo que você pretende implantar.
Especificações técnicas e análise de codecs
A configuração YAML utiliza o tipo MIME text/yaml com codificação de texto UTF-8 e baseia-se na indentação para agrupar dados. A configuração JSON utiliza o tipo MIME application/json e baseia-se em chaves, colchetes e aspas duplas explícitas para definir estruturas de objetos. Nenhum dos formatos utiliza cabeçalhos de bytes mágicos, uma vez que ambos são fluxos de texto simples em vez de arquivos binários. Ambos os formatos são estritamente sem perda durante a conversão. A conversão de estruturas de texto de YAML para JSON altera totalmente as regras de sintaxe, mas os valores reais dos dados permanecem idênticos sem perda de informação.
Compatibilidade com sistemas operacionais e navegadores
JSON pode ser analisado diretamente no JavaScript do navegador com JSON.parse(). YAML precisa de uma biblioteca analisadora ou de um aplicativo com suporte a YAML, como um editor com extensão para YAML.
Informações úteis
Valide sempre a sua sintaxe YAML usando um validador online antes de iniciar o processo de conversão para detectar erros de indentação ocultos.
Perguntas frequentes
Como converter configuração YAML para configuração JSON sem perder qualidade?
Nem sempre. A interpretação dos valores pode mudar, os aliases são resolvidos e os comentários perdem-se; o resultado depende do analisador e das opções. Verifique a saída segundo o esquema de destino.
Qual é a diferença entre a configuração YAML e a configuração JSON?
O YAML utiliza espaços e indentação para agrupar dados e permite comentários, facilitando a leitura por humanos. O JSON utiliza chaves, colchetes e aspas duplas estritas, não permitindo comentários, o que facilita a análise por máquinas.