Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

console.trace() — trace de la pile d’appels

console.trace() affiche la pile au point d’appel et aide à découvrir comment l’exécution est arrivée jusque-là.

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

Syntaxe

console.trace(...data)

console.trace(...data) affiche une représentation de la pile d’appels actuelle. L’affichage de la trace ne nécessite pas de lever une exception. Si l’appel se termine normalement, la méthode renvoie undefined et l’exécution se poursuit. Toutefois, le formatage d’un argument peut faire intervenir du code de conversion défini par l’utilisateur qui lève une exception.

Les arguments sont facultatifs ; l’implémentation peut les formater comme un libellé. La présentation de la pile et les noms de fonctions dépendent de l’implémentation et peuvent différer de new Error().stack.

Cette API est définie par le Console Standard, et non par une édition d’ECMAScript. Le standard ne précise aucune version minimale de navigateur ; Node 24 ne permet pas d’établir la prise en charge dans les navigateurs.

Exemples

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

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources