Справочник по API консоли

София Емельянова
Sofia Emelianova

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

См. Справочник по API консольных утилит, если вы ищете удобные методы, такие как debug(function) или monitorEvents(node) , которые доступны только из консоли.

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() отключен.

Кроме того, вы можете очистить консоль , нажав кнопку ALT_TEXT_ЗДЕСЬ икона.

console.count([метка])

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

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

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

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

console.countReset([метка])

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

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

console.createTask(имя)

Возвращает экземпляр 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(объект [, объект, ...])

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

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

console.debug('debug');

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

console.dir(объект)

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

Печатает JSON-представление указанного объекта.

console.dir(document.head);

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

console.dirxml(узел)

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

Печатает XML-представление потомков node .

console.dirxml(document);

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

console.error(объект [, объект, ...])

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

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

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

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

console.group(метка)

Визуально группирует сообщения до вызова 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(метка)

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

console.groupEnd(метка)

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

console.info(объект [, объект, ...])

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

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

console.info('info');

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

console.log(объект [, объект, ...])

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

Печатает сообщение на консоль.

console.log('log');

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

console.table(массив [, столбцы])

Уровень журнала : 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().

console.time([метка])

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

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

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

console.timeEnd([метка])

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

Останавливает таймер. См. console.time() .

консоль.trace()

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

Печатает трассировку стека на консоль.

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

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

console.warn(объект [, объект, ...])

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

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

console.warn('warn');

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