Документация по Console API

Kayce Basques
Kayce Basques
Sofia Emelianova
Sofia Emelianova

Используйте Console API, чтобы записывать сообщения в консоль из JavaScript. Интерактивное введение в эту тему вы найдете в статье Начало работы с записью сообщений в журнал в консоли.

Если вам нужны удобные методы, такие как debug(function) или monitorEvents(node), которые доступны только в консоли, ознакомьтесь с документацией по API утилит консоли.

console.assert(выражение, объект)

Уровень ведения журнала: Error.

Записывает ошибку в консоль, если expression оценивается как false.

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

Результат примера console.assert() выше.

console.clear()

Очистить консоль.

console.clear();

Если включен параметр Сохранять журнал, то console.clear() отключен.

Вы также можете очистить консоль, нажав на значок ALT_TEXT_HERE.

console.count([label])

Уровень ведения журнала: Info

Записывает количество вызовов count() в той же строке и с тем же значением label. Вызовите метод console.countReset([label]), чтобы сбросить счетчик.

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

Результат выполнения примера console.count() выше.

console.countReset([label])

Сбрасывает счетчик.

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

console.createTask(name)

Возвращает экземпляр Task, который связывает текущую трассировку стека с созданным объектом task. Позже вы можете использовать объект task, чтобы запустить функцию (f в следующем примере). task.run(f) выполняет произвольную полезную нагрузку и пересылает возвращаемое значение обратно вызывающей стороне.

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

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

Символ task связывает контекст создания с контекстом асинхронной функции. Это позволяет DevTools показывать более точные трассировки стека для асинхронных операций. Подробнее о связанных трассировках стека…

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

Уровень ведения журнала: Verbose

Аналогично console.log(object [, object, ...]), но с другим уровнем детализации журнала.

console.debug('debug');

Результат выполнения примера console.debug(), приведенного выше.

console.dir(object)

Уровень журнала: Info.

Выводит представление указанного объекта в формате JSON.

console.dir(document.head);

Результат выполнения примера console.dir() выше.

console.dirxml(node)

Уровень ведения журнала: Info.

Выводит XML-представление дочерних элементов node.

console.dirxml(document);

Результат выполнения примера console.dirxml() выше.

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

Уровень ведения журнала: Error

Выводит object в консоль, форматирует как ошибку и включает трассировку стека.

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

Результат выполнения примера console.error(), приведенного выше.

console.group(label)

Визуально группирует сообщения до вызова console.groupEnd(label). Чтобы свернуть группу при ее первоначальной регистрации в консоли, используйте console.groupCollapsed(label).

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

Результат выполнения примера console.group(), приведенного выше.

Кроме того, вы можете создавать вложенные группы.

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);

Вложенные группы.

console.groupCollapsed(label)

То же, что и console.group(label), но группа изначально свернута при регистрации в консоли.

console.groupEnd(label)

Отключает визуальную группировку сообщений. Подробнее console.group…

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

Уровень ведения журнала: Info

Идентично console.log(object [, object, ...]).

console.info('info');

Результат выполнения примера console.info(), приведенного выше.

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

Уровень журнала: Info.

Выводит сообщение в консоль.

console.log('log');

Результат выполнения примера console.log(), приведенного выше.

console.table(array [, columns])

Уровень ведения журнала: Info

Записывает массив объектов в виде таблицы.

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

Результат выполнения примера console.table() выше.

По умолчанию console.table() регистрирует все данные таблицы. Чтобы отобразить один или несколько столбцов, можно использовать второй необязательный параметр и указать название или названия столбцов в виде строки или массива строк. Пример:

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

Подмножество столбцов в таблице, зарегистрированной с помощью console.table().

Чтобы скопировать таблицу из журнала в буфер обмена в виде отформатированной таблицы Markdown или данных CSV, нажмите на таблицу в консоли правой кнопкой мыши и выберите нужный вариант копирования в контекстном меню.

console.time([label])

Запускает новый таймер. Вызовите console.timeEnd([label]), чтобы остановить таймер и вывести прошедшее время в консоль.

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

Результат выполнения примера console.time(), приведенного выше.

console.timeEnd([label])

Уровень журнала: Info.

Останавливает таймер. Подробнее console.time()…

console.trace()

Уровень ведения журнала: Info.

Выводит трассировку стека в консоль.

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

Результат выполнения примера console.trace() выше.

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

Уровень ведения журнала: Warning

Выводит предупреждение в консоль.

console.warn('warn');

Результат выполнения примера console.warn(), приведенного выше.