Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

console.trace() — ślad stosu wywołań

console.trace() pokazuje stos w miejscu wywołania, pomagając ustalić, skąd dotarło tam wykonanie.

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

Składnia

console.trace(...data)

console.trace(...data) wypisuje reprezentację bieżącego stosu wywołań. Samo wypisanie śladu stosu nie wymaga rzucenia wyjątku. Jeśli wywołanie zakończy się normalnie, metoda zwraca undefined, a wykonanie jest kontynuowane. Formatowanie argumentu może jednak uruchomić zdefiniowany przez użytkownika kod konwersji, który może rzucić wyjątek.

Argumenty są opcjonalne; implementacja może je sformatować jako etykietę. Wygląd stosu i nazwy funkcji zależą od implementacji i mogą różnić się od new Error().stack.

To API określa Console Standard, nie wydanie ECMAScript. Standard nie ustala minimalnych wersji przeglądarek; Node 24 nie dowodzi obsługi w przeglądarce.

Przykłady

<!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>

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła