Console

Определение и применение

Console — название API для диагностических сообщений. В коде используется объект console со строчной буквы. Например, console.log(price) помогает проверить цену на определённом шаге программы. В браузере сообщения видны в консоли инструментов разработчика. Создавать объект через new Console() не нужно.

Как открыть консоль, выбрать контекст страницы и найти ошибку, показано в уроке «Консоль браузера и ошибки». console предоставляется средой выполнения и доступен также в веб-воркерах. Это не встроенный объект ECMAScript наподобие Math.

Поддержка браузерами

Спецификация: console.spec.whatwg

Поддерживается во всех основных браузерах с 2015 года.

Отдельные значения (13) поддерживаются не везде — смотрите таблицу.

Показать браузеры
Совместимостьapi.console
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
console✓1✓12✓4✓10.5✓3✓18✓4✓11✓1✓1.0✓3✓1
assert() static method✓2✓12✓28✓11✓4✓18✓28✓11✓3.2✓1.0✓4.4✓3.2
clear() static method✓25✓12✓39✓12✓7✓25✓39✓12✓7✓1.5✓4.4✓7
countReset() static method✓68✓79✓62✓55✓13✓68✓62✓48✓13✓10.0✓68✓13
count() static method✓2✓12✓30✓11✓4✓18✓30✓11✓3.2✓1.0✓4.4✓3.2
debug() static method✓2✓12✓5✓11✓4✓18✓5✓11✓3.2✓1.0✓4.4✓3.2
dir() static method✓2✓12✓8✓11✓4✓18✓8✓11✓3.2✓1.0✓4.4✓3.2
options.colors parameter××××××××××××
options.depth parameter××××××××××××
options.showHidden parameter××××××××××××
dirxml() static method✓2✓12✓39✓11✓4✓18✓39✓11✓3.2✓1.0✓4.4✓3.2
error() static method✓1✓12✓4✓10.5✓3✓18✓4✓11✓1✓1.0✓4.4✓1
exception() static method (an alias for error())××✓28×××✓28×××××
groupCollapsed() static method✓6✓12✓9✓11✓5.1✓18✓9✓11✓5✓1.0✓3✓5
groupEnd() static method✓2✓12✓9✓11✓4✓18✓9✓11✓3.2✓1.0✓37✓3.2
group() static method✓2✓12✓9✓11✓4✓18✓9✓11✓3.2✓1.0✓37✓3.2
info() static method✓1✓12✓4✓10.5✓3✓18✓4✓11✓1✓1.0✓4.4✓1
log() static method✓1✓12✓4✓10.5✓3✓18✓4✓11✓1✓1.0✓4.4✓1
profileEnd() static method✓5✓12◐98✓11✓4✓18◐98✓11✓3.2✓1.0✓4.4✓3.2
profile() static method✓5✓12◐98✓11✓4✓18◐98✓11✓3.2✓1.0✓4.4✓3.2
Substitution strings✓1✓12✓9✓15✓3✓18✓9✓14✓1✓1.0✓4.4✓1
table() static method✓27✓13✓34✓11✓7✓27✓34✓11✓7✓1.5✓4.4✓7
timeEnd() static method✓2✓12✓10✓11✓4✓18✓10✓11✓3.2✓1.0✓4.4✓3.2
timeLog() static method✓71✓79✓62✓60✓13✓71✓62✓50✓13✓10.0✓71✓13
timeStamp() static method✓15✓12✓149✓15✓6✓18✓149✓14✓6✓1.0✓4.4✓6
color parameter✓134✓134×✓119×✓134×✓88×✓29.0✓134×
data parameter✓141✓141×✓125×✓141×✓93×✓30.0✓141×
end parameter✓134✓134×✓119×✓134×✓88×✓29.0✓134×
label parameter✓15✓12×✓15✓6✓18×✓14✓6✓1.0✓4.4✓6
start parameter✓134✓134×✓119×✓134×✓88×✓29.0✓134×
trackGroup parameter✓134✓134×✓119×✓134×✓88×✓29.0✓134×
trackName parameter✓134✓134×✓119×✓134×✓88×✓29.0✓134×
time() static method✓2✓12✓10✓11✓4✓18✓10✓11✓3.2✓1.0✓4.4✓3.2
trace() static method✓2✓12✓6✓11✓4✓18✓6✓11✓3.2✓1.0✓4.4✓3.2
warn() static method✓1✓12✓4✓10.5✓3✓18✓4✓11✓1✓1.0✓4.4✓1
Available in workers✓31✓12✓29✓≤12.1✓7✓31✓29✓≤12.1✓7✓2.0✓4.4.3✓7

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

Вывод значений

JavaScript
console.log("Цена:", price);
console.warn("Товар заканчивается");
console.error("Не удалось получить данные");

price — ваша переменная. В log() можно передать несколько значений, не соединяя их заранее в строку. Все стандартные методы console возвращают undefined. Поэтому дополнительное undefined после выполненной команды в DevTools может быть результатом вызова, а не вторым сообщением.

console.error() выводит сообщение уровня ошибки, но сам по себе не выбрасывает исключение и не останавливает программу. Проверить порядок сообщений можно в примере уровней вывода.

Стандартные методы

Методы Console Standard
Имя Назначение
log(...data) Выводит одно или несколько значений.
info(...data) Сообщение информационного уровня.
warn(...data) Предупреждение. Цвет и значок выбирает браузер.
error(...data) Сообщение уровня ошибки без выбрасывания исключения.
debug(...data) Отладочное сообщение, которое может быть скрыто фильтром уровней.
assert(condition, ...data) Пишет сообщение, если условие ложно. Без аргументов условие считается ложным.
clear() Запрашивает очистку консоли. Сохранение журнала и настройки DevTools могут влиять на результат.
table(data, columns) Показывает данные таблицей. Второй необязательный аргумент ограничивает показываемые столбцы.
trace(...data) Выводит сообщение и стек вызовов.
dir(item, options) Представляет свойства объекта в удобном для исследования виде. Настройки и оформление зависят от среды.
dirxml(...data) Показывает представление DOM/XML, если среда поддерживает такой вывод.
count(label) Увеличивает и выводит счётчик с указанной меткой. Метка по умолчанию — "default".
countReset(label) Сбрасывает счётчик с той же меткой.
group(...data) Начинает раскрытую группу сообщений.
groupCollapsed(...data) Начинает свёрнутую группу.
groupEnd() Заканчивает текущую группу.
time(label) Запускает таймер с меткой, по умолчанию "default".
timeLog(label, ...data) Выводит прошедшее время и дополнительные данные, сохраняя таймер.
timeEnd(label) Выводит прошедшее время и завершает таймер.

Собственные свойства с данными, константы и события этим стандартом не определены. В отдельных браузерах есть расширения вроде profile(), profileEnd() и timeStamp(), но их не следует считать переносимой частью приведённого API.

Формат и состояние объекта

Первая строка может содержать подстановки: %s для строки, %d/%i для целого представления, %f для числа, %o/%O для объекта, %c для стиля следующего текста. Поддержка оформления определяется средой. Для простых проверок удобнее отдельные аргументы console.log("Цена:", price).

Раскрываемый объект в DevTools может показывать состояние, полученное позже момента вывода. Если нужен снимок простых сериализуемых данных, выведите JSON.stringify(value). У этого способа свои ограничения: например, объектные свойства со значением undefined пропускаются, а циклические ссылки вызывают ошибку.

Консоль браузера и вывод редактора

Первые два примера выводят сообщения текстом. Для цветного текста, таблиц, картинок и групп ниже есть учебный предпросмотр. Он показывает результат прямо на странице; оформление и исследование объектов в DevTools могут отличаться. Если сообщение в консоли браузера не видно, проверьте фильтры уровней, текстовый поиск и выбранный контекст.

Спецификация

Console Standard: пространство имён console.

Примеры, попробуйте сами

Сообщение об ошибке не останавливает код

Запустите пример. После console.error появится последнее сообщение. Измените price и снова запустите код: вывод обновляется только после запуска.

index.html
HTML
<!doctype html><html lang="ru"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>Сообщение об ошибке не останавливает код</title></head><body><p>Откройте консоль браузера, чтобы увидеть результат.</p><script src="main.js"></script></body></html>
main.js
JavaScript
const price = 450;
console.log("Цена:", price);
console.info("Проверяем наличие");
console.warn("Осталось мало товаров");
console.error("Пример сообщения об ошибке");
console.log("Программа продолжилась");

Сохранить текстовый снимок данных

До изменения price снимок содержит 450, после — 700. Измените вторую цену и сравните две строки. Строка снимка сохраняет результат на момент JSON.stringify.

index.html
HTML
<!doctype html><html lang="ru"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>Сохранить текстовый снимок данных</title></head><body><p>Откройте консоль браузера, чтобы увидеть результат.</p><script src="main.js"></script></body></html>
main.js
JavaScript
const product = { name: "Мяч", price: 450 };
const before = JSON.stringify(product);
product.price = 700;
console.log(before);
console.log(JSON.stringify(product));

Следующие примеры показывают вывод с цветами, таблицами и группами. При выполнении вызова прямо в DevTools дополнительно появляется undefined — возвращаемое значение метода console, а не ещё одно сообщение. Скачайте и откройте HTML или скопируйте код в консоль текущей страницы, чтобы проверить результат в браузере.

Цветной текст и метки

Нажмите ▶: появятся цветное приветствие и две метки. Измените CSS во втором аргументе и запустите снова. Каждый %c начинает новый стиль, а пустая строка сбрасывает его.

index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>Цветной текст и метки</title>
  </head>
  <body>
    <p data-console-instructions>Откройте консоль браузера, чтобы увидеть результат.</p>
    <script src="main.js"></script>
  </body>
</html>
main.js
JavaScript
console.log('%cПривет из консоли!', 'color: #2563eb; font-size: 20px; font-weight: bold;')

console.log(
    '%c API %c 200 OK %c Получено 3 товара',
    'background: #1e3a8a; color: white; padding: 2px 6px;',
    'background: #166534; color: white; padding: 2px 6px;',
    ''
)

Массив объектов в виде таблицы

Нажмите ▶, чтобы увидеть товары таблицей. Уберите второй аргумент console.table(): появится столбец stock. Попробуйте передать products.filter(product => product.stock > 0), чтобы оставить товары в наличии.

index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>Массив объектов в виде таблицы</title>
  </head>
  <body>
    <p data-console-instructions>Откройте консоль браузера, чтобы увидеть результат.</p>
    <script src="main.js"></script>
  </body>
</html>
main.js
JavaScript
const products = [
    { name: 'Блокнот', price: 250, stock: 12 },
    { name: 'Ручка', price: 80, stock: 0 },
    { name: 'Папка', price: 160, stock: 5 },
]

console.table(products, ['name', 'price'])

Картинка в консоли

Нажмите ▶: Canvas нарисует значок JS, а %c покажет PNG как фон сообщения. Измените текст или цвета и запустите снова. padding задаёт размер области. В Chrome DevTools для такого фона нужен адрес data:, обычный https://… не подходит.

index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>Картинка в консоли</title>
  </head>
  <body>
    <p data-console-instructions>Откройте консоль браузера, чтобы увидеть результат.</p>
    <script src="main.js"></script>
  </body>
</html>
main.js
JavaScript
const canvas = document.createElement('canvas')
canvas.width = 160
canvas.height = 80

const ctx = canvas.getContext('2d')
ctx.fillStyle = '#1e3a8a'
ctx.fillRect(0, 0, 160, 80)
ctx.fillStyle = '#facc15'
ctx.font = 'bold 36px sans-serif'
ctx.fillText('JS', 58, 54)

const imageUrl = canvas.toDataURL('image/png')
console.log(
    '%c ',
    `font-size: 0; padding: 40px 80px;
   background: url("${imageUrl}") center / contain no-repeat;`
)

Свёрнутая группа сообщений

Нажмите ▶ и раскройте «Заказ №42». Таблица и сумма находятся внутри группы, последнее сообщение — снаружи. Замените groupCollapsed() на group(), чтобы группа сразу открывалась.

index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>Свёрнутая группа сообщений</title>
  </head>
  <body>
    <p data-console-instructions>Откройте консоль браузера, чтобы увидеть результат.</p>
    <script src="main.js"></script>
  </body>
</html>
main.js
JavaScript
console.groupCollapsed('Заказ №42')
console.log('Покупатель:', 'Анна')
console.table([
    { name: 'Блокнот', quantity: 2 },
    { name: 'Ручка', quantity: 1 },
])
console.log('Сумма:', 580)
console.groupEnd()

console.log('Это сообщение уже вне группы')

Сколько времени заняло вычисление

Нажмите ▶: появятся длительность вычисления и сумма. Измените верхнюю границу цикла и повторите запуск. Метки time() и timeEnd() должны совпадать; время зависит от устройства и нагрузки.

index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>Сколько времени заняло вычисление</title>
  </head>
  <body>
    <p data-console-instructions>Откройте консоль браузера, чтобы увидеть результат.</p>
    <script src="main.js"></script>
  </body>
</html>
main.js
JavaScript
console.time('Сумма чисел')
let total = 0
for (let i = 1; i <= 100000; i++) {
    total += i
}
console.timeEnd('Сумма чисел')
console.log(total) // 5000050000