Referência da API Console

Kayce Basques
Kayce Basques
Sofia Emelianova
Sofia Emelianova

Use a API Console para gravar mensagens no Console a partir do JavaScript. Consulte Primeiros passos com o registro de mensagens no console para uma introdução interativa ao tópico.

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

console.assert(expression, object)

Nível do 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 console.assert() acima.

console.clear()

Limpa o console.

console.clear();

Se a opção Preservar registro estiver ativada, console.clear() vai estar desativado.

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

console.count([label])

Nível do registro: Info

Grava o número de vezes 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 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. Posteriormente, você poderá 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 o da função assíncrona. Esse link permite que o DevTools mostre melhores stack traces para operações assíncronas. Para mais informações, consulte Stack traces vinculados.

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

Nível do registro: Verbose

Idêntico a console.log(object [, object, ...]), exceto por um nível de registro diferente.

console.debug('debug');

O resultado do exemplo console.debug() acima.

console.dir(object)

Nível do registro: Info

Imprime uma representação JSON do objeto especificado.

console.dir(document.head);

O resultado do exemplo console.dir() acima.

console.dirxml(node)

Nível do registro: Info

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

console.dirxml(document);

O resultado do exemplo console.dirxml() acima.

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

Nível do registro: Error

Exibe 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 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 registrado inicialmente 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 console.group() acima.

Além disso, é possível 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)

Igual a console.group(label), mas o grupo fica inicialmente recolhido quando está registrado no Console.

console.groupEnd(label)

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

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

Nível do registro: Info

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

console.info('info');

O resultado do exemplo console.info() acima.

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

Nível do registro: Info

Imprime uma mensagem no console.

console.log('log');

O resultado do exemplo console.log() acima.

console.table(matriz [, colunas])

Nível do 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 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 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 cronômetro. 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 console.time() acima.

console.timeEnd([label])

Nível do registro: Info

Interrompe um timer. Veja console.time().

console.trace()

Nível do registro: Info

Imprime um stack trace no console.

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

O resultado do exemplo console.trace() acima.

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

Nível do registro: Warning

Imprime um aviso no console.

console.warn('warn');

O resultado do exemplo console.warn() acima.