Referência da API Console

Kayce Basques
Kayce Basques
Sofia Emelianova
Sofia Emelianova

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

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

console.assert(expression, object)

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 console.assert() acima.

console.clear()

Limpa o console.

console.clear();

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

Você também pode limpar o console clicando no ícone ALT_TEXT_HERE.

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 console.count() acima.

console.countReset([label])

Redefine uma contagem.

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

console.createTask(name)

Retorna uma instância Task que associa o stack trace atual ao objeto task criado. Esse objeto task pode ser usado 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 de criação e o contexto da função assíncrona. Esse link permite que as Ferramentas do desenvolvedor mostrem melhores rastros de pilha para operações assíncronas. Para mais informações, consulte Stack traces vinculados.

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

Nível de registro: Verbose

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

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 de 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 de registro: Error

Imprime object no console, formata 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 for 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), exceto que o grupo é inicialmente fechado 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 console.info() acima.

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

Nível de registro: Info

Imprime uma mensagem no console.

console.log('log');

O resultado do exemplo 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 console.table() acima.

Por padrão, console.table() registra todos os dados da tabela. Para mostrar uma única coluna ou um subconjunto delas, use o segundo parâmetro opcional e especifique o nome da coluna ou 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 de 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(object [, object, ...])

Nível de registro: Warning

Imprime um aviso no console.

console.warn('warn');

O resultado do exemplo console.warn() acima.