Verificar importação de dependências
O processo Desenvolvimento > Revisão de códigos > Verificar importação de dependências tem o objetivo de analisar os arquivos importados nos códigos fontes a fim de encontrar caminhos ou chaves de arquivos que não existem mais na base de dados.
Ele também identifica o uso dos comandos “include” e “includeOnce”, recomendando a substituição deles pelas funções equivalentes “__include” e “__includeOnce”. Os comandos “include” e “includeOnce” são uma sintaxe legada implementada no runtime JavaScript Ije (padrão do Engine), mas que é inválida na linguagem ECMAScript. O uso desses comandos impossibilita que os códigos sejam executados no runtime V8 e também impede a utilização de outras ferramentas JavaScript, como o ESLint.
Importante: a função “__includeOnce” não é exatamente equivalente ao comando legado “includeOnce”. O comando “includeOnce” sempre é executado antes de qualquer outra lógica existente no script, enquanto a função “__includeOnce” inclui a dependência apenas quando a função é chamada. Para o uso normal de importar dependências, essa diferença não é significativa. No entanto, códigos que estejam usando o “includeOnce” como forma de compor lógicas isoladas em arquivos distintos não devem misturar o uso do comando “includeOnce” com a função “__includeOnce”.
Utilização
Na tela inicial do processo, é possível indicar se serão verificados os arquivos da Virtual File System ou da Union File System, além de filtros específicos para cada um desses sistemas de arquivos.
Uma vez selecionados os filtros, o processo realizará a leitura de todos os arquivos a serem analisados e usará o compilador JavaScript Ije para encontrar o uso das funções “require”, “__include” e “__includeOnce”, além dos comandos legados “include” e “includeOnce”. Este processo não permite a análise de códigos JavaScript que sejam compatíveis apenas com o runtime V8 ou códigos que serão executados por navegadores Web.
Ao final, será apresentado um relatório com todos os problemas identificados. Para os arquivos da Virtual File System, será dada a opção de abrir o arquivo no VS Code. Uma vez corrigidos os problemas identificados, o processo deve ser reexecutado para verificar se os problemas foram de fato solucionados.
Arquivos ignorados
Na classe “Configuração > Revisão de códigos” é possível criar um arquivo com extensão “.config” permitindo configurar filtros que restringem os arquivos analisados. As seguintes propriedades são aplicadas a este processo:
ignoredFileExtensionsignoredVfsFilesignoredVfsDirectoriesignoredUfsDirectories