Como usar o linter de fechamento

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

Este documento descreve como instalar e usar o Closure Linter.

Instalar o Closure Linter

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

Linux

Para instalar o Closure 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 Closure 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 Closure 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:o suporte do Windows para o Closure Linter é experimental.

Encontrar problemas de estilo

Para executar o Closure Linter 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 um diretório inteiro de forma recursiva, assim:

$ gjslint -r path/to/my/directory

Por padrão, o Closure Linter verifica a presença de anotações JsDoc corretas. Se você não quiser verificar se há anotações JsDoc ausentes no projeto, desative a verificação assim:

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

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

A flag --strict

Se você quiser que o Closure Linter seja mais rigoroso em relação a regras de estilo, como espaçamento, tipos JsDoc e tags de autor, use a flag de linha de comando --strict. Você precisa usar --strict se estiver contribuindo com código para a Biblioteca Closure.

Corrigir problemas de estilo

Em qualquer um dos comandos acima, substitua fixjsstyle por gjslint para corrigir automaticamente muitos dos erros que gjslint verifica.

Exemplo:

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

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