Referência da API Console

Kayce Basco
Kayce Basques
Sofia Emelianova
Sofia Emelianova

Use a API Console para gravar mensagens no Console a partir do JavaScript. Consulte Como começar a registrar mensagens no console para uma introdução interativa ao tópico.

Consulte a Referência da API Console para utilitários se você estiver procurando métodos de conveniência, como debug(function) ou monitorEvents(node), que estão disponíveis apenas no Console.

console.assert(expressão, objeto)

Nível de registro: Error

Grava um erro no console quando expression é avaliado como false.

const x = 5;
const y = 3;
const reason = 'x is expected to be less than y';
console.assert(x < y, {x, y, reason});

O resultado do exemplo de console.assert() acima.

console.clear()

Limpa o console.

console.clear();

Se a opção Preservar registro estiver ativada, console.clear() será desativada.

Como alternativa, clique no ícone ALT_TEXT_HERE para limpar o console.

console.count([label])

Nível de registro: Info

Grava o número de vezes em que count() foi invocado na mesma linha e com o mesmo label. Chame console.countReset([label]) para redefinir a contagem.

console.count();
console.count('coffee');
console.count();
console.count();

O resultado do exemplo de console.count() acima.

console.countReset([label])

Redefine uma contagem.

console.countReset();
console.countReset('coffee');

console.createTask(name)

Retorna uma instância de Task que associa o stack trace atual ao objeto task criado. Mais tarde, você pode usar esse objeto task para executar uma função (f no exemplo a seguir). O task.run(f) executa um payload arbitrário e encaminha o valor de retorno de volta ao autor da chamada.

// Task creation
const task = console.createTask(name);

// Task execution
task.run(f); // instead of f();

O task forma um vínculo entre o contexto da criação e da função assíncrona. Esse link permite que o DevTools mostre stack traces melhores para operações assíncronas. Para mais informações, consulte Stack traces vinculados.

console.debug(objeto [, objeto, ...])

Nível de registro: Verbose

Idêntico ao console.log(object [, object, ...]), exceto pelo nível de registro diferente.

console.debug('debug');

O resultado do exemplo de console.debug() acima.

console.dir(object)

Nível de registro: Info

Mostra uma representação JSON do objeto especificado.

console.dir(document.head);

O resultado do exemplo de console.dir() acima.

console.dirxml(node)

Nível de registro: Info

Mostra uma representação XML dos descendentes de node.

console.dirxml(document);

O resultado do exemplo de console.dirxml() acima.

console.error(objeto [, objeto, ...])

Nível de registro: Error

Mostra object no Console, formata-o como um erro e inclui um stack trace.

console.error("I'm sorry, Dave. I'm afraid I can't do that.");

O resultado do exemplo de console.error() acima.

console.group(label)

Agrupa visualmente as mensagens até que console.groupEnd(label) seja chamado. Use console.groupCollapsed(label) para recolher o grupo quando ele estiver inicialmente registrado no console.

const label = 'Adolescent Irradiated Espionage Tortoises';
console.group(label);
console.info('Leo');
console.info('Mike');
console.info('Don');
console.info('Raph');
console.groupEnd(label);

O resultado do exemplo de console.group() acima.

Além disso, você pode aninhar grupos.

const timeline1 = 'New York 2012';
const timeline2 = 'Camp Lehigh 1970';
console.group(timeline1);
console.info('Mind');
console.info('Time');
console.group(timeline2);
console.info('Space');
console.info('Extra Pym Particles');
console.groupEnd(timeline2);
console.groupEnd(timeline1);

Grupos aninhados.

console.groupCollapsed(label)

O mesmo que console.group(label), mas o grupo fica inicialmente recolhido quando é registrado no Console.

console.groupEnd(label)

Interrompe o agrupamento visual de mensagens. Veja console.group.

console.info(objeto [, objeto, ...])

Nível de registro: Info

Idêntico a console.log(object [, object, ...]).

console.info('info');

O resultado do exemplo de console.info() acima.

console.log(objeto [, objeto, ...])

Nível de registro: Info

Imprime uma mensagem no Console.

console.log('log');

O resultado do exemplo de console.log() acima.

console.table(matriz [, colunas])

Nível de registro: Info

Registra uma matriz de objetos como uma tabela.

var people = [
  {
    first: 'René',
    last: 'Magritte',
  },
  {
    first: 'Chaim',
    last: 'Soutine',
    birthday: '18930113',
  },
  {
    first: 'Henri',
    last: 'Matisse',
  }
];
console.table(people);

O resultado do exemplo de console.table() acima.

Por padrão, console.table() registra todos os dados da tabela. Para exibir uma única coluna ou um subconjunto de colunas, use o segundo parâmetro opcional e especifique o nome ou os nomes das colunas como uma string ou uma matriz de strings. Exemplo:

console.table(people, ['last', 'birthday']);

Um subconjunto de colunas em uma tabela registrada com console.table().

console.time([label])

Inicia um novo timer. Chame console.timeEnd([label]) para interromper o timer e mostrar o tempo decorrido no console.

console.time();
for (var i = 0; i < 100000; i++) {
  let square = i ** 2;
}
console.timeEnd();

O resultado do exemplo de console.time() acima.

console.timeEnd([label])

Nível de registro: Info

Interrompe um timer. Veja console.time().

console.trace()

Nível de registro: Info

Mostra um stack trace no Console.

const first = () => { second(); };
const second = () => { third(); };
const third = () => { fourth(); };
const fourth = () => { console.trace(); };
first();

Resultado do exemplo de console.trace() acima.

console.warn(objeto [, objeto, ...])

Nível de registro: Warning

Imprime um aviso no Console.

console.warn('warn');

O resultado do exemplo de console.warn() acima.