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

CKTIS / JavaScript

console.dir — examiner un objet

console.dir affiche une valeur sous une forme générique d’objet JavaScript ; les détails de présentation dépendent de l’implémentation de la console.

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.dir(item)
console.dir(item, options)

console.dir(item, options) affiche item sous une forme générique d’objet JavaScript, qui peut permettre de développer les propriétés. La méthode renvoie undefined. Il s’agit d’une API de console définie par WHATWG, et non d’une fonctionnalité du langage ECMAScript.

Les deux arguments sont facultatifs. options est un objet contenant des options de formatage propres à l’implémentation ; le standard ne définit aucun ensemble de propriétés portable.

Contrairement à console.log, console.dir ne traite pas les spécificateurs de formatage. console.dirxml privilégie une représentation sous forme d’arbre DOM lorsqu’elle est disponible.

L’exemple affiche un objet imbriqué. Ne vous attendez pas à obtenir le même texte ou la même mise en page dans toutes les consoles.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Inspect an object with console.dir</title>
</head>
<body>
  <p id="result" role="status"></p>
  <script>
    const profile = { name: 'Ada', settings: { theme: 'dark' } };
    const result = document.querySelector('#result');
    if (typeof console.dir === 'function') {
      console.dir(profile);
      result.textContent = `Open the DevTools Console and expand settings to inspect theme: ${profile.settings.theme}.`;
    } else {
      result.textContent = 'console.dir unavailable';
    }
  </script>
</body>
</html>

Résultat

Open the DevTools Console and expand settings to inspect theme: dark.

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