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.