DT Dev Tools

Code Formatter (Prettier) — Formatador de código

Formate JavaScript, TypeScript, CSS, SCSS, Less, HTML, JSON, GraphQL, Markdown e YAML com o Prettier, totalmente no seu navegador.

🔒 Executa completamente no seu navegador — nada é enviado

Advertisement

O que este formatador de código faz

Esta ferramenta executa o Prettier, o formatador de código opinativo usado por grande parte do ecossistema JavaScript, diretamente no seu navegador. O Prettier não se limita a reindentar linhas: ele analisa o seu código-fonte, transforma-o numa árvore sintática e imprime-o de novo do zero seguindo um pequeno conjunto de regras. É por isso que o resultado é consistente, por mais bagunçada que a entrada estivesse: listas longas de argumentos são quebradas, objetos só são divididos em várias linhas quando ultrapassam a largura de impressão, aspas e pontos e vírgulas seguem uma única convenção e os espaços no fim das linhas desaparecem.

Pode formatar JavaScript, JSX, TypeScript e TSX, os três principais dialetos de folhas de estilo (CSS, SCSS e Less), HTML com estilos e scripts incorporados, JSON, esquemas e consultas GraphQL, documentos Markdown e arquivos de configuração YAML. Cada linguagem usa o seu próprio plugin do Prettier, e apenas o plugin necessário é carregado, para que a página continue leve até você realmente formatar alguma coisa.

As opções explicadas

Print width (largura de impressão) é o comprimento de linha abaixo do qual o Prettier tenta ficar; 80 é o padrão, e 100 ou 120 são comuns em equipes com monitores largos. Tab width define quantos espaços ocupa um nível de indentação, e Indent with alterna entre espaços e caracteres de tabulação reais. Semicolons controla se as instruções em JavaScript e TypeScript terminam com ponto e vírgula; quando está desativada, o Prettier só o acrescenta onde é necessário para evitar ambiguidade. Single quotes prefere ' em vez de " nas strings, desde que isso não exija escapes. Estas opções correspondem uma a uma às configurações de um arquivo .prettierrc, para que possa reproduzir a configuração do seu projeto.

Privado e prático

Tudo acontece localmente: o formatador nunca envia o seu código, não o armazena nem o manda para nenhuma API. Por isso é seguro para código proprietário, arquivos de configuração com nomes de host internos ou trechos copiados durante um incidente em produção. Quando o analisador encontra um erro de sintaxe, a mensagem mostra a linha e a coluna e o cursor salta para esse ponto da entrada, o que torna esta uma forma rápida de encontrar um colchete em falta num arquivo JSON ou YAML grande. No dia a dia, mantenha o Prettier no seu editor e na CI; use esta página quando estiver numa máquina sem as suas ferramentas, revisando um trecho recebido pelo chat ou limpando código antes de colá-lo na documentação.

Como usar

  1. Escolha a linguagemSelecione a linguagem do seu trecho ou abra um arquivo para detectá-la pela extensão.
  2. Defina as opçõesAjuste a largura de impressão, a largura da tabulação, tabs ou espaços, pontos e vírgulas e o estilo de aspas.
  3. FormateClique em Format code. Os erros de sintaxe são exibidos com a linha e a coluna.
  4. Copie ou baixeCopie o código formatado de volta para o seu editor ou baixe-o como arquivo.

Perguntas frequentes

Que linguagens ele consegue formatar?
JavaScript, JSX, TypeScript (incluindo TSX), CSS, SCSS, Less, HTML, JSON, GraphQL, Markdown e YAML, usando os analisadores oficiais do Prettier.
O meu código é enviado para algum lugar?
Não. A versão standalone do Prettier é executada dentro do seu navegador. O analisador da linguagem selecionada é baixado como script estático na primeira vez que o usa, e o seu código nunca sai da página.
Por que recebo um erro de sintaxe?
O Prettier precisa analisar o código antes de poder imprimi-lo. Se o analisador falhar, a ferramenta mostra a mensagem com a linha e a coluna e move o cursor para lá. Verifique se a linguagem selecionada corresponde ao código.
O resultado será igual ao do Prettier no meu editor?
Usa o mesmo motor do Prettier, portanto, com opções idênticas, o resultado é o mesmo. Arquivos .prettierrc específicos do projeto e plugins de terceiros não são lidos, por isso ajuste a largura de impressão, as tabulações, os pontos e vírgulas e as aspas de acordo com a sua configuração.
Advertisement