Como converter TOML para JSON

Quando usar esta conversão

Esta conversão transforma texto de configuração TOML numa representação JSON que pode ser consultada ou utilizada num contexto onde esse formato seja necessário. É adequada para configurações com valores de texto, números, valores booleanos e tabelas aninhadas. A apresentação do resultado pode ser ajustada através da indentação, enquanto uma opção separada permite ordenar as chaves. Antes de começar, tenha disponível o conteúdo TOML que pretende analisar e confirme que conhece a estrutura das tabelas usadas.

Procedimento de conversão

Prepare o conteúdo. Reúna o texto TOML e verifique visualmente nomes de chaves, valores, aspas, separadores e cabeçalhos de tabelas. O campo de entrada é opcional, por isso também pode iniciar a operação sem fornecer texto.
Introduza o TOML. Cole ou escreva a configuração no campo destinado ao texto. Se o deixar vazio, ou se inserir apenas espaços em branco, a operação é concluída com uma representação de objeto JSON vazio.
Escolha a indentação. Defina o número de espaços usado para organizar visualmente a representação JSON. O valor inicial é de 2 espaços; uma quantidade maior pode tornar uma estrutura extensa mais fácil de percorrer, enquanto uma quantidade menor ocupa menos espaço visual.
Decida como apresentar as chaves. Se quiser uma disposição ordenada, ative a opção de ordenar chaves. Esta preferência começa desativada, pelo que a ordenação só é aplicada quando a selecionar.
Execute a conversão. Inicie a operação depois de rever o texto e as opções escolhidas. Valores escalares e tabelas aninhadas são interpretados como dados JSON correspondentes, e datas, horas e valores de data e hora são serializados como cadeias em formato ISO.
Examine o resultado. Confirme se a conversão terminou com sucesso e se a estrutura apresentada corresponde ao TOML fornecido. Se a operação falhar, volte ao texto de origem e procure problemas de sintaxe antes de repetir a tentativa.

Leitura do resultado e das falhas

Uma conversão bem-sucedida apresenta uma representação JSON cuja organização visual depende do número de espaços escolhido. Alterar a indentação muda a forma como o conteúdo é mostrado, não a estrutura lógica que resulta dos dados TOML. A ordenação das chaves funciona como uma preferência de apresentação e só fica ativa quando a opção correspondente é selecionada.

As tabelas TOML aninhadas devem surgir como objetos JSON relacionados, enquanto textos, números e valores booleanos conservam os tipos correspondentes na representação. Datas, horas e valores de data e hora devem ser lidos como cadeias de texto em formato ISO, e não como tipos temporais autónomos no resultado. Uma entrada vazia tem um tratamento próprio e produz um objeto JSON vazio.

Quando a operação falha, não é apresentada uma representação convertida para utilização. TOML mal formado pode provocar esse resultado, por exemplo devido a aspas incompletas, separadores incorretos ou cabeçalhos de tabela problemáticos. Mesmo que a sintaxe esteja correta, uma falha durante a serialização JSON também termina a operação sem sucesso; por isso, valide o resultado antes de o encaminhar para outro uso.

Exemplo prático

Uma pessoa precisa de transformar uma pequena configuração TOML numa representação JSON legível antes de consultar os seus dados noutra ferramenta.

Cole nome = "Ana", idade = 30, data = 2024-01-15 e uma tabela [preferencias] com notificacoes = true. Mantenha a indentação inicial, deixe a ordenação desativada e execute a conversão.

A representação contém uma propriedade de texto, uma propriedade numérica e uma tabela aninhada apresentada como objeto; a data surge como cadeia de texto em formato ISO.

Limitações

TOML mal formado não é convertido, e uma falha durante a serialização JSON também impede a produção de uma representação convertida.

Erros comuns

Causa: o texto contém uma construção TOML mal formada, como uma aspa não fechada ou um cabeçalho de tabela incorreto. Ação: reveja a sintaxe no ponto suspeito, corrija o conteúdo e execute novamente a conversão.

Perguntas frequentes

É possível converter uma entrada TOML vazia?

Sim, desde que o campo fique vazio ou contenha apenas espaços em branco; nessa condição, a operação produz uma representação de objeto JSON vazio.

Posso alterar a indentação do JSON?

Sim. O número de espaços da indentação pode ser definido antes da operação, sendo 2 espaços o valor inicial.

A conversão corrige TOML inválido?

Não. Quando a sintaxe TOML está mal formada, a operação falha em vez de produzir uma representação JSON convertida; corrija o texto e repita a conversão.