JS Code Coverage Debug

A aplicação JS Code Coverage Debug permite que administradores e desenvolvedores de aplicações registrem em log os scripts acionados durante uma sessão do usuário e 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 mensagens de depuração na tela. Em vez disso, o sistema salva os dados de uso de 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 convocou 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 convocou 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

Destaque 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 realce indica como o sistema avaliou a linha de código.

Tabela 1. Significado do realce de código

Realçar 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 pode ser executada sozinha.

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 de 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é Tudo > Aplicações do sistema > Todas as aplicações disponíveis > Tudo.
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 para iniciar o processo de instalação.
   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 da aplicação não está disponível porque há outra operação em execução: ativação de plug-in para <plugin name>.

   Você verá uma mensagem após a conclusão da instalação. Para obter informações sobre os componentes instalados com um plug-in, consulte Localizar componentes instalados com uma aplicação.

O que Fazer Depois

Para ver os componentes instalados pelo plug-in, 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 revisar 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é Tudo > 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 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. Quando concluir os testes, navegue até Depuração de Cobertura de Código JS > Desabilitar Cobertura.
   O sistema interrompe a execução das linhas de script e código de registro em log.
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 pelo nome da tabela, valor 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 convocou o script por ID de thread e URI.

   Por exemplo, selecione a Regra de negócio 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ócio 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 o Depurador de script.