BrowserTools
Publicidade
Início / Conversores / Conversor de JSON para YAML

Conversor de JSON para YAML

Converte entre JSON e YAML nos dois sentidos, de forma privada no teu navegador.

A carregar Conversor de JSON para YAML… Se nada acontecer, ativa o JavaScript.

JSON e YAML são dois dos formatos mais comuns para configuração e troca de dados, e converter entre eles é uma tarefa diária para quem trabalha com manifestos de Kubernetes, pipelines de CI, cargas úteis de API ou configuração de aplicações. JSON é rigoroso e omnipresente, ideal para a comunicação máquina a máquina, ao passo que YAML é bastante mais agradável de ler e editar para as pessoas graças à sua estrutura baseada na indentação, aos comentários e à ausência de chavetas e aspas. Este conversor move os dados em qualquer direção para que possas escolher o formato que melhor se adapta à tarefa que tens à frente.

Perguntas frequentes

Os meus dados são enviados para um servidor durante a conversão?
Não. Tanto a conversão de JSON para YAML como a de YAML para JSON correm inteiramente no teu navegador usando uma biblioteca incluída e o analisador JSON integrado. A tua entrada, que pode incluir segredos ou nomes de anfitrião internos em ficheiros de configuração, nunca sai do teu dispositivo e nunca é registada.
A conversão perde algum dado ou comentário?
Os valores dos dados e a estrutura são preservados exatamente ao converter entre os formatos. Os comentários do YAML são a única coisa que não consegue sobreviver a uma passagem pelo JSON, porque o JSON não tem o conceito de comentários, por isso converter YAML para JSON e de volta vai eliminá-los. Os dados simples, incluindo objetos e arrays aninhados, fazem o percurso de ida e volta sem problemas.
Que versão e funcionalidades de YAML são suportadas?
O conversor usa uma biblioteca YAML amplamente adotada que suporta as funcionalidades comuns de YAML 1.1 e 1.2 que vais encontrar em ficheiros de configuração reais: escalares, sequências, mapeamentos, cadeias multilinha e âncoras. As construções YAML muito exóticas ou não padrão podem não converter, situação em que a ferramenta comunica um erro de análise claro.
Porque é que estou a receber um erro de análise?
Um erro de análise significa que a entrada não é válida no formato que selecionaste. No JSON costuma ser uma vírgula final, uma aspa em falta ou aspas simples em vez de duplas. No YAML é mais frequente uma indentação inconsistente ou um caráter de tabulação, já que o YAML exige espaços. A mensagem de erro orienta-te para o problema.
O que faz o botão de troca?
A troca inverte a direção da conversão e move a saída atual para a caixa de entrada, para que possas convertê-la imediatamente de volta. É uma forma rápida de fazer uma ida e volta com os dados, verificar uma conversão ou continuar a trabalhar no outro formato sem copiar e colar à mão.
Consegue lidar com ficheiros de configuração grandes?
Sim, dentro do razoável. Os ficheiros até algumas centenas de kilobytes convertem-se instantaneamente. Os documentos muito grandes são mantidos em memória como cadeias e analisados numa única passagem, por isso os ficheiros extremamente grandes (de muitos megabytes) podem ser lentos em dispositivos com pouca memória, mas os manifestos de Kubernetes e as configurações de aplicações típicas não são problema.
Porque é que o YAML é tão popular para configuração?
O YAML foi concebido para ser amigável para as pessoas: a indentação mostra a estrutura, as aspas e as chavetas são na sua maioria opcionais e os comentários são permitidos. Isso torna os ficheiros de configuração mais fáceis de ler e rever nas pull requests. O JSON continua a ser a melhor escolha para as API e a troca entre máquinas porque é mais rigoroso e suportado em todo o lado, que é precisamente a razão pela qual converter entre ambos é tão comum.
A ferramenta funciona offline?
Sim. A biblioteca YAML está incluída na página, por isso, depois de carregada, o conversor corre inteiramente na tua máquina sem mais pedidos de rede, mesmo sem qualquer ligação à internet.

Sobre Conversor de JSON para YAML

Escolhe JSON para YAML para transformar um objeto JSON compacto num documento YAML limpo e indentado, ou muda para YAML para JSON para produzir um JSON rigoroso e bem formatado a partir de um ficheiro YAML. O conversor analisa a tua entrada por completo antes de a voltar a serializar, por isso os erros estruturais (como uma vírgula em falta no JSON ou uma indentação inconsistente no YAML) são detetados e comunicados com clareza em vez de produzirem uma saída silenciosamente corrompida. Um botão de troca permite-te inverter a direção e reintroduzir o resultado anterior, o que é útil para os testes de ida e volta e as verificações rápidas.

Toda a conversão acontece no teu navegador usando uma biblioteca YAML incluída e o analisador JSON nativo da plataforma. Nunca são enviados dados para um servidor, nada é registado e a ferramenta continua a funcionar sem ligação à rede. Como os teus ficheiros de configuração contêm muitas vezes segredos, nomes de anfitrião internos e outros detalhes sensíveis, manter tudo localmente importa, e com esta ferramenta os teus dados nunca saem da máquina onde estás a trabalhar.

O que significa YAML, afinal?

YAML significava originalmente 'Yet Another Markup Language' (Mais uma linguagem de marcação), um nome ligeiramente irónico escolhido quando o formato surgiu pela primeira vez em 2001. Mais tarde, os criadores mudaram o significado para o recursivo 'YAML Ain't Markup Language' (YAML não é uma linguagem de marcação) para sublinhar que se destina a dados, e não a marcar documentos como fazem o HTML ou o XML.

Um dos objetivos de design que definem o YAML era ser um superconjunto rigoroso do JSON. Por causa dessa ascendência, qualquer documento JSON válido é também YAML válido, que é a razão pela qual converter JSON para YAML é sempre possível e pela qual alguns analisadores de YAML conseguem ler JSON diretamente. O inverso não está garantido, já que o YAML tem funcionalidades como os comentários e as âncoras que o JSON simplesmente não consegue representar.

A dependência do YAML em relação aos espaços em branco significativos é ao mesmo tempo a sua maior força e a sua armadilha mais notória. A indentação torna os documentos legíveis, mas uma única tabulação perdida ou uma chave mal alinhada pode mudar o significado de um ficheiro ou parti-lo por completo. Essa sensibilidade é exatamente a razão pela qual uma ida e volta através de um analisador JSON rigoroso, como esta ferramenta oferece, é uma forma tão útil de validar que um ficheiro YAML tem realmente a estrutura que pretendias.

Publicidade
Publicidade
Publicidade