Como usar o linter de fechamento

Observação: o Frontend Linter foi descontinuado e raramente é usado no Google. Consulte esta página para mais informações

Neste documento, descrevemos como instalar e usar o Frontend Linter.

Instalar o linter de fechamento

Use o utilitário pip do Python para fazer o download e instalar o Frontend Linter.

Linux

Para instalar o Frontend Linter no Linux, execute os seguintes comandos:

$ sudo apt-get install python-pip
$ sudo pip install https://github.com/google/closure-linter/zipball/master

Mac OS X

Para instalar o Frontend Linter no Mac OS X, execute o seguinte comando:

$ sudo easy_install pip
$ sudo pip install https://github.com/google/closure-linter/zipball/master

Windows

Para instalar o Frontend Linter no Windows:

  1. Faça o download e instale o Python para Windows.
  2. execute o seguinte comando:
> pip install https://github.com/google/closure-linter/zipball/master

Observação: a compatibilidade com o Windows para o Frontend Linter é experimental.

Encontre problemas de estilo

Para executar a interdição de veículo em um único arquivo, tente:

$ gjslint path/to/my/file.js

O resultado será assim:

Line 46, E:0110: Line too long (87 characters).
Line 54, E:0214: Missing description in @return tag
Line 66, E:0012: Illegal semicolon after function declaration
Line 150, E:0120: Binary operator should go on previous line "+"
Line 175, E:0011: Missing semicolon after function assigned to a variable
Line 210, E:0121: Illegal comma at end of array literal
Line 220, E:0002: Missing space before ":"

Também é possível verificar de maneira recursiva um diretório inteiro, desta forma:

$ gjslint -r path/to/my/directory

Por padrão, o Intermador de portas verifica a presença de anotações JsDoc corretas. Se você não quiser verificar as anotações JsDoc ausentes no projeto, desative a verificação desta forma:

$ gjslint --nojsdoc -r path/to/my/directory

Embora essa sinalização desative as verificações de anotações JsDoc ausentes, o linter ainda verifica se as anotações JsDoc existentes estão sendo usadas corretamente.

A sinalização --strict

Se você quiser que o Frontend Linter seja mais rigoroso com as regras de estilo, como espaçamento, tipos JsDoc e tags do autor, use a sinalização de linha de comando --strict. Use --strict se estiver contribuindo com código para a Biblioteca Interdição.

Corrigir problemas de estilo

Em qualquer um dos comandos acima, é possível substituir fixjsstyle por gjslint para corrigir automaticamente muitos dos erros verificados por gjslint.

Exemplo:

$ fixjsstyle path/to/file1.js path/to/file2.js

Faça backup dos arquivos ou armazene-os em um sistema de controle de origem antes de usar fixjsstyle, caso o script faça mudanças indesejadas.