JSON para YAML — Conversor de JSON para YAML

O que faz o conversor de JSON para YAML

O conversor de JSON para YAML transforma JSON estrito em YAML legível, baseado em indentação, e converte YAML de volta em JSON formatado. Na direção JSON para YAML, a entrada é analisada com o parser JSON nativo e depois serializada com js-yaml: os objetos passam a mapeamentos aninhados, os arrays tornam-se sequências em bloco e os valores escalares perdem as chavetas e a maior parte das aspas. Na direção YAML para JSON, o YAML é analisado e gera JSON com indentação de dois espaços. Os erros de validação são apresentados de imediato, o que ajuda a detetar vírgulas finais, aspas em falta, indentação inconsistente e tabulações acidentais antes de copiar um resultado com problemas.

É útil ao mover configurações entre sistemas que preferem formatos diferentes: transformar um bloco de configuração JSON compacto num ficheiro YAML mais amigável para um pipeline de CI, um manifesto do Kubernetes ou um ficheiro de definições de um site estático, ou converter um exemplo YAML de volta em JSON para um pedido a uma API ou uma fixture. A origem e a saída permanecem visíveis, por isso as pequenas transformações são fáceis de verificar, e a conversão não aplica valores predefinidos ocultos nem reordena os dados além do que o serializador exige.

Fluxo de trabalho privado no navegador

Todo o processamento acontece dentro do seu navegador, com JavaScript do lado do cliente. A ferramenta não envia para nenhum servidor excertos, valores de configuração, identificadores, tokens ou exemplos copiados, e não exige conta. Este modelo exclusivamente local é importante nos utilitários para programadores, porque o conteúdo colado costuma parecer dados reais de aplicações: respostas de API, manifestos de implementação, exemplos com formato de variáveis de ambiente e valores copiados de sessões de depuração em produção. Manter a transformação local reduz o risco e torna a interação rápida, pois não há ida e volta pela rede.

A interface é propositadamente compacta: cola a entrada, escolhe uma direção, inspeciona a saída, copia-a e volta ao seu editor. Ainda assim, deve rever os resultados antes de os submeter ao repositório, partilhá-los publicamente ou usá-los num fluxo de produção. As ferramentas no navegador são excelentes para inspeção e preparação rápidas, mas não conseguem conhecer todas as convenções de um projeto, regras de classificação de dados ou requisitos de validação específicos de uma aplicação.

Dicas práticas

Conceptualmente, o YAML é um superconjunto do JSON, mas o modelo de dados prático é mais pequeno se se limitar a objetos, arrays, strings, números, booleanos e null, que são convertidos nos dois sentidos sem perdas. Tenha cuidado com valores que o YAML pode interpretar de forma especial: palavras simples como yes, no, on e off podem tornar-se booleanos, e strings sem aspas que pareçam números ou datas podem mudar de tipo, por isso coloque-as entre aspas quando o texto exato for importante. Ao converter configuração para produção, valide o ficheiro final com a ferramenta que o vai consumir e remova quaisquer segredos da entrada antes de copiar exemplos para outro local, mesmo que esta página mantenha a conversão local.