Console
Определение и применение
Console — название API для диагностических сообщений. В коде используется объект console со
строчной буквы. Например, console.log(price) помогает проверить цену на определённом шаге программы. В
браузере сообщения видны в консоли инструментов разработчика. Создавать объект через new Console() не
нужно.
Как открыть консоль, выбрать контекст страницы и найти ошибку, показано в уроке
«Консоль браузера и ошибки». console предоставляется средой выполнения и доступен также в веб-воркерах. Это не встроенный объект
ECMAScript наподобие Math.
Поддержка браузерами
Спецификация: console.spec.whatwg
Поддерживается во всех основных браузерах с 2015 года.
Отдельные значения (13) поддерживаются не везде — смотрите таблицу.
| Возможность | Компьютеры | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
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()) | Версия 13 выпущена в 2015 г. — Удалено в 79 | 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 Версия 98 выпущена в 2022 г. — Частичная поддержка Примечание MDN (англ.) The method can be called, but the marker does not show up in the performance profile. Версия 16 выпущена в 2012 г. — Удалено в 97 | 11 | 4 | 18 | 98 Версия 98 выпущена в 2022 г. — Частичная поддержка Примечание MDN (англ.) The method can be called, but the marker does not show up in the performance profile. Версия 16 выпущена в 2012 г. — Удалено в 97 | 11 | 3.2 | 1.0 | 4.4 | 3.2 |
| profile() static method | 5 | 12 | 98 Версия 98 выпущена в 2022 г. — Частичная поддержка Примечание MDN (англ.) The method can be called, but the marker does not show up in the performance profile. Версия 16 выпущена в 2012 г. — Удалено в 97 | 11 | 4 | 18 | 98 Версия 98 выпущена в 2022 г. — Частичная поддержка Примечание MDN (англ.) The method can be called, but the marker does not show up in the performance profile. Версия 16 выпущена в 2012 г. — Удалено в 97 | 11 | 3.2 | 1.0 | 4.4 | 3.2 |
| Substitution strings | 1 Версия 1 выпущена в 2008 г. Примечание MDN (англ.) In version 28, if a negative value is passed to %d, it will be rounded down to the closest negative integer, so -0.1 becomes -1. | 12 Версия 12 выпущена в 2015 г. Примечание MDN (англ.) Before Edge 79, Before Edge 79, | 9 | 15 | 3 | 18 Версия 18 выпущена в 2012 г. Примечание MDN (англ.) In version 28, if a negative value is passed to %d, it will be rounded down to the closest negative integer, so -0.1 becomes -1. | 9 | 14 | 1 | 1.0 Версия 1.0 выпущена в 2013 г. Примечание MDN (англ.) In Samsung Browser 1.5, if a negative value is passed to %d, it will be rounded down to the closest negative integer, so -0.1 becomes -1. | 4.4 Версия 4.4 выпущена в 2013 г. Примечание MDN (англ.) In version 4.4, if a negative value is passed to %d, it will be rounded down to the closest negative integer, so -0.1 becomes -1. | 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 Версия 149 выпущена в 2026 г. Версия 98 выпущена в 2022 г. — Удалено в 149; Частичная поддержка Примечание MDN (англ.) The method can be called, but the marker does not show up in the performance profile. Версия 39 выпущена в 2015 г. — Удалено в 97 | 15 | 6 | 18 | 149 Версия 149 выпущена в 2026 г. Версия 98 выпущена в 2022 г. — Удалено в 149; Частичная поддержка Примечание MDN (англ.) The method can be called, but the marker does not show up in the performance profile. Версия 39 выпущена в 2015 г. — Удалено в 97 | 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
Вывод значений
console.log("Цена:", price);
console.warn("Товар заканчивается");
console.error("Не удалось получить данные");
price — ваша переменная. В log() можно передать несколько значений, не соединяя их заранее в
строку. Все стандартные методы console возвращают undefined. Поэтому дополнительное
undefined после выполненной команды в DevTools может быть результатом вызова, а не вторым сообщением.
console.error() выводит сообщение уровня ошибки, но сам по себе не выбрасывает исключение и не
останавливает программу. Проверить порядок сообщений можно в
примере уровней вывода.
Стандартные методы
| Имя | Назначение |
|---|---|
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 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
const price = 450;
console.log("Цена:", price);
console.info("Проверяем наличие");
console.warn("Осталось мало товаров");
console.error("Пример сообщения об ошибке");
console.log("Программа продолжилась");
Нажмите , чтобы запустить пример.
Сохранить текстовый снимок данных
До изменения price снимок содержит 450, после — 700. Измените вторую цену и сравните две строки. Строка снимка сохраняет результат на момент JSON.stringify.
index.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
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 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
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 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
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 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
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 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
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 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
console.time('Сумма чисел')
let total = 0
for (let i = 1; i <= 100000; i++) {
total += i
}
console.timeEnd('Сумма чисел')
console.log(total) // 5000050000
Нажмите , чтобы запустить пример.