Console - Escopo, Global

. Console A API fornece métodos para registrar mensagens no log do sistema, criar e parar temporizadores, criar e registrar contadores, rastrear rastreamentos de pilha e agrupar/organizar conteúdo relacionado.

Console Os métodos de API fornecem a mesma funcionalidade de registro em log do API do sistema Glide (por exemplo, gs.info, gs.warn e gs.debug), mas permitem um uso mais reflexivo para desenvolvedores que estão familiarizados com mensagens de registro em log usando métodos de console. Ambos Console API e. Sistema Glide Os métodos de API podem ser usados no servidor.

Todos Console Os métodos de API são estáticos e são A. ServiceNow® Implementação de MDN (Microsoft Developer Network) Console API . Esta API é fornecida como parte do ServiceNow sistema de base e não requer um plug-in para acessá-lo globalmente. Para usar esta classe em uma aplicação com escopo, use sn_console identificador de namespace. Habilite o plug-in Console (com.glide.console) para acessar o. Console API.

Recursos de registro em log

Logs gerados usando Console Métodos de API, como assert() , erro () , depurar() , aviso() , informação() e log() São registrados nos Logs do sistema. Especificamente, você pode encontrar Logs do sistema na IU navegando até Tudo > Logs do sistema > Log do Sistema. Você pode optar por exibir todos os logs ou tipos de log específicos, como Logs de aplicações, Erros, Declarações de log de script e assim por diante neste item de menu. Filtrando a coluna Origem no Todos a exibição de logs pode ajudar a localizar suas entradas mais rapidamente.

Substituições de cadeia de caracteres

Você pode usar zero ou mais cadeias de caracteres de substituição como o primeiro parâmetro em muitos Console Métodos de API, especialmente aqueles que permitem registrar mensagens como assert() , erro () , depurar() , aviso() , informação() e log() .

Cadeias de caracteres de substituição no Console As APIs são espaços reservados que você usa em uma mensagem de log para inserir valores dinamicamente, como cadeias de caracteres ou números. Quando o código é executado, esses espaços reservados são substituídos por valores reais que você passa como argumentos adicionais, na ordem em que são fornecidos. Eles tornam seus logs mais flexíveis e legíveis sem a necessidade de concatenar cadeias de caracteres manualmente.

Cadeias de caracteres de substituição comuns:

• %s : Insere uma cadeia de caracteres.
• %d ou %i Insere um número (inteiro ou decimal).
• %f Insere um número de ponto flutuante.
• %o : Insere um objeto.
• %c Aplica estilos CSS ao log (útil para estilizar a saída do console).

Aqui está um exemplo de script simples usando cadeias de caracteres de substituição:

const name = "Alex";
const age = 25;

console.log("Hello, my name is %s and I am %d years old.", name, age);

Saída de exemplo:

Hello, my name is Alex and I am 25 years old.

Este é um exemplo usando cadeias de caracteres de substituição com estilo CSS:

const user = { name: "Alex", role: "Developer" };
console.log("User info: %o", user); // Logs the object
console.log("%cStyled message", "color: blue; font-weight: bold;"); // Adds styles

A saída estiliza a mensagem Nome: "Alex", função: "Desenvolvedor" em azul e negrito.

Usando temporizadores

Você pode usar Console Temporizadores de API para calcular a duração de uma operação específica. Para iniciar um temporizador, ligue Console - Hora (rótulo de cadeia de caracteres) e atribua um nome a ele usando labelparâmetro. Você pode ter no máximo 10 000 temporizadores por página. Para parar um temporizador e obter o tempo decorrido em milissegundos, chame Console - timeEnd (rótulo de cadeia de caracteres) passando o nome do temporizador como o parâmetro.

Por exemplo, você pode iniciar um temporizador para medir a quantidade de tempo que passa pela chamada Tempo ("Duração do processo") e, em seguida, chamar TimeEnd("Duração do processo") . Além disso, o código calcula e gera quanto tempo passou desde o início do temporizador e quando a primeira e a segunda ações foram concluídas pela aprovação Console - timeLog (rótulo de cadeia de caracteres, valor do objeto) no script.

console.time("Process Duration");

alert("Step 1: Click to continue."); // Simulates the first action
console.timeLog("Process Duration", "After Step 1");

alert("Step 2: Do other actions"); // Simulates additional actions
console.timeLog("Process Duration", "After Step 2");

console.timeEnd("Process Duration");

Saída:

• Após o primeiro alerta:

  Process Duration: 2.345ms After Step 1

• Após o segundo alerta:

  Process Duration: 7.890ms After Step 2

• Quando o temporizador terminar:

  Process Duration: 10.123ms

Assert (asserção booliana, objeto val1...valN, cadeia de caracteres msg, cadeia de caracteres subst1...substN)

Registra uma mensagem de erro nos logs do sistema se a asserção for falsa. Este método não faz nada se a asserção for verdadeira.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
declaração	Booliano	Opcional. Sinalizador que indica se uma mensagem genérica deve ser registrada em log indicando uma falha de declaração nos logs do sistema. Valores válidos: Verdadeiro: Não registra a mensagem de falha de declaração. Falso: Registra em log a mensagem de falha de declaração. Padrão: falso
msg	Cadeia de caracteres	Necessário se val1...valNnão é usado. Mensagem a ser exibida nos logs do sistema quando a declaração falhar. Aceita uma cadeia de caracteres que contém zero ou mais valores de substituição que podem ser definidos usando subst1 through substNparâmetro. Para obter mais informações, consulte "Substituições de cadeia de caracteres", consulte Console - Escopo, Global.
Subst1...substN	Cadeia de caracteres	Opcional. Valores JavaScript pelos quais substituir cadeias de caracteres de substituição msg. Esses valores são registrados ou exibidos na ordem em que são especificados. Se houver mais valores de substituição do que cadeias de caracteres de substituição, os próprios valores extras gravados serão anexados após a mensagem ( msgda mesma maneira que quando não há cadeia de caracteres de formato. Consulte "Uso de cadeias de caracteres de substituição" em Console - Escopo, Global para obter mais informações.
Val1...valN	Objeto	Necessário se msgnão foi aprovado. Lista de valores JavaScript adicionais a serem anexados após a mensagem principal ( msge são separados por um espaço ou outro delimitador. Aceita qualquer tipo de dados JavaScript, incluindo cadeias de caracteres ou objetos, e os gera na ordem em que são especificados.

Tabela 2. Retornos

Tipo	Descrição
Nenhum(a)

Asserção básica

O exemplo a seguir mostra como usar assert() Para registrar a mensagem de erro "Math is broken!" quando a asserção (1 mais 1: 3) é falsa, e não faz nada quando a asserção (1 mais 1: 2) é verdadeira.

console.assert(1 + 1 === 2, "This won't be logged."); // Assertion is true, nothing happens.
console.assert(1 + 1 === 3, "Math is broken!");

Saída:

"Math is broken!"

Registrar valores adicionais em log

O exemplo a seguir é aprovado assert() com valores adicionais.

let x = 5, y = 10;
console.assert(x + y === 20, "Expected 20, got", x + y);

Saída:

"Expected 20, got 15" // (because x + y is 15)

Substituição de mensagem

O exemplo a seguir é aprovado assert() com valores de substituição de cadeia de caracteres.

let expected = 20, actual = 15;
console.assert(expected === actual, "Expected %d but got %d", expected, actual);

Saída:

"Expected 20 but got 15"

Console - count (rótulo de cadeia de caracteres)

Conta e registra em log o número de vezes que contagem() foi chamado com um rótulo especificado.

. contagem() o método é útil para rastrear o número de vezes que algo ocorre, como quantas vezes um bloco de código é executado ou quantos eventos ocorrem em uma aplicação. Usar Console - countReset (rótulo de cadeia de caracteres) para redefinir um contador com um rótulo específico.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
rótulo	Cadeia de caracteres	Opcional. Nome a ser fornecido ao contador. Os rótulos diferenciam maiúsculas de minúsculas e geram contadores diferentes na saída se os casos não corresponderem. Padrão: Se não fornecido, define o rótulo como "Padrão".

Tabela 4. Retornos

Tipo	Descrição
Nenhum(a)

O exemplo a seguir demonstra como a saída é exibida sempre que contagem() o método é chamado com um rótulo (por exemplo, "maçã" ou "banana"). A contagem é rastreada separadamente para cada rótulo.

console.count('apple');
console.count('banana');
console.count('apple');
console.count('apple');
console.count('banana');

Saída:

apple: 1
banana: 1
apple: 2
apple: 3
banana: 2

A seguir contagem() o exemplo demonstra como a saída aparece quando um rótulo de contador não é fornecido, herdando um rótulo de "padrão".

console.count();
console.count();
console.count();

Saída:

default: 1
default: 2
default: 3

Console - countReset (rótulo de cadeia de caracteres)

Redefine o contador especificado como zero.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
rótulo	Cadeia de caracteres	Opcional. Nome do contador definido originalmente no Console - count (rótulo de cadeia de caracteres) método que você deseja redefinir como zero. Distinção entre maiúsculas e minúsculas. Padrão: Redefine o. padrão contador a zero. Nota: Um contador recebe um rótulo de padrão quando um novo contador é definido usando contagem() sem um rótulo definido. Consulte Console - count (rótulo de cadeia de caracteres) para obter mais detalhes.

Tabela 6. Retornos

Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como redefinir o contador associado à quinta iteração do rótulo padrão:

function greet(user) {
  console.count();
  return 'hi ${user}'
}

greet("bob");
greet("alice");
greet("alice");
console.count();
console.countReset();

Saída:

"default: 1"
"default: 2"
"default: 3"
"default: 4"
"default: 0"

No exemplo a seguir, se você passar usuário variável como rótulo argumento com a cadeia de caracteres "bob" para a primeira invocação de console.count() e a cadeia de caracteres "alice" para o segundo:

function greet(user) {
  console.count(user);
  return'hi ${user}'
}

greet("bob");
greet("alice");
greet("alice");
console.countReset("bob");
console.count("alice");

Saída. Redefinir o valor do contador "bob" só muda o valor desse contador. O valor de "alice" permanece inalterado.

"bob: 1"
"alice: 1"
"alice: 2"
"bob: 0"
"alice: 3"

Console - DEBUG(Object val1...valN, cadeia de caracteres msg, cadeia de caracteres subst1...substN)

Registra ou gera uma mensagem de depuração para o log do sistema no nível de depuração.

. depurar() o método permite envio de mensagens detalhadas e é recomendado para mensagens de depuração de baixa prioridade ou menos críticas. Para mensagens de depuração de prioridade mais alta, use Log(Object val1...val2, cadeia de caracteres msg, cadeia de caracteres subst1...subst2). Por exemplo, você pode usar este método para gravar mensagens de depuração mais longas para desenvolvedores internos sobre estados ou fluxos internos. . depurar() as mensagens de método podem se comportar de forma diferente entre determinados navegadores.

. console.debug() o método registra mensagens em log nos logs do sistema no ServiceNow® instância. Você pode exibir esses logs no ServiceNow® plataforma em Logs do sistema > Ou Logs do sistema > Depurar.

Nota:

Console Os métodos de API fornecem a mesma funcionalidade de registro em log do API do sistema Glide (por exemplo, gs.info, gs.warn e gs.debug), mas permitem um uso mais reflexivo para desenvolvedores que estão familiarizados com mensagens de registro em log usando métodos de console. Ambos Console API e. Sistema Glide Os métodos de API podem ser usados no servidor.

Tabela 7. Parâmetros

Nome	Tipo	Descrição
msg	Cadeia de caracteres	Necessário se val1...valNnão foi aprovado. A mensagem ou objeto principal que você deseja registrar em log nos logs do sistema ou na saída. Aceita uma cadeia de caracteres que contém zero ou mais valores de substituição que podem ser definidos usando subst1 through substNparâmetro. Consulte "Uso de cadeias de caracteres de substituição" em Console - Escopo, Global para obter mais informações.
Subst1...substN	Cadeia de caracteres	Opcional. Valores JavaScript pelos quais substituir cadeias de caracteres de substituição msg. Esses valores são registrados ou exibidos na ordem em que são especificados. Se houver mais valores de substituição do que cadeias de caracteres de substituição, os próprios valores extras gravados serão anexados após a mensagem ( msgda mesma maneira que quando não há cadeia de caracteres de formato. Consulte "Uso de cadeias de caracteres de substituição" em Console - Escopo, Global para obter mais informações.
Val1...valN	Objeto	Necessário se msgnão foi aprovado. Lista de valores JavaScript adicionais a serem anexados após a mensagem principal ( msge são separados por um espaço ou outro delimitador. Aceita qualquer tipo de dados JavaScript, incluindo cadeias de caracteres ou objetos, e os gera na ordem em que são especificados.

Tabela 8. Retornos

Tipo	Descrição
Nenhum(a)

No exemplo a seguir, console.debug() registra mensagens em logs do sistema no ServiceNow® instância.

(function executeRule(current, previous /*null when async*/) {
    // Logging at different levels for debugging
    console.debug("Business rule triggered for record: " + current.getDisplayValue());
    
    // Example: Check and log a field value
    if (current.priority == 1) {
        console.debug("High-priority incident detected: " + current.number);
    } else {
        console.debug("Incident priority is not high. Priority: " + current.priority);
    }

    // Perform some logic
    if (current.state == 1) {
        current.state = 2;
        gs.debug("State updated from 'New' to 'In Progress' for record: " + current.number);
    }
})(current, previous);

Console - ERROR(Objeto val1...valN, cadeia de caracteres msg, cadeia de caracteres subst1...subsN)

Registra uma mensagem no log do sistema no nível de erro.

Usar erro () para registrar problemas críticos e que precisam de atenção imediata, como entradas inválidas, operações com falha ou depurar comportamentos inesperados.

Nota:

Console Os métodos de API fornecem a mesma funcionalidade de registro em log do API do sistema Glide (por exemplo, gs.info, gs.warn e gs.debug), mas permitem um uso mais reflexivo para desenvolvedores que estão familiarizados com mensagens de registro em log usando métodos de console. Ambos Console API e. Sistema Glide Os métodos de API podem ser usados no servidor.

Tabela 9. Parâmetros

Nome	Tipo	Descrição
msg	Cadeia de caracteres	Necessário se val1...valNnão foi aprovado. A mensagem ou objeto principal que você deseja registrar em log nos logs do sistema ou na saída. Aceita uma cadeia de caracteres que contém zero ou mais valores de substituição que podem ser definidos usando subst1 through substNparâmetro. Consulte "Uso de cadeias de caracteres de substituição" em Console - Escopo, Global para obter mais informações.
Subst1...substN	Cadeia de caracteres	Opcional. Valores JavaScript pelos quais substituir cadeias de caracteres de substituição msg. Esses valores são registrados ou exibidos na ordem em que são especificados. Se houver mais valores de substituição do que cadeias de caracteres de substituição, os próprios valores extras gravados serão anexados após a mensagem ( msgda mesma maneira que quando não há cadeia de caracteres de formato. Consulte "Uso de cadeias de caracteres de substituição" em Console - Escopo, Global para obter mais informações.
Val1...valN	Objeto	Necessário se msgnão foi aprovado. Lista de valores JavaScript adicionais a serem anexados após a mensagem principal ( msge são separados por um espaço ou outro delimitador. Aceita qualquer tipo de dados JavaScript, incluindo cadeias de caracteres ou objetos, e os gera na ordem em que são especificados.

Tabela 10. Retornos

Tipo	Descrição
Nenhum(a)

No exemplo a seguir, erro () a saída exibe o seguinte código, respectivamente:

• O primeiro exemplo simplesmente exibirá "Ocorreu um erro!" em um formato com estilo de erro.
• O segundo exibirá "Erro no módulo: ModuleName".
• O terceiro exibirá "Valor inesperado: 42".

console.error("An error occurred!");
console.error("Error in module:", "ModuleName");
console.error("Unexpected value: %d", 42);

Grupo (rótulo de cadeia de caracteres)

Cria um novo grupo em linha no log do sistema, em que todas as mensagens subsequentes são recuadas em um nível adicional até GroupEnd() é chamado. Use este método para organizar e agrupar visualmente mensagens relacionadas em logs de saída e do sistema.

Para encerrar um agrupamento, chame Console - groupEnd() método. O método groupEnd() também diminui o recuo do grupo em um nível.

Nota:

grupo() mostra todos os níveis de agrupamento na saída e não são recolhíveis ou expansíveis.

Tabela 11. Parâmetros

Nome	Tipo	Descrição
rótulo	Cadeia de caracteres	Opcional. Nome do rótulo para o grupo a ser exibido na saída. Padrão: Se você não passar um rótulo, grupo() não gera texto, mas ainda recua a nova linha vazia em um nível.

Tabela 12. Retornos

Tipo	Descrição
Nenhum(a)

O exemplo a seguir é aprovado log() para criar um novo bloco aninhado e, em seguida grupo() para registrar grupos recuados em log. Cada chamada subsequente para grupo() recua a linha em um novo nível. O script também chama GroupEnd() para encerrar cada grupo e diminuir seu recuo em um nível.

console.log("Start logging...");
console.group("Group 1");
console.log("Inside Group 1 - Message 1");
console.log("Inside Group 1 - Message 2");
console.group("Nested Group");
console.log("Inside Nested Group - Message 1");
console.groupEnd();
console.log("Back to Group 1 - Message 3");
console.groupEnd();
console.log("End logging...");

Exibição/saída:

Start logging...
    Group 1
        Inside Group 1 - Message 1
        Inside Group 1 - Message 2
            Nested Group
                Inside Nested Group - Message 1
        Back to Group 1 - Message 3
End logging...

O exemplo a seguir demonstra como os grupos são recuados quando um rótulo de grupo é definido:

console.group("Group 1");
console.log("in group 1");
console.group();
console.log("in group 2");

Saída:

Group 1
  in group 1
     in group 2

O exemplo a seguir demonstra como os grupos são recuados quando um rótulo de grupo não está definido:

console.group(); // no label passed
console.log("in group 1");
console.group();
console.log("in group 2");

Saída:

in group 1

     in group 2

Console - groupEnd()

Sai do grupo em linha atual criado com grupo() e diminui o recuo em um nível.

Tabela 13. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 14. Retorna

Tipo	Descrição
Nenhum(a)

O exemplo a seguir cria um novo bloco aninhado chamando grupo() para registrar em log os níveis recuados. O script é aprovado GroupEnd() para encerrar o grupo e diminuir seu recuo em um nível.

console.log("This is the outer level");
console.group();
console.log("Level 2");
console.group();
console.log("Level 3");
console.warn("More of level 3");
console.groupEnd();
console.log("Back to level 2");
console.groupEnd();
console.log("Back to the outer level");

Saída:

This is the outer level
    Level 2
        Level 3
        ⚠️ More of level 3
    Back to level 2
Back to the outer level

Console - INFO(Object val1...valN, cadeia de caracteres msg, cadeia de caracteres subst1...substN)

Registra uma mensagem nos logs do sistema no nível de informações.

Nota:

Console Os métodos de API fornecem a mesma funcionalidade de registro em log do API do sistema Glide (por exemplo, gs.info, gs.warn e gs.debug), mas permitem um uso mais reflexivo para desenvolvedores que estão familiarizados com mensagens de registro em log usando métodos de console. Ambos Console API e. Sistema Glide Os métodos de API podem ser usados no servidor.

Tabela 15. Parâmetros

Nome	Tipo	Descrição
msg	Cadeia de caracteres	Necessário se val1...valNnão foi aprovado. A mensagem ou objeto principal que você deseja registrar em log nos logs do sistema ou na saída. Aceita uma cadeia de caracteres que contém zero ou mais valores de substituição que podem ser definidos usando subst1 through substNparâmetro. Consulte "Uso de cadeias de caracteres de substituição" em Console - Escopo, Global para obter mais informações.
Subst1...substN	Cadeia de caracteres	Opcional. Valores JavaScript pelos quais substituir cadeias de caracteres de substituição msg. Esses valores são registrados ou exibidos na ordem em que são especificados. Se houver mais valores de substituição do que cadeias de caracteres de substituição, os próprios valores extras gravados serão anexados após a mensagem ( msgda mesma maneira que quando não há cadeia de caracteres de formato. Consulte "Uso de cadeias de caracteres de substituição" em Console - Escopo, Global para obter mais informações.
Val1...valN	Objeto	Necessário se msgnão foi aprovado. Lista de valores JavaScript adicionais a serem anexados após a mensagem principal ( msge são separados por um espaço ou outro delimitador. Aceita qualquer tipo de dados JavaScript, incluindo cadeias de caracteres ou objetos, e os gera na ordem em que são especificados.

Tabela 16. Retornos

Tipo	Descrição
Nenhum(a)

O exemplo a seguir usa informação() método para registrar em log duas informações: o número do registro e a prioridade do formulário atual. Este método é útil para verificações rápidas ao depurar ou verificar dados no formulário.

function onLoad() {
    console.info("Form loaded for record:", g_form.getValue("number")); // Log the record number
    console.info("Current priority is:", g_form.getValue("priority"));  // Log the priority
}

Log(Object val1...val2, cadeia de caracteres msg, cadeia de caracteres subst1...subst2)

Registra uma mensagem nos logs do sistema.

Nota:

Console Os métodos de API fornecem a mesma funcionalidade de registro em log do API do sistema Glide (por exemplo, gs.info, gs.warn e gs.debug), mas permitem um uso mais reflexivo para desenvolvedores que estão familiarizados com mensagens de registro em log usando métodos de console. Ambos Console API e. Sistema Glide Os métodos de API podem ser usados no servidor.

Tabela 17. Parâmetros

Nome	Tipo	Descrição
msg	Cadeia de caracteres	Necessário se val1...valNnão foi aprovado. A mensagem ou objeto principal que você deseja registrar em log nos logs do sistema ou na saída. Aceita uma cadeia de caracteres que contém zero ou mais valores de substituição que podem ser definidos usando subst1 through substNparâmetro. Consulte "Uso de cadeias de caracteres de substituição" em Console - Escopo, Global para obter mais informações.
Subst1...substN	Cadeia de caracteres	Opcional. Valores JavaScript pelos quais substituir cadeias de caracteres de substituição msg. Esses valores são registrados ou exibidos na ordem em que são especificados. Se houver mais valores de substituição do que cadeias de caracteres de substituição, os próprios valores extras gravados serão anexados após a mensagem ( msgda mesma maneira que quando não há cadeia de caracteres de formato. Consulte "Uso de cadeias de caracteres de substituição" em Console - Escopo, Global para obter mais informações.
Val1...valN	Objeto	Necessário se msgnão foi aprovado. Lista de valores JavaScript adicionais a serem anexados após a mensagem principal ( msge são separados por um espaço ou outro delimitador. Aceita qualquer tipo de dados JavaScript, incluindo cadeias de caracteres ou objetos, e os gera na ordem em que são especificados.

Tabela 18. Retornos

Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como usar log() para registrar o número do registro e o estado atual do formulário nos logs do sistema.

function onLoad() {
    console.log("Form loaded for record:", g_form.getValue("number")); // Log the record number
    console.log("Current state is:", g_form.getValue("state")); // Log the state
}

Console - Hora (rótulo de cadeia de caracteres)

Inicia um temporizador que você pode usar para rastrear quanto tempo uma operação leva.

Cada temporizador pode ser atribuído um nome exclusivo a cada temporizador e pode ter até 10 000 temporizadores em execução em uma determinada página. Quando você liga para Console timeEnd() método com o mesmo nome de rótulo, o contador gera o tempo em milissegundos decorrido desde que o temporizador foi iniciado. Use TimeLog do console() método para registrar o tempo decorrido capturado entre a hora de início e de término do temporizador.

Para obter exemplos sobre como usar este método com outros baseados em tempo Console Métodos de API, consulte "Uso de temporizadores" em Console - Escopo, Global.

Tabela 19. Parâmetros

Nome	Tipo	Descrição
rótulo	Cadeia de caracteres	Opcional. Nome a ser fornecido ao novo temporizador. Use o mesmo nome ao chamar Console - timeEnd (rótulo de cadeia de caracteres) para parar o temporizador e enviar o tempo decorrido para o console. Número máximo de temporizadores: 10 000 Padrão: Usa o rótulo "padrão" se omitido.

Tabela 20. Retornos

Tipo	Descrição
Nenhum(a)

A seguir, é mostrado como usar tempo ("rótulo") para iniciar um temporizador com o rótulo "rótulo". . Console.timeEnd("rótulo") o método interrompe o temporizador com o mesmo rótulo e registra o tempo decorrido. Neste exemplo, ele mede o tempo necessário para recuperar e registrar em log o número e a prioridade do registro.

function onLoad() {
    console.time("Form load processing time"); // Start timing

    // Example: Simulate some processing
    var recordNumber = g_form.getValue("number");
    console.log("Record number is:", recordNumber);

    var priority = g_form.getValue("priority");
    console.log("Priority is:", priority);

    console.timeEnd("Form load processing time"); // End timing and log duration
}

Console - timeEnd (rótulo de cadeia de caracteres)

Interrompe um temporizador especificado que foi iniciado anteriormente pela chamada tempo () .

Para obter exemplos sobre como usar este método com outros baseados em tempo Console Métodos de API, consulte "Uso de temporizadores" em Console - Escopo, Global.

Tabela 21. Parâmetros

Nome	Tipo	Descrição
rótulo	Cadeia de caracteres	Opcional. Nome do temporizador a ser interrompido. Uma vez interrompido, o tempo decorrido é exibido automaticamente no console junto com um indicador de que a hora terminou. Este rótulo deve corresponder ao temporizador especificado em Console - Hora (rótulo de cadeia de caracteres) labelo parâmetro e diferencia maiúsculas de minúsculas. Padrão: Se omitido, usa o rótulo "padrão" .

Tabela 22. Retornos

Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como usar tempo ("rótulo") para iniciar um temporizador com o rótulo "rótulo". . Console.timeEnd("rótulo") o método interrompe o temporizador com o mesmo rótulo; console.log() registra o tempo decorrido. Neste exemplo, ele mede o tempo necessário para recuperar e registrar em log o número e a prioridade do registro nos logs do sistema.

function onLoad() {
    console.time("Form load processing time"); // Start timing

    // Example: Simulate some processing
    var recordNumber = g_form.getValue("number");
    console.log("Record number is:", recordNumber);

    var priority = g_form.getValue("priority");
    console.log("Priority is:", priority);

    console.timeEnd("Form load processing time"); // End timing and log duration
}

Console - timeLog (rótulo de cadeia de caracteres, valor do objeto)

Registra o valor atual de um temporizador especificado no log do sistema.

Para obter exemplos sobre como usar este método com outros baseados em tempo Console Métodos de API, consulte "Uso de temporizadores" em Console - Escopo, Global.

Tabela 23. Parâmetros

Nome	Tipo	Descrição
rótulo	Cadeia de caracteres	Opcional. Nome do temporizador a ser registrado no console. Deve corresponder ao temporizador especificado em Console - Hora (rótulo de cadeia de caracteres) labelo parâmetro e diferencia maiúsculas de minúsculas. Padrão: Usa o rótulo "padrão" se omitido.
ValN	Objeto	Opcional. Valores adicionais a serem registrados após a saída do temporizador. Aceita um objeto não estruturado que oferece suporte a qualquer tipo de dados com tratamento especial para cadeias de caracteres.

Tabela 24. Retornos

Tipo	Descrição
Nenhum(a)

O exemplo a seguir demonstra como chamar TimeLog() usando o valor do rótulo de um temporizador iniciado anteriormente usando tempo () método. . TimeLog() o método registra em log o valor atual de um temporizador.

console.time("reticulating splines");
reticulateSplines();
console.timeLog("reticulating splines");
// reticulating splines: 650ms

Se o nome do temporizador for omitido, o temporizador será nomeado "padrão" :

console.time();reticulateSplines();
console.timeLog();// default: 780ms

Se não houver temporizador correspondente, Console.timeLog() registra um aviso como:

Timer "timer name" doesn't exist.

Você pode registrar valores adicionais no console após a saída do temporizador:

console.time();reticulateSplines();
console.timeLog("default","Hello","world");// default: 780ms Hello world

Em outro exemplo, Console.Time('Temporizador') Inicia um temporizador com o rótulo "Temporizador". Console.timeLog('Temporizador') registra o tempo decorrido junto com mensagens adicionais opcionais. Console.timeEnd('Temporizador') interrompe o temporizador e registra o tempo total decorrido.

console.time('Timer');

setTimeout(() => {
    console.timeLog('Timer', 'Halfway done');
}, 1000);

setTimeout(() => {
    console.timeLog('Timer', 'Almost done');
    console.timeEnd('Timer');
}, 2000);

Saída de log:

Timer: 1000ms Halfway done
Timer: 2000ms Almost done
Timer: 2000ms

Rastreamento (objetos de objeto)

Registra um rastreamento de pilha no log do sistema no nível de informações.

Tabela 25. Parâmetros

Nome	Tipo	Descrição
objetos	Objeto	Opcional. Zero ou mais objetos para saída para o console junto com o rastreamento. Os objetos são montados e formatados da mesma forma que seriam se passados para Log(Object val1...val2, cadeia de caracteres msg, cadeia de caracteres subst1...subst2) método. Padrão: Retorna a pilha inteira na saída.

Tabela 26. Retornos

Tipo	Descrição
Nenhum(a)

O exemplo a seguir demonstra como rastreamento () registra a mensagem Exemplo de rastreamento junto com o rastreamento de pilha.

function firstFunction() {
    secondFunction();
}

function secondFunction() {
    thirdFunction();
}

function thirdFunction() {
    console.trace('Trace example');
}

firstFunction();

O rastreamento de pilha mostra a sequência de chamadas: ThirdFunction chamado por SecondFunction , que foi chamado por FirstFunction e assim por diante. . Console.trace('Exemplo de rastreamento') registra a mensagem Exemplo de rastreamento junto com o rastreamento de pilha.

Saída:

Trace example
    at thirdFunction (<filename>:8:13)
    at secondFunction (<filename>:4:5)
    at firstFunction (<filename>:2:5)

Console - WARN(Objeto val1...valN, cadeia de caracteres msg, cadeia de caracteres subst1...subst2)

Registra uma mensagem de aviso no log do sistema no nível de aviso.

Nota:

Console Os métodos de API fornecem a mesma funcionalidade de registro em log do API do sistema Glide (por exemplo, gs.info, gs.warn e gs.debug), mas permitem um uso mais reflexivo para desenvolvedores que estão familiarizados com mensagens de registro em log usando métodos de console. Ambos Console API e. Sistema Glide Os métodos de API podem ser usados no servidor.

Tabela 27. Parâmetros

Nome	Tipo	Descrição
msg	Cadeia de caracteres	Necessário se val1...valNnão foi aprovado. A mensagem ou objeto principal que você deseja registrar em log nos logs do sistema ou na saída. Aceita uma cadeia de caracteres que contém zero ou mais valores de substituição que podem ser definidos usando subst1 through substNparâmetro. Consulte "Uso de cadeias de caracteres de substituição" em Console - Escopo, Global para obter mais informações.
Subst1...substN	Cadeia de caracteres	Opcional. Valores JavaScript pelos quais substituir cadeias de caracteres de substituição msg. Esses valores são registrados ou exibidos na ordem em que são especificados. Se houver mais valores de substituição do que cadeias de caracteres de substituição, os próprios valores extras gravados serão anexados após a mensagem ( msgda mesma maneira que quando não há cadeia de caracteres de formato. Consulte "Uso de cadeias de caracteres de substituição" em Console - Escopo, Global para obter mais informações.
Val1...valN	Objeto	Necessário se msgnão foi aprovado. Lista de valores JavaScript adicionais a serem anexados após a mensagem principal ( msge são separados por um espaço ou outro delimitador. Aceita qualquer tipo de dados JavaScript, incluindo cadeias de caracteres ou objetos, e os gera na ordem em que são especificados.

Tabela 28. Retornos

Tipo	Descrição
Nenhum(a)

O exemplo a seguir usa aviso() para registrar uma mensagem de aviso, normalmente estilizada para se destacar (por exemplo, com um ícone de aviso ou texto amarelo). Este exemplo verifica a prioridade do registro: Se for alta (prioridade: "1" ), ele registrará uma mensagem de aviso. Se não for alto, ele registrará uma anotação menos urgente com o valor de prioridade atual.

function onLoad() {
    var priority = g_form.getValue("priority");

    if (priority === "1") {
        console.warn("Warning: This is a high-priority incident! Immediate attention required.");
    } else {
        console.warn("Note: Priority is not high. Current priority:", priority);
    }
}

Como resultado, aviso() registra ou exibe o erro da seguinte forma:

• Para alta prioridade: ⚠️ Aviso: Este é um incidente de alta prioridade! Atenção imediata necessária.
• Para outras prioridades: ⚠️ Observação: A prioridade não é alta. Prioridade atual: 3