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

CKTIS / JavaScript

console.dir — inspecionar um objeto

console.dir apresenta um valor num formato genérico de objeto JavaScript; os detalhes da apresentação dependem da implementação da consola.

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

console.dir(item, options) apresenta item num formato genérico de objeto JavaScript, que pode permitir expandir as propriedades. Devolve undefined. Trata-se de uma API de consola definida pela WHATWG, não de uma funcionalidade da linguagem ECMAScript.

Ambos os argumentos são opcionais. options é um objeto que contém opções de formatação específicas da implementação; a norma não define um conjunto portátil de propriedades.

Ao contrário de console.log, console.dir não processa especificadores de formatação. console.dirxml prefere uma representação em árvore DOM quando disponível.

O exemplo apresenta um objeto aninhado. Não esperes obter o mesmo texto ou disposição em todas as consolas.

Exemplos

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

Resultado

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

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