---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Depurador de script e Log da sessão

# Depurador de script e Log da sessão {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura

O Depurador de script permite que usuários com a função script_debugger depurem o JavaScript do lado do servidor. Usuários com a função log_debugger podem usar o Log da sessão para exibir e baixar os logs necessários.{#script-debugger__script-debugger-rn-description}  
Usuários com a função script_debugger podem executar essas ações usando Depurador de script:

* Ter uma transação de depuração dedicada, que se aplica somente à sessão atual.
* Definir e remover pontos de interrupção.
* Pausar a sessão atual em um ponto de interrupção.
* Avaliar expressões durante o tempo de execução.
* Percorra o código linha por linha.
* Entre e saia de chamadas de função e método.
* Exibir o valor de variáveis locais e globais.
* Exibir o valor de variáveis privadas de fechamentos de função.
* Exibir a pilha de chamadas.
* Exiba a transação que o sistema está processando.
* Desative o depurador de script para retomar a execução de scripts pausados.
{#script-debugger__ul_fnc_tpl_bw}  
Use a guia Log da sessão para recuperar o log da sessão para regras de negócio, inclusões de script e uma IU personalizada, como ServiceNow® Espaço do agente, que tem um componente GraphQL. Usuários com a função log_debugger podem:

* Exiba os logs de sessão em uma guia separada.
* Baixe um log.
* Exibir logs para Espaço do agente.
* Especifique opções de depuração para exibir ou baixar somente os logs necessários.

{#script-debugger__ul_bhb_vjd_khb}Por padrão, 100 transações e 10.000 mensagens aparecem na guia Log da sessão. Se a contagem de transações ou mensagens exceder o valor padrão, o log da sessão será limpo e as próximas transações ou mensagens serão exibidas. Você pode configurar esta transação e a contagem de mensagens usando as preferências do usuário glide.debugger.log.transaction.count e glide.debugger.log_messages_limit, respectivamente. Para obter mais informações sobre as preferências do usuário glide.debugger.log.transaction.count e glide.debugger.log_messages_limit, consulte [Configurações de preferência do usuário](https://www.servicenow.com/docs/access?context=r_UserPreferenceSettings&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US).  
Nota:  
Habilite Log da sessão como uma guia separada com Depurador de script usando a propriedade do sistema glide.debugger.log.ui.

* A opção Página exibe logs em formulários e listas e na guia Log de sessão.
* A opção Sessão exibe logs somente na guia Log de sessão.

{#script-debugger__ul_xcx_kpd_khb}

Para obter mais informações sobre a propriedade do sistema glide.debugger.log.ui, consulte [Propriedades do sistema disponíveis](https://www.servicenow.com/docs/access?context=r_AvailableSystemProperties&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).

Quando você executa uma instrução no Console, a instrução executada é armazenada no cache do navegador. Você pode usar a tecla de seta para cima para obter a declaração anterior e a tecla de seta para baixo para obter a próxima declaração do cache do navegador. A configuração de preferência do usuário, glide.debugger.console.cached_stmt_limit, define o número de instruções armazenadas em cache em uma sessão do navegador. O valor do cache de declaração padrão é 20 e o valor máximo é 100. Você pode configurar o valor do cache de declaração nas preferências do usuário.  
Nota:  
As instruções em cache não estão disponíveis quando o cache do navegador é limpo ou quando você faz login de um navegador diferente ou de um computador diferente.  
O Depurador de script pode pausar qualquer script do lado do servidor executado em uma transação interativa, como regras de negócio, inclusões de script, ações de script ou ações de IU que exigem uma resposta para prosseguir. Se o método GlideSystem isInteractive() retornar verdadeiro ao executar o script no contexto, o Depurador de script poderá pausá-lo.  
Nota:  
Alguns objetos de script, como inclusões de script, podem ser chamados de vários contextos. Por exemplo:

* quando uma regra de negócio executa uma inclusão de script em um envio de formulário, que é uma transação interativa aguardando a mudança dos dados do formulário antes de continuar.
* quando um trabalho agendado é executado, a mesma inclusão de script, que é uma transação em segundo plano não interativa que também pode executar outros scripts simultaneamente.
{#script-debugger__ul_dqb_mk3_ckb}

Para depurar scripts do lado do cliente, você pode usar ferramentas de desenvolvedores baseadas em navegador.

Uma transação do depurador permanece aberta enquanto a sessão do usuário for válida. Se um usuário fizer logout ou a sessão expirar, o sistema fechará a transação do depurador.

Para exibir logs de depuração, consulte [Exibir logs de depuração](https://servicenow-prod.fluidtopics.net/PfE7TU3IuOu62mZ7XGrHoA#display-debugging-logs "Exibir logs de depuração de sessão para ajudar a diagnosticar problemas de script e aplicação.").  
Nota:  
Quando o Depurador de script está habilitado, o código é executado no modo interpretado. Se partes do script forem definidas para serem executadas no modo estrito, o depurador não poderá encontrar os objetos corretos e o depurador falhará. O Depurador de script deve ser executado em scripts fora do modo estrito.
* **[Rastreador de script e scripts de depuração](https://servicenow-prod.fluidtopics.net/r4Cgpk7VRfaABx5YIgykDQ)**   
  O Rastreador de script pode ajudar a filtrar sua pesquisa de depuração para restringir rapidamente os problemas de script. Você pode identificar linhas de scripts no registro do Glide que passaram por mudanças durante a execução. Encontrar essas linhas específicas de scripts em vez de fazer uma pesquisa ampla ajuda a economizar tempo e melhora a produtividade.
* **[Partes da interface do usuário](https://servicenow-prod.fluidtopics.net/KEKwXtRbFtLQN7Z5ZMW3OQ)**   
  A interface Depurador de script exibe informações sobre o conjunto de pontos de interrupção, a pilha de chamadas e o número da linha de script em execução no momento, detalhes sobre variáveis e transaçõese o status do console.
* **[Controles de console e passo a passo do Depurador de script](https://servicenow-prod.fluidtopics.net/knXhSjikNw~hhVHkJ_LYIA)**   
  Depois que o Depurador de script pausar um script, use os controles passo a passo para se mover entre as linhas de script e entre os scripts na pilha de chamadas. Use os controles do Console para expandir o console, recolher o console, limpar o console e executar novamente as expressões.
* **[Avaliar expressões no tempo de execução usando o Console](https://servicenow-prod.fluidtopics.net/TCPuzc22Y6k8k83Fwqs0LQ)**   
  Defina, declare e verifique novas variáveis e funções enquanto depura um script em tempo de execução usando o Console do. A execução do script deve ser pausada para usar o Console.
* **[Iniciar o Depurador de script](https://servicenow-prod.fluidtopics.net/PWnP1vaTmRz29vhAaDzBEA)**   
  Os desenvolvedores podem iniciar o Depurador de script no navegador de aplicações, Studioou no editor de sintaxe.
* **[Definir ou remover pontos de interrupção](https://servicenow-prod.fluidtopics.net/uOQvR6uADoKMbgBbGSb_~Q)**   
  Defina pontos de interrupção ou pontos de interrupção condicionais para pausar scripts em linhas específicas e remova pontos de interrupção quando terminar de depurá-los.
* **[Definir ou remover logpoints](https://servicenow-prod.fluidtopics.net/by6kDQzDCnA1s_16ifI9VA)**   
  Defina pontos de interrupção ou logpoints condicionais para registrar mensagens no console em linhas específicas e remova logpoints quando terminar de depurá-los.
* **[Depurador de script status](https://servicenow-prod.fluidtopics.net/ALTs6a8Iu6705RalfUotuQ)**   
  O status Depurador de script determina quais ações de depuração estão disponíveis e quais informações ele pode exibir.
* **[Detalhes da transação](https://servicenow-prod.fluidtopics.net/5xHnfTztfEYQnfClTxgxlA)**   
  O Depurador de script exibe detalhes da transação da sessão do usuário pausada atual.
* **[Detalhes da transação disponível](https://servicenow-prod.fluidtopics.net/YyNeiOK~XoXtVWmiOL0jnA)**   
  O Depurador de script fornece um conjunto padrão de detalhes de transação para os desenvolvedores depurarem e solucionarem problemas de scripts.
* **[Depurador de script suporte a vários desenvolvedores](https://servicenow-prod.fluidtopics.net/bKs7oRDLgrDzVuIJ4mZF8Q)**   
  O Depurador de script permite que vários desenvolvedores depurem suas próprias transações sem afetar um ao outro.
* **[Depurador de script suporte de representação](https://servicenow-prod.fluidtopics.net/xFXVSvnFOlYf3Jd7wQsRmQ)**   
  Você pode usar o Depurador de script ao representar outro usuário, mas somente se o usuário representado tiver a função script_debugger e tiver acesso de leitura ao script de destino.
* **[Depurador de script Scripts - Suporte em segundo plano](https://servicenow-prod.fluidtopics.net/_hKh52ggEo5536BMrTdnrQ)**   
  O módulo Scripts - Plano de fundo não é compatível com a definição de pontos de interrupção diretamente no campo de script. No entanto, você pode definir pontos de interrupção nos objetos de script chamados ou acionados pelo módulo Scripts - Plano de fundo.
* **[Separação de domínios e Depurador de script](https://servicenow-prod.fluidtopics.net/sPW1kzJA4_BGSwtkn3qLNg)**   
  Separação de domínios é compatível com Depurador de script. O Domain Separation permite separar dados, processos e tarefas administrativas em agrupamentos lógicos chamados de domínios. Você pode controlar vários aspectos dessa separação, incluindo quais usuários podem ver e acessar os dados.