JS Code Coverage Debug

A aplicação JS Code Coverage Debug permite que os administradores e desenvolvedores de aplicações registrem em log os scripts acionados durante uma sessão de usuário e, em seguida, revisem quais linhas de código o sistema executou.

Usuários com a função js_coverage_debugger podem depurar scripts sem precisar definir pontos de interrupção ou revisar as mensagens de depuração na tela. Em vez disso, o sistema salva os dados de uso do script na tabela Cobertura de código JavaScript [sys_js_code_coverage]. Cada registro de cobertura de código JavaScript contém:

• A sessão do usuário que chamou o script.
• O script registra o sistema chamado identificado pela tabela, sys_id e campo de script.
• O script registra o sistema chamado identificado por tipo e nome.
• A transação que chamou o script.
• A hora de início da transação.
• O conteúdo do campo de script realçado para indicar quais linhas o sistema executou.

Figura 1. Realce de cobertura de código de amostra

Realce de cobertura de código JS

A aplicação Cobertura de código JS realça os campos de script para indicar se o sistema executou ou ignorou cada linha.

Figura 2. Realce de código de exemplo

A cor do destaque indica como o sistema avaliou a linha de código.

Tabela 1. Significado do realce de código

Destacar cor	Significado
Verde	Esta é uma linha de código executável que o sistema executou durante a sessão.
Vermelho	Esta é uma linha de código executável que o sistema ignorou por algum motivo. O sistema pode ter ignorado uma linha de código executável porque as condições de script necessárias não foram atendidas ou porque a função de script nunca foi chamada. Você pode usar o Depurador de script para determinar por que o sistema ignorou a linha de código executável.
Cinza	Esta é uma linha de código não executável, como espaço em branco, comentário de código ou uma parte de uma expressão dividida em várias linhas que não podem ser executadas sozinhas.

Administradores e desenvolvedores de aplicações podem usar essas informações para conduzir atividades de depuração mais direcionadas, como usar o Depurador de script para determinar por que as condições do script não estão sendo atendidas.

Ativação do JS Code Coverage Debug

Você pode ativar o plug-in JS Code Coverage Debug (com.glide.js.coverage) se tiver a função de administrador.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Todos > Aplicações do sistema > Todas as aplicações disponíveis > Todos.
2. Encontre o plug-in usando os critérios de filtro e a barra de pesquisa.

   Pesquise o plug-in pelo nome ou ID. Se não conseguir encontrar um plug-in, talvez seja necessário solicitá-lo ao pessoal ServiceNow.

3. Selecione Instalar e, na caixa de diálogo Ativar plug-in, selecione Ativar.
   Nota:

   Quando a separação de domínio e o administrador delegado estão habilitados em uma instância, o usuário administrativo deve estar no domínio global. Caso contrário, será exibido o seguinte erro: A instalação do aplicativo não está disponível porque há outra operação em execução: ativação de plug-in para <plugin name>.

O que Fazer Depois

Para ver os componentes que o plug-in instalou, atualize o formulário do plug-in e selecione a lista relacionada Arquivos de plug -in.

Depurar com JS Code Coverage Debug

Use JS Code Coverage Debug para registrar uma sessão de usuário e, em seguida, revise quais scripts e linhas de código o sistema executou.

Antes de Iniciar

Função necessária: admin ou js_coverage_debugger

Procedimento

1. Navegar até Todos > Depuração de Cobertura de Código JS > Habilitar Cobertura.
   O sistema registra quais scripts e linhas de código o sistema executa, bem como exibe mensagens de depuração de sessão no namespace de cobertura de código JS.

   

2. Navegue até a tabela ou página cuja lógica você deseja testar.
   Por exemplo, navegue até Incidente > Criar novo.
3. Acione o script ou os scripts que você deseja testar.
   Por exemplo, crie um incidente com um item de IC associado para testar várias regras de negócio.
4. Ao concluir o teste, navegue até Depuração de Cobertura de Código JS > Desabilitar Cobertura.
   O sistema para de executar o script de registro em log e as linhas de código.
5. Navegar até Depuração de Cobertura de Código JS > Dados de Cobertura.
   O sistema exibe a lista de dados de cobertura associados à sessão do usuário atual.

   

6. Selecione o script ou a transação que você deseja revisar.

   Tabela 2. Campos de cobertura de código JavaScript

   Campo	Descrição
   Nome do script	Exibe o script executado por nome de tabela, valor de sys_id e campo de script.
   Referência de Script	Exibe o script executado por tipo de script e nome.
   Nome de Transação	Exibe a transação que chamou o script por ID de thread e URI.

   Por exemplo, selecione a Regra de negócios de referência de script : eventos de incidente.
   O sistema exibe o registro JS Code Coverage Debug.

   

7. Revise o campo Script para determinar quais linhas de código o sistema executou.
   Por exemplo, a regra de negócios adicionou o evento incident.inserted à fila de eventos.

Resultado

Você determina quais linhas de código o sistema executou.

O que Fazer Depois

Use as informações de cobertura de código para realizar atividades de depuração mais direcionadas, como definir pontos de interrupção e revisar valores de variáveis com Depurador de script.