JS Code Coverage Debug

. JS Code Coverage Debug a aplicação permite que os administradores e desenvolvedores de aplicações registrem os scripts do lado do servidor acionados durante uma sessão do 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 do lado do servidor 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 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 por tabela, sys_id e campo de script.
• O registro de script que o sistema chamou 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.

Nota:

. JS Code Coverage Debug a aplicação não registra informações para scripts do lado do cliente.

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

Destaque de cobertura do código JS

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

Figura 2. Destaque de código de amostra

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

Tabela 1. Destaque de código

Cor de realce	Significado
Verde	Esta é uma linha executável de código que o sistema executou durante a sessão.
Vermelho	Esta é uma linha executável de código que o sistema ignorou por algum motivo. O sistema pode ter ignorado uma linha executável de código porque as condições de script necessárias não foram atendidas ou porque a função de script nunca foi chamada. Você pode querer usar o. Depurador de script 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 por conta própria.

Os 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 determinar por que as condições de script não estão sendo atendidas.

Ativar JS Code Coverage Debug

Você pode ativar o. JS Code Coverage Debug plug-in (com.glide.js.coverage) se você 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 global domínio. 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 que o plug-in instalou, atualize o formulário do plug-in e selecione Arquivos de plug-in lista relacionada.

Depurar com JS Code Coverage Debug

Usar JS Code Coverage Debug para registrar uma sessão do usuário e revisar quais scripts do lado do servidor e linhas de código o sistema executou.

Antes de Iniciar

Função necessária: js_coverage_debugger ou admin

Procedimento

1. Navegar até Tudo > Depuração de Cobertura de Código JS > Habilitar Cobertura.
   O sistema registra em log quais scripts do lado do servidor 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(a).
3. Acione o script do lado do servidor 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ócios.
4. Ao concluir o teste, navegue até Depuração de Cobertura de Código JS > Desabilitar Cobertura.
   O sistema interrompe a execução de script 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 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 Referência de script Regra de negócio: Eventos de incidente.
   O sistema exibe o. JS Code Coverage Debug registro.

   

7. Revise Script campo 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 fazer atividades de depuração mais direcionadas, como definir pontos de interrupção e revisar valores de variáveis com Depurador de script.