Referencia de la API de Console

Kayce Basques
Kayce Basques
Sofia Emelianova
Sofia Emelianova

Usa la API de la consola para escribir mensajes a la consola desde tu código JavaScript. Consulta Cómo comenzar a usar mensajes de registro en la consola para obtener una introducción interactiva al tema.

Consulta la referencia de la API de utilidades de Console si buscas métodos de conveniencia, como debug(function) o monitorEvents(node), que solo están disponibles en la consola.

console.assert(expresión, objeto)

Nivel de registro: Error

Escribe un error en la consola cuando expression se evalúa 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});

El resultado del ejemplo anterior de console.assert().

console.clear()

Borra la consola.

console.clear();

Si la opción Conservar el registro está habilitada, console.clear() se inhabilita.

También puedes hacer clic en el ícono ALT_TEXT_HERE para borrar la consola.

console.count([label])

Nivel de registro: Info

Escribe la cantidad de veces que se invocó count() en la misma línea y con la misma label Llama a console.countReset([label]) para restablecer el recuento.

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

El resultado del ejemplo anterior de console.count().

console.countReset([label])

Restablece un recuento.

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

console.createTask(name)

Muestra una instancia de Task que asocia el seguimiento de pila actual con el objeto task creado. Luego, puedes usar este objeto task para ejecutar una función (f en el siguiente ejemplo). task.run(f) ejecuta una carga útil arbitraria y reenvía el valor que se muestra al emisor.

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

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

task forma un vínculo entre el contexto de creación y el contexto de la función asíncrona. Este vínculo permite que las Herramientas para desarrolladores muestren mejores seguimientos de pila para las operaciones asíncronas. Para obtener más información, consulta Seguimientos de pila vinculados.

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

Nivel de registro: Verbose

Idéntico a console.log(object [, object, ...]), excepto que tiene un nivel de registro diferente.

console.debug('debug');

El resultado del ejemplo anterior de console.debug().

console.dir(object)

Nivel de registro: Info

Imprime una representación JSON del objeto especificado.

console.dir(document.head);

El resultado del ejemplo anterior de console.dir().

console.dirxml(node)

Nivel de registro: Info

Imprime una representación XML de los elementos subordinados de node.

console.dirxml(document);

El resultado del ejemplo anterior de console.dirxml().

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

Nivel de registro: Error

Imprime object en Console, lo formatea como un error y, además, incluye un seguimiento de pila.

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

El resultado del ejemplo anterior de console.error().

console.group(label)

Agrupa visualmente los mensajes hasta que se llama a console.groupEnd(label). Usa console.groupCollapsed(label) para contraer el grupo cuando se accede por primera vez a la consola

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

El resultado del ejemplo de console.group() anterior.

Además, puedes anidar 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 anidados.

console.groupCollapsed(label)

Igual que console.group(label), con la excepción de que el grupo se contrae inicialmente cuando se accede a la Consola.

console.groupEnd(label)

Deja de agrupar visualmente los mensajes. Consulta console.group.

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

Nivel de registro: Info

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

console.info('info');

El resultado del ejemplo anterior de console.info().

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

Nivel de registro: Info

Imprime un mensaje en la consola.

console.log('log');

El resultado del ejemplo anterior de console.log().

console.table(arreglo [, columnas])

Nivel de registro: Info

Registra un array de objetos como una tabla.

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

El resultado del ejemplo anterior de console.table().

De forma predeterminada, console.table() registra todos los datos de la tabla. Para mostrar una sola columna o un subconjunto de columnas, puedes usar el segundo parámetro opcional y especificar el nombre o los nombres de columna como una cadena o un array de cadenas. Por ejemplo:

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

Subconjunto de columnas en una tabla registrada con console.table().

console.time([label])

Inicia un temporizador nuevo. Llama a console.timeEnd([label]) para detener el temporizador y, luego, imprime el tiempo transcurrido en la consola.

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

El resultado del ejemplo anterior de console.time().

console.timeEnd([label])

Nivel de registro: Info

Detiene un temporizador. Consulta console.time().

console.trace()

Nivel de registro: Info

Imprime un seguimiento de pila en Console.

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

El resultado del ejemplo anterior de console.trace().

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

Nivel de registro: Warning

Imprime una advertencia en Console.

console.warn('warn');

El resultado del ejemplo anterior de console.warn().