Perguntas frequentes

Qual é a diferença entre formatar e validar?

Formatar reescreve o seu texto com indentação e espaçamento consistentes para facilitar a leitura, sem alterar os valores. Validar verifica se o texto é válido e informa o veredito, e não altera o texto que você digitou. Quando o texto é válido, um validador também mostra uma cópia formatada dele.

O que significa “JSON estrito” e o que os erros me dizem?

As ferramentas de JSON seguem as regras do JSON à risca. Por exemplo, comentários e vírgulas finais não são JSON válido.

Quando o texto não é válido, a ferramenta mostra o primeiro erro que consegue localizar com segurança, com a linha e a coluna, para você saber por onde começar a corrigir.

A ferramenta pode corrigir o meu JSON?

Apenas em dois casos restritos: remover uma marca de ordem de bytes (BOM) no início do texto e remover uma vírgula final quando isso é seguro. Uma correção nunca é aplicada em silêncio. A ferramenta mostra uma prévia da mudança, e nada muda até você aceitar de forma explícita.

O que acontece quando uma conversão não pode ser feita com fidelidade?

O JSON to YAML mantém a estrutura e todos os valores dos seus dados, inclusive os tipos, ou recusa a conversão. O JSON to XML escreve um XML legível com todos os valores como texto: o número 1 e o texto "1" ficam iguais, uma lista com uma entrada parece um valor comum, uma lista vazia não deixa elemento e null e um objeto vazio são ambos elementos vazios, então o XML não pode ser convertido de volta no mesmo JSON. Ele também ajusta nomes de chaves que o XML não aceita, por exemplo "with space" vira with_space. O JSON to CSV é parecido: escreve células simples, então o texto "1" e o número 1 ficam iguais, null e um valor ausente viram uma célula vazia, e, para um objeto, usa a primeira lista de objetos que encontra e informa qual é no resultado. Nenhuma ferramenta altera em silêncio os seus textos nem os seus números, e, quando uma conversão é recusada, a ferramenta explica o motivo.

Há algo que eu deva saber sobre CSV?

Programas de planilha podem interpretar o conteúdo de um arquivo CSV: um texto que parece uma fórmula pode ser tratado como fórmula, e os valores podem ser redigitados, por exemplo como números ou datas. Antes de copiar ou baixar o resultado do JSON to CSV, você precisa confirmar que entendeu isso. Ao abrir o arquivo em uma planilha, importe-o como texto.

O site não pode prometer que um arquivo CSV seja seguro em todos os programas de planilha.

O meu texto é enviado para algum lugar?

Não. O texto que você digita ou cola, ou abre de um arquivo local, é processado localmente no seu navegador, em um Web Worker dedicado, e nunca é enviado nem chega ao servidor. Um arquivo que você abre é lido apenas no seu navegador. Ele também não é gravado em armazenamento, cookies nem na barra de endereços.

Para ver os detalhes completos, consulte a Política de Privacidade

Quanto texto posso processar?

A entrada e a saída completa podem ter, cada uma, até 2.000.000 de bytes (cerca de 2 MB) de texto em UTF-8. Letras fora do alfabeto latino básico, como as acentuadas, ocupam mais de um byte cada.

Se a entrada for maior, ela é recusada. JSON e YAML permitem até 256 níveis de aninhamento; HTML e XML permitem até 128 níveis de elementos, contando uma raiz como nível 1 e incluindo elementos com autofechamento e elementos vazios do HTML. CSS permite até 256 chaves, parênteses e colchetes abertos contados em conjunto, com um limite independente de 64 parênteses e colchetes abertos combinados. Uma entrada mais profunda é recusada, e o YAML Viewer recusa YAML com mais de 200.000 valores. Se a saída completa fosse maior, a ferramenta mostra apenas uma prévia incompleta de até 100.000 bytes, e essa prévia não pode ser copiada nem baixada. Uma execução que demore mais que o seu limite de tempo é interrompida.

Como copio ou baixo o resultado?

As ferramentas de formatação e de conversão oferecem uma ação de copiar, que coloca o resultado na área de transferência, e uma ação de baixar, que o salva como arquivo. Copiar grava na área de transferência apenas quando você pede. Baixar cria o arquivo no seu navegador, então nada é enviado. Os validadores também as oferecem, para o texto formatado que mostram quando o seu texto é válido; quando mostram apenas um veredito, não há nada para copiar ou baixar. O YAML Viewer mostra uma árvore em vez de texto, então não há nada para copiar ou baixar.

Os arquivos baixados são texto em UTF-8 com quebras de linha LF e sem marca de ordem de bytes, com estas exceções: os arquivos CSV usam quebras de linha CRLF, e o HTML Formatter deixa o conteúdo dos elementos script e style exatamente como você escreveu, quebras de linha incluídas. Copiar também deixa de fora a marca de ordem de bytes do início.

Quais idiomas posso usar?

A interface está disponível em English, Português (Brasil) e Español. Escolha um pelos links de idioma de qualquer página. Se você trocar de idioma ou de ferramenta na mesma aba, o texto que digitou continua na página.

Preciso de uma conta? Algo é salvo?

Não é preciso ter conta. O site não guarda histórico e não tem como salvar ou compartilhar o seu texto. Você pode abrir um arquivo do seu dispositivo, que é lido no seu navegador e nunca é enviado, mas não há importação por endereço da web. O texto fica na memória da página aberta, e recarregar ou fechar a aba o encerra. Separadamente do seu texto, se você apertar o botão de tema em uma página de ferramenta, o seu navegador guarda a sua escolha do visual claro ou escuro do painel da ferramenta até você limpar os dados do site. Ela fica só no seu navegador e nunca é enviada ao servidor. Não há API pública para desenvolvedores.

Tem outra pergunta?

Escreva para carvalhosoftwarecompany@gmail.com