Formatar, codificar, gerar, validar: escolher a ferramenta certa

Ferramentas de desenvolvedor costumam usar palavras parecidas para trabalhos bem diferentes. Formatar, codificar, gerar, validar, converter e inspecionar soam simples, mas escolher a operação errada gera resultados confusos.

O fluxo mais rápido começa nomeando a operação corretamente.

Formatar: tornar dados existentes legíveis

Formatar muda a apresentação sem mudar o significado dos dados. Um formatador JSON adiciona quebras de linha e indentação, mas os valores do objeto devem permanecer os mesmos.

Use formatação quando os dados já são válidos e você quer ler, revisar ou commitar com diffs mais limpos. O Formatador JSON é o exemplo mais claro: pode pretty-print, minificar, ordenar chaves e mostrar árvore para JSON válido.

Codificar: representar dados para transporte

Codificar muda como os dados são representados para passar por um sistema específico. Codificação de URL protege caracteres reservados em URLs. Base64 representa bytes como texto. Nenhuma das duas significa que os dados estão criptografados.

Use o Codificador / Decodificador URL para query strings, valores de formulário e componentes de URI. Use o Codificador / Decodificador Base64 para texto ou arquivo que precise de representação segura para transporte.

Gerar: criar dados novos

Geração cria valores novos em vez de transformar entrada existente. Um gerador de UUID cria identificadores aleatórios. Um gerador de senhas cria segredos ou frases-senha conforme regras selecionadas.

Use geração quando reutilizar dados reais seria arriscado ou bagunçado. O Gerador de UUID serve para fixtures e IDs temporários. O Gerador de senhas serve quando você precisa de valores fortes criados por criptografia do navegador.

Validar: checar se os dados seguem regras

Validação responde sim ou não: esta entrada segue a sintaxe ou o schema esperado?

Validação JSON checa sintaxe. Validação com JSON Schema checa estrutura e restrições. Inspeção de timestamp checa se um número provavelmente representa segundos ou milissegundos. Validação costuma ser o primeiro passo antes de formatar ou converter.

Converter: mudar forma ou unidade

Conversão transforma uma representação em outra. Um timestamp Unix pode virar data ISO 8601. YAML pode virar JSON. JSON pode virar tipos TypeScript. Conversão é útil quando a mesma informação precisa caber em outro sistema.

Use o Conversor de Timestamp quando o mesmo instante precisa circular entre segundos Unix, milissegundos, hora local, UTC e strings ISO.

Regra de decisão simples

Pergunte o que você quer que aconteça com a entrada:

• Precisa ler? Formate.
• Precisa enviar por um canal restrito? Codifique.
• Precisa de um valor novo? Gere.
• Precisa saber se está correto? Valide.
• Precisa da mesma informação em outra representação? Converta.

Essa distinção pequena economiza tempo e evita mudanças acidentais em dados que você só queria inspecionar.