Console - com escopo, global

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 24 min. de leitura

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

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

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

    Capacidades de registro em log

    Logs gerados usando métodos de API do console, como assert(), error(), debug(), warning(), info()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. Filtrar a coluna Origem na exibição Todos os 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 métodos de API do console, especialmente aqueles que permitem registrar mensagens como assert(), error(), debug(), warning(), info()e log ().

    As cadeias de caracteres de substituição na API do console 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 script de exemplo 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);

    Exemplo de saída:

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

    Aqui está 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 Informações do usuário: { name: "Alex", função: "Developer" } em azul e negrito.

    Como usar temporizadores

    Você pode usar temporizadores de API do console para calcular a duração de uma operação específica. Para iniciar um temporizador, chame Console - time(rótulo de cadeia de caracteres) e atribua um nome a ele usando o parâmetro label. 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(cadeia de caracteres rótulo) passando o nome do temporizador como o parâmetro.

    Por exemplo, você pode iniciar um temporizador para medir a quantidade de tempo que passa chamando time("Process Duration")e, em seguida, chamar timeEnd("Process Duration"). Além disso, o código calcula e exibe quanto tempo passou desde o início do temporizador e quando a primeira e a segunda ações foram concluídas, passando Console - timeLog (rótulo de cadeia de caracteres, objeto valN) 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 termina:
      Process Duration: 10.123ms

    Console - assert(asserção booliana, objeto val1...valN, mensagem de cadeia de caracteres, 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
    asserção Booliano Opcional. Sinalizador que indica se uma mensagem genérica deve ser registrada indicando uma falha de asserção nos logs do sistema.
    Valores válidos:
    • verdadeiro: não registra a mensagem de falha de asserção.
    • falso: registra a mensagem de falha de asserção.

    Padrão: falso
    msg Cadeia de caracteres Obrigatório se val1...valN não for usado. Mensagem a ser exibida nos logs do sistema quando a asserção falha. Aceita uma cadeia de caracteres contendo zero ou mais valores de substituição que podem ser definidos usando o parâmetro subst1 through substN.

    Para obter mais informações, consulte "Substituições de cadeia de caracteres", consulte Console - com escopo, global.
    subst1... substN Cadeia de caracteres Opcional. Valores JavaScript com os quais as cadeias de caracteres de substituição serão substituídas em msg. Esses valores são registrados em log 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 valores extras serão gravados e anexados após a mensagem (msg) da mesma maneira que quando não há cadeia de caracteres de formato.

    Consulte "Usando cadeias de caracteres de substituição" em Console - com escopo, global para obter mais informações.
    val1...valN Objeto Obrigatório se msg não for aprovado. Lista de valores JavaScript adicionais a serem anexados após a mensagem principal (msg) e 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 "Matemática quebrada!" quando a asserção (1 + 1 === 3) é falsa e não faz nada quando a asserção (1 + 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!"

    Registrando valores adicionais em log

    O exemplo a seguir passa 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 passa 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 o número de vezes que count() foi chamado com um rótulo especificado.

    O método count() é ú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. Use Console - countReset(cadeia de caracteres rótulo) 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 for fornecido, define o rótulo como "padrão".
    Tabela 4. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir demonstra a aparência da saída sempre que o método count() é chamado com um rótulo (por exemplo, 'apple' 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

    O exemplo de count() a seguir demonstra a aparência da saída 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(cadeia de caracteres rótulo)

    Redefine o contador especificado para zero.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    rótulo Cadeia de caracteres Opcional. Nome do contador definido originalmente no método Console - count(rótulo de cadeia de caracteres) que você deseja redefinir para zero. Com distinção entre maiúsculas e minúsculas.
    Padrão: redefine o contador padrão para zero.
    Nota:
    Um contador recebe um rótulo de padrão quando um novo contador é definido usando count() 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 à 5ª 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 a variável de usuário como o argumento de rótulo com a cadeia de caracteres "bob" para a primeira invocação de console.count()e a cadeia de caracteres "alice" para a segunda:

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

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

    Saída. Observe que redefinir o valor do contador "bob" muda somente o valor desse contador. O valor de "alice" permanece inalterado.

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

    Console - debug(objeto val1...valN, mensagem de cadeia de caracteres, cadeia de caracteres subst1...substN)

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

    O método debug() permite 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 Console - log(Object val1...val2, String msg, String subst1...subst2). Por exemplo, você pode usar este método para escrever mensagens de depuração mais longas para desenvolvedores internos sobre estados ou fluxos internos. As mensagens do método debug() podem se comportar de forma diferente entre determinados navegadores.

    O método console.debug() registra mensagens em logs do sistema na instância ServiceNow®. Você pode exibir esses logs na plataforma ServiceNow® em Logs do sistema > Todos ou Logs do sistema > Depurar.
    Nota:
    Os métodos de APIdo console fornecem a mesma funcionalidade de registro em log que a API do sistema Glide (por exemplo, gs.info, gs.warn e gs.debug), mas permitem um uso mais refletivo para desenvolvedores que estão familiarizados com o registro em log de mensagens usando métodos de console. Os métodos da API do console e da API do sistema Glide podem ser usados no servidor.
    Tabela 7. Parâmetros
    Nome Tipo Descrição
    msg Cadeia de caracteres Obrigatório se val1...valN não for aprovado. A mensagem principal ou o objeto que você deseja registrar nos logs do sistema ou na saída. Aceita uma cadeia de caracteres contendo zero ou mais valores de substituição que podem ser definidos usando o parâmetro subst1 through substN.

    Consulte "Usando cadeias de caracteres de substituição" em Console - com escopo, global para obter mais informações.
    subst1... substN Cadeia de caracteres Opcional. Valores JavaScript com os quais as cadeias de caracteres de substituição serão substituídas em msg. Esses valores são registrados em log 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 valores extras serão gravados e anexados após a mensagem (msg) da mesma maneira que quando não há cadeia de caracteres de formato.

    Consulte "Usando cadeias de caracteres de substituição" em Console - com escopo, global para obter mais informações.
    val1...valN Objeto Obrigatório se msg não for aprovado. Lista de valores JavaScript adicionais a serem anexados após a mensagem principal (msg) e 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 na instância ServiceNow®.

    (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(Object val1...valN, String msg, String subst1...subsN)

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

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

    Nota:
    Os métodos de APIdo console fornecem a mesma funcionalidade de registro em log que a API do sistema Glide (por exemplo, gs.info, gs.warn e gs.debug), mas permitem um uso mais refletivo para desenvolvedores que estão familiarizados com o registro em log de mensagens usando métodos de console. Os métodos da API do console e da API do sistema Glide podem ser usados no servidor.
    Tabela 9. Parâmetros
    Nome Tipo Descrição
    msg Cadeia de caracteres Obrigatório se val1...valN não for aprovado. A mensagem principal ou o objeto que você deseja registrar nos logs do sistema ou na saída. Aceita uma cadeia de caracteres contendo zero ou mais valores de substituição que podem ser definidos usando o parâmetro subst1 through substN.

    Consulte "Usando cadeias de caracteres de substituição" em Console - com escopo, global para obter mais informações.
    subst1... substN Cadeia de caracteres Opcional. Valores JavaScript com os quais as cadeias de caracteres de substituição serão substituídas em msg. Esses valores são registrados em log 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 valores extras serão gravados e anexados após a mensagem (msg) da mesma maneira que quando não há cadeia de caracteres de formato.

    Consulte "Usando cadeias de caracteres de substituição" em Console - com escopo, global para obter mais informações.
    val1...valN Objeto Obrigatório se msg não for aprovado. Lista de valores JavaScript adicionais a serem anexados após a mensagem principal (msg) e 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, a saída error() exibe o seguinte código, respectivamente:
    • O primeiro exemplo exibirá simplesmente "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);

    Console - group(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é que groupEnd() seja 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 o método Console - groupEnd(). O método groupEnd() também diminui o recuo do grupo em um nível.

    Nota:
    group() mostra todos os níveis de agrupamento na saída e não é recolhível nem expansível.
    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, group() não produzirá nenhum texto, mas ainda recuará a nova linha vazia em um nível.
    Tabela 12. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir passa log() para criar um novo bloco aninhado e, em seguida, group() para registrar grupos recuados. Cada chamada subsequente para group() recua a linha em um novo nível. O script também chama groupEnd() para finalizar 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 group() 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 group() para registrar níveis recuados. O script passa por 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(Objeto val1...valN, Mensagem de cadeia de caracteres, Cadeia de caracteres subst1...substN)

    Registra uma mensagem nos logs do sistema no nível de informação.

    Nota:
    Os métodos de APIdo console fornecem a mesma funcionalidade de registro em log que a API do sistema Glide (por exemplo, gs.info, gs.warn e gs.debug), mas permitem um uso mais refletivo para desenvolvedores que estão familiarizados com o registro em log de mensagens usando métodos de console. Os métodos da API do console e da API do sistema Glide podem ser usados no servidor.
    Tabela 15. Parâmetros
    Nome Tipo Descrição
    msg Cadeia de caracteres Obrigatório se val1...valN não for aprovado. A mensagem principal ou o objeto que você deseja registrar nos logs do sistema ou na saída. Aceita uma cadeia de caracteres contendo zero ou mais valores de substituição que podem ser definidos usando o parâmetro subst1 through substN.

    Consulte "Usando cadeias de caracteres de substituição" em Console - com escopo, global para obter mais informações.
    subst1... substN Cadeia de caracteres Opcional. Valores JavaScript com os quais as cadeias de caracteres de substituição serão substituídas em msg. Esses valores são registrados em log 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 valores extras serão gravados e anexados após a mensagem (msg) da mesma maneira que quando não há cadeia de caracteres de formato.

    Consulte "Usando cadeias de caracteres de substituição" em Console - com escopo, global para obter mais informações.
    val1...valN Objeto Obrigatório se msg não for aprovado. Lista de valores JavaScript adicionais a serem anexados após a mensagem principal (msg) e 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 o método info() para registrar 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
}

    Console - log(Object val1...val2, String msg, String subst1...subst2)

    Registra uma mensagem nos logs do sistema.

    Nota:
    Os métodos de APIdo console fornecem a mesma funcionalidade de registro em log que a API do sistema Glide (por exemplo, gs.info, gs.warn e gs.debug), mas permitem um uso mais refletivo para desenvolvedores que estão familiarizados com o registro em log de mensagens usando métodos de console. Os métodos da API do console e da API do sistema Glide podem ser usados no servidor.
    Tabela 17. Parâmetros
    Nome Tipo Descrição
    msg Cadeia de caracteres Obrigatório se val1...valN não for aprovado. A mensagem principal ou o objeto que você deseja registrar nos logs do sistema ou na saída. Aceita uma cadeia de caracteres contendo zero ou mais valores de substituição que podem ser definidos usando o parâmetro subst1 through substN.

    Consulte "Usando cadeias de caracteres de substituição" em Console - com escopo, global para obter mais informações.
    subst1... substN Cadeia de caracteres Opcional. Valores JavaScript com os quais as cadeias de caracteres de substituição serão substituídas em msg. Esses valores são registrados em log 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 valores extras serão gravados e anexados após a mensagem (msg) da mesma maneira que quando não há cadeia de caracteres de formato.

    Consulte "Usando cadeias de caracteres de substituição" em Console - com escopo, global para obter mais informações.
    val1...valN Objeto Obrigatório se msg não for aprovado. Lista de valores JavaScript adicionais a serem anexados após a mensagem principal (msg) e 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 - time(rótulo de cadeia de caracteres)

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

    Você pode dar a cada temporizador um nome exclusivo e pode ter até 10.000 temporizadores em execução em uma determinada página. Quando você chama o método timeEnd() do console com o mesmo nome de rótulo, o contador gera o tempo em milissegundos decorrido desde que o temporizador foi iniciado. Use o método console timeLog() para registrar o tempo decorrido capturado entre a hora de início e a hora de parada do temporizador.

    Para obter exemplos sobre como usar este método com outros métodos de API do console baseados em tempo, consulte "Usando temporizadores" em Console - com 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(cadeia de caracteres rótulo) para parar o temporizador e exibir o tempo decorrido para o console.

    Número máximo de temporizadores: 10.000

    Padrão: usará o rótulo "padrão" se for omitido.
    Tabela 20. Retornos
    Tipo Descrição
    Nenhum(a)

    Veja a seguir como usar time("label") para iniciar um temporizador com o rótulo "label". O método console.timeEnd("label") 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(cadeia de caracteres rótulo)

    Interrompe um temporizador especificado que foi iniciado anteriormente chamando time().

    Para obter exemplos sobre como usar este método com outros métodos de API do console baseados em tempo, consulte "Usando temporizadores" em Console - com escopo, global.

    Tabela 21. Parâmetros
    Nome Tipo Descrição
    rótulo Cadeia de caracteres Opcional. Nome do temporizador a parar. Depois de interrompido, o tempo decorrido é exibido automaticamente no console junto com um indicador de que o tempo terminou. Este rótulo deve corresponder ao temporizador especificado no parâmetro Console - time(rótulo de cadeia de caracteres) label e fazer distinção entre maiúsculas e minúsculas.

    Padrão: se omitido, usará o rótulo "padrão".
    Tabela 22. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como usar time("label") para iniciar um temporizador com o rótulo "label". O método console.timeEnd("label") 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 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, objeto valN)

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

    Para obter exemplos sobre como usar este método com outros métodos de API do console baseados em tempo, consulte "Usando temporizadores" em Console - com 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 no parâmetro Console - time(rótulo de cadeia de caracteres) label e fazer distinção entre maiúsculas e minúsculas.

    Padrão: usará o rótulo "padrão" se for omitido.
    ValN Objeto Opcional. Valores adicionais a serem registrados após a saída do temporizador. Aceita um objeto não estruturado compatível com 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 de rótulo de um temporizador iniciado anteriormente usando o método time(). O método timeLog() registra 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á chamado de "padrão":

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

    Se não houver nenhum temporizador correspondente, console.timeLog() registrará em log 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('Timer') inicia um temporizador com o rótulo "Timer". console.timeLog('Timer') registra o tempo decorrido junto com mensagens adicionais opcionais. console.timeEnd('Timer') 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 do log:

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

    Console - rastrear (objetos de objeto)

    Registra em log 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 a serem enviados para o console junto com o rastreamento. Os objetos são montados e formatados da mesma forma que seriam se passados para o método Console - log(Object val1...val2, String msg, String subst1...subst2).

    Padrão: retorna a pilha inteira na saída.
    Tabela 26. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir demonstra como o rastreamento () registra o exemplo de rastreamento de mensagem 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 foi chamado porsecondFunction, que foi chamado por firstFunctione assim por diante. O console.trace('Trace example') registra a mensagem Trace example 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 - aviso (objeto val1...valN, mensagem de cadeia de caracteres, cadeia de caracteres subst1...subst2)

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

    Nota:
    Os métodos de APIdo console fornecem a mesma funcionalidade de registro em log que a API do sistema Glide (por exemplo, gs.info, gs.warn e gs.debug), mas permitem um uso mais refletivo para desenvolvedores que estão familiarizados com o registro em log de mensagens usando métodos de console. Os métodos da API do console e da API do sistema Glide podem ser usados no servidor.
    Tabela 27. Parâmetros
    Nome Tipo Descrição
    msg Cadeia de caracteres Obrigatório se val1...valN não for aprovado. A mensagem principal ou o objeto que você deseja registrar nos logs do sistema ou na saída. Aceita uma cadeia de caracteres contendo zero ou mais valores de substituição que podem ser definidos usando o parâmetro subst1 through substN.

    Consulte "Usando cadeias de caracteres de substituição" em Console - com escopo, global para obter mais informações.
    subst1... substN Cadeia de caracteres Opcional. Valores JavaScript com os quais as cadeias de caracteres de substituição serão substituídas em msg. Esses valores são registrados em log 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 valores extras serão gravados e anexados após a mensagem (msg) da mesma maneira que quando não há cadeia de caracteres de formato.

    Consulte "Usando cadeias de caracteres de substituição" em Console - com escopo, global para obter mais informações.
    val1...valN Objeto Obrigatório se msg não for aprovado. Lista de valores JavaScript adicionais a serem anexados após a mensagem principal (msg) e 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" ), será registrada 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, o aviso () registra ou exibe o erro da seguinte forma:
    • Para alta prioridade: ⚠. Aviso: este é um incidente de alta prioridade. Requer atenção imediata.
    • Para outras prioridades: ⚠. Observação: a prioridade não é alta. Prioridade atual: 3