Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

console.trace() — rastreio da pilha de chamadas

console.trace() mostra a pilha no ponto da chamada e ajuda a descobrir como a execução chegou até aí.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

console.trace(...data)

console.trace(...data) apresenta uma representação da pilha de chamadas atual. Para apresentar o rastreio, não é necessário lançar uma exceção. Se a chamada terminar normalmente, o método devolve undefined e a execução prossegue. Contudo, a formatação de um argumento pode executar código de conversão definido pelo utilizador que lance uma exceção.

Os argumentos são opcionais; a implementação pode formatá-los como uma etiqueta. A apresentação da pilha e os nomes das funções dependem da implementação e podem diferir de new Error().stack.

Esta API é definida pelo Console Standard, não por uma edição de ECMAScript. A norma não especifica versões mínimas de navegadores; Node 24 não comprova o suporte em navegadores.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>console.trace example</title>
</head>
<body>
  <main><pre id="result"></pre></main>
  <script>
    const result = document.getElementById('result');

    function start() {
      inspect('checkpoint');
    }

    function inspect(label) {
      console.trace(label);
      const next = 'continued';
      console.log(next);
      result.textContent = `Console trace: ${label}\nLook for ${inspect.name} above ${start.name} in the stack.\nNext console log: ${next}`;
    }

    if (typeof console.trace === 'function') {
      start();
    } else {
      result.textContent = 'console.trace is unavailable.';
    }
  </script>
</body>
</html>

Resultado

Console trace: checkpoint
Look for inspect above start in the stack.
Next console log: continued

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes