Scripts de verificação avançada de linter
Os scripts de verificação do Linter ajudam você a escrever verificações que procuram problemas em scripts. Quando uma verificação de linter é executada em um registro, ela fornece uma árvore de sintaxe abstrata para seu código. Você pode usar esta árvore de sintaxe abstrata para analisar problemas com o código, como muitas instruções "if" aninhadas ou usos de API lenta em um loop "While".
Uso de verificação linter
As verificações de linter têm um objeto exclusivo para usar chamado rootNode. Este é o nó raiz da árvore de sintaxe abstrata analisada (AST) para o script do registro atual. Este objeto tem muitas funções, mas a função de visita é a mais importante. A função de visita usa uma função de retorno de chamada como um parâmetro que é chamado em cada nó da árvore. A função de retorno de chamada usa um nó como um parâmetro que representa o nó atual durante sua iteração. Você pode retornar falso da função de retorno de chamada para parar de iterar a árvore mais cedo, caso contrário, ela continuará visitando todos os subnós na árvore do nó em que você solicitou a visita.
BadFunction(). Você pode gravar uma verificação de linter com um script no exemplo a seguir:(function(engine) {
engine.rootNode.visit(function(node) {
if (node.getTypeName() === "NAME" &&
node.getNameIdentifier() === "badFunction" &&
node.getParent().getTypeName() === "CALL") {
engine.finding.incrementWithNode(node);
}
});
})(engine);Quando você executa uma verificação com esta Verificação de Linter, ela verifica todos os registros na verificação com um campo de script. Por exemplo, se um registro nessa verificação tiver um script semelhante ao seguinte, a verificação selecionará uma descoberta para esse registro./*
badFunction()
*/
// badFunction()
function badFunction() {
return;
}
var GoodClass = Class.create();
GoodClass.prototype = Object.extendsObject(Object, {
badFunction: function() {
// actually good
}
});
var badFunction = ["badFunction", "badFunction()"];
badFunctionButSometimesGood();
badFunction();
Funções do nó
getRootNode(): obtém o nó raiz da árvore para este nógetParent(): obtém o primário deste nógetLineNo(): obtém o local do número de linha deste nógetColumnNo(): obtém o local do número da coluna deste nótoSource(): obtenha a origem deste nó. A origem é baseada neste nó e em seus secundáriosgetTypeName(): obtenha o nome do tipo de nó deste nó. Por exemplo, uma chamada de função na origem é tokenizada como um nó com o nome do tipo "CALL"Nota:Os valores denode.getTypeName()são de diferentes tipos de nós em uma árvore de sintaxe abstrata (AST). Os valores possíveis vêm do próprio analisador AST do Rhino.getNameIdentifier(): se o tipo de nó deste nó for "NAME", retorne o identificador, que é o valor da cadeia de caracteres do próprio nome. Um nó "NAME" representa um nome simples que não é uma palavra-chave, como um nome de função ou um nome de variável.Nota:Se este nó não for um nó NAME, o resultado será nulo.getAbsolutePosition(): obtém a posição absoluta deste nó. A posição absoluta é o número de caracteres desde o início do script até este nócompareTo(outro): compara este nó com outro nó. O nó com uma posição absoluta e comprimento maiores será o maior em comparação.outroé um nó a ser comparado com este nóvisit(callbackFunction): visite cada nó na subárvore a partir deste nó e execute a função de retorno de chamada fornecida em cada nó.callbackFunctioné uma função que será executada em cada nó na subárvore deste nó. Esta função de retorno de chamada usa um LinterCheckAstNode como um parâmetro que será o nó que está sendo visitadodebugPrint(): retorna uma representação de cadeia de caracteres da árvore de sintaxe abstrata, começando a partir deste nó. Cada linha contém informações sobre um nó e o recuo representa o relacionamento de hierarquia entre os nós. As informações em cada linha são organizadas da seguinte forma- Posição absoluta
- Nome do tipo de nó
- Posição relativa ao primário
- Comprimento
- Identificador de nome (se for um nó NAME)