---
sourceDocument: Criar ou modificar aplicações do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/application-development

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Criar ou modificar aplicações do Xanadu

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Creator


---

# Identificar e resolver erros do cliente

# Identificar e resolver erros do cliente {#ariaid-title1}

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

Identifique erros do cliente e resolva-os em scripts do lado do cliente.

## Antes de Iniciar

Função necessária: administrador

## Por Que e Quando Desempenhar Esta Tarefa

Quando ocorrem erros de cliente, o Automated Test Framework falha no teste na etapa que estava em execução quando ocorreu o erro. Embora os scripts do lado do cliente possam falhar silenciosamente em erros de JavaScript enquanto os procedimentos estão em execução, o erro ainda pode afetar os dados e o procedimento que está sendo executado. O Automated Test Framework considera esses erros como falhas de validação.

## Procedimento

1. Navegar até TodosAplicaçãoAutomated Test FrameworkTestes e execute um teste do Automated Test Framework que interage com um formulário.
2. Nos resultados de testes deste teste, verifique se há um resultado de etapa com o seguinte resumo:  
   Esta etapa falhou porque o erro do cliente "DETAILED ERROR MESSAGE" foi detectado na página que está sendo testada. Consulte Logs de teste com falha. Para ignorar esses erros na próxima simulação, use os links "Adicionar todos os erros do cliente à lista de avisos/ignorados".

   Este resultado de etapa aparece somente em uma etapa que interage com a IU.
3. Para identificar e resolver esses erros de script, abra o console do navegador das ferramentas para desenvolvedores na [página do Executor de teste do cliente](https://servicenow-prod.fluidtopics.net/pASpdvuisxh~fcqnkaGQcw "O Executor de teste do cliente abre uma janela ou guia do navegador para executar testes automatizados de cliente iniciados manualmente.").  
   Nota:  
   Para obter informações sobre como abrir o console do navegador, consulte o seguinte artigo: [http://webmasters.stackexchange.com/questions/8525/how-to-open-the-javascript-console-in-diferentes-browsers](http://webmasters.stackexchange.com/questions/8525/how-to-open-the-javascript-console-in-different-browsers)
4. Se você puder ver o erro, tente identificar e solucionar problemas do script do lado do cliente problemático, que pode estar em qualquer uma das seguintes tabelas do sistema de base:  
   * ServiceNow Client script
   * Ação de IU
   * Macro de IU (script HTML)
   * Página de IU (script HTML)
   * Política de IU
   * Script da IU
   * Tabelas que estendem as tabelas do sistema base anteriores
   {#identify-and-resolve-client-errors__ul_r4h_hn4_5cb}
5. Revise o script quanto a erros e, depois de corrigi-los, execute o teste novamente.
{#identify-and-resolve-client-errors__steps_v5j_l4f_wcb}

## O que Fazer Depois

Determine a origem do erro do cliente revisando o histórico de versões do script. Se você personalizou um script do sistema de base, é possível que o script tenha novas versões que foram ignoradas durante o upgrade.

## Exemplo de erros do cliente {#ariaid-title2}

Existem vários tipos de erros comuns do cliente.

### Erros de JavaScript do cliente {#example-client-errors__section_x54_jn4_5cb}

Quando um client script causa um erro, o console do navegador exibe um erro semelhante ao exemplo a seguir:  

    ***************************************************
    A script has encountered an error in render events
    TypeError: Cannot read property 'id' of undefined
    Script ends. Continuing happily
    ***************************************************
    [00:00:00.002] onLoad Modify Comments Label

Neste exemplo, o client script Modificar rótulo de comentários causou o erro.

### Outros erros de client script {#example-client-errors__section_knn_gmn_ldb}

Qualquer outro tipo de erro de script é relatado diretamente ao console do navegador com qualquer formatação após a ocorrência.

TypeError: retornos de chamada (ID) é indefinido

### Links de recursos de script por SYS ID {#example-client-errors__section_rps_sn4_5cb}

Em alguns casos, o erro do console fornece um link para o arquivo de recursos de script usando seu SYS ID. Seguir este link pode fornecer contexto para qual script o executou.  

    Uncaught ReferenceError: myobj is not defined
        at incident.do?sys_id=12345678901234567890123456789012
    (anonymous) @ incident.do?sys_id=12345678901234567890123456789012  <---- LINK

### Permissões de acesso ao script {#example-client-errors__section_qrq_144_5cb}

Ao identificar scripts problemáticos, certifique-se de que o script tenha permissão para acessar os dados. Verificar:

* Permissões da regra de controle de acesso para tabelas e campos.
* Permissões de acesso à aplicação se o script acessar aplicações em um escopo privado.
* Permissões de separação de domínio se a separação de domínio estiver configurada.
{#example-client-errors__ul_n33_nct_pdb}
**Conceitos relacionados**   

* [Erros de cliente permitidos](https://servicenow-prod.fluidtopics.net/F3N4qapCQHJjryFfH11XAw "Adicione erros de cliente conhecidos à lista de erros de cliente permitidos para permitir que testes e etapas continuem em execução quando ocorrer um erro específico. Defina o nível do relatório para especificar o que Automated Test Framework faz quando o erro ocorre em testes futuros.")