JavaScript Formatter
Understand JavaScript Formatter
Esta ferramenta arruma texto em JavaScript ou TypeScript — finais de linha, espaços no fim das linhas e sequências de linhas em branco — e imprime a entrada formatada como JSON quando detecta JSON.
How it works
Se o texto começa com { ou [, ele é tentado primeiro como JSON e, quando é interpretado com sucesso, impresso com indentação de dois espaços. Caso contrário, a limpeza é puramente textual: finais de linha CRLF e CR viram LF, espaços no fim são aparados de cada linha e três ou mais linhas em branco consecutivas se reduzem a duas. Nada é interpretado como código, então nada do que o seu código significa pode ser alterado — e, do mesmo modo, uma indentação que já estava errada continua errada.
When to use it
- Normalizar finais de linha em um arquivo que passou por editores no Windows e no macOS.
- Formatar um bloco JSON que você encontrou colado dentro de um arquivo JavaScript.
- Arrumar um trecho antes de colá-lo em uma issue ou em um comentário de revisão de código.
- Limpar uma saída gerada cheia de linhas em branco soltas e espaços no fim.
Watch out for
- Ele não reindenta. JavaScript minificado chega em uma linha e sai em uma linha — expandi-lo exige um parser que reconstrói o código a partir de uma árvore sintática, e isto não é isso.
- Qualquer coisa que comece com { ou [ é tentada como JSON, então um trecho que por acaso também seja um objeto JSON válido volta reimpresso como JSON em vez de continuar como código.
- Estilo de aspas, ponto e vírgulas, espaçamento dentro de expressões e largura de linha ficam intocados, então isto não vai fazer um arquivo obedecer a uma configuração do Prettier.
Not the right tool for: Formatar código que você está prestes a commitar. O Prettier ou o formatador do seu editor interpretam o código e produzem um resultado estável para o time inteiro; use isto para uma arrumação rápida de texto que você vai colar em algum lugar.
Frequently Asked Questions
Por que isto é mais básico que o Prettier?
Fazer o parsing completo da AST de JS/TS exige uma biblioteca de 3 a 5 MB. Esta ferramenta cuida da limpeza rápida — normalizar finais de linha, ajustar indentação, reduzir linhas em branco a mais e detectar JSON embutido — sem esse peso. Para formatação integrada ao editor, use a extensão do Prettier no VS Code.
Isto consegue formatar JavaScript minificado?
Em parte — ele trata o padrão mais comum de objetos minificados com cara de JSON embutidos em JS. JavaScript totalmente minificado (tudo em uma linha, sem espaços) exige um desparser de AST de verdade, que esta ferramenta não inclui.
Isto lida com módulos ES e TypeScript?
O formatador é baseado em texto (não em AST), então ele lida com qualquer sintaxe JavaScript válida, incluindo import/export, async/await, genéricos e anotações de tipo, sem compreendê-los. Ele não vai remover por engano a sintaxe específica do TypeScript.
How to Use JavaScript Formatter
- Paste or type your input in the input area above.
- The tool processes your input automatically or click Run.
- Copy or download the result using the action buttons.
- Use Ctrl+Enter to run quickly from the keyboard.