Консоль браузера и ошибки
Чтение — около 8 минут· без учёта практики
Откройте консоль своей страницы
В предыдущем уроке
мы увидели, что одна неверная буква может остановить программу. Консоль помогает понять, где это произошло.
Она показывает сообщения от console.log(), ошибки JavaScript и некоторые сообщения самого браузера.
Нам важно читать не всё подряд, а то, что относится к текущему запуску нашего файла.
Откройте свой index.html из папки javascript-start, где подключён script.js.
Дальше действия описаны для Chrome. Нажмите Ctrl + Shift + J
(в macOS — Cmd + Option + J): откроется вкладка «Консоль» (Console)
инструментов разработчика. Обновите страницу и найдите сообщения из своего script.js.
Если нужных сообщений не видно
Очистите поле фильтра в верхней части консоли. В списке уровней сообщений включите Info и Error:
к первому относятся наши вызовы console.log(), ко второму — ошибки.
Для нового наблюдения нажмите «Очистить консоль» (Clear console), затем обновите страницу.
Очищение убирает записи из панели, но не меняет код и не исправляет причину ошибки.
Настройка Preserve log сохраняет записи при переходах и обновлении страницы. Если она включена, старые ошибки могут остаться рядом с новым выводом. Перед проверкой исправления удобно очистить панель, чтобы не спутать разные запуски.
Как читать сообщение об ошибке
Посмотрим на знакомую опечатку. Вторая команда записана с большой буквы, хотя нам нужна
console.log():
Найдите место остановки
Запустите код. Появится «Начало проверки», затем ошибка: две оставшиеся команды не завершат свою работу. Исправьте Console на console и запустите снова.
index.html
<html lang="ru">
<head>
<meta charset="utf-8">
<title>Консоль и ошибки</title>
</head>
<body>
<h1>Проверка программы</h1>
<script src="script.js"></script>
</body>
</html>
script.js
console.log("Начало проверки");
Console.log("Каталог готов.");
console.log("Проверка завершена.");
Нажмите , чтобы запустить пример.
На локальной странице браузер может показать сообщение вида ReferenceError: Console is not defined
и ссылку script.js:2:1. Читайте их по частям:
ReferenceError— тип ошибки. В этом случае программа обратилась к имени, которое не найдено.Console is not defined— пояснение: имяConsoleне определено. В нашем коде это опечатка в регистре.script.js— файл, в котором нужно искать проблему.2— номер строки,1— позиция в строке, если браузер её показывает.
Нажмите ссылку с именем файла: в инструментах разработчика откроется его исходный код возле указанного места.
Само исправление внесите в script.js в VS Code, сохраните файл и обновите страницу.
Проверка: теперь видны все три сообщения, а ошибка этого запуска исчезла.
Во встроенном редакторе сообщение об ошибке выделяется красным. Рядом показываются имя файла и номер строки:
script.js:2 означает вторую строку файла script.js. Откройте вкладку с этим именем
и найдите строку по номерам слева от кода. После исправления нажмите «Запустить».
Если браузер не передал позицию, остаётся только текст ошибки.
Точная формулировка ошибки и наличие позиции зависят от браузера. В консоли браузера имя файла может быть ссылкой на исходный код; во встроенной области вывода это текстовая подсказка, по которой нужно найти строку самостоятельно.
Ошибка во время выполнения
В первом примере запись допустима по форме: JavaScript может её прочитать.
Ошибка появляется при выполнении второй команды, когда требуется найти имя Console.
Поэтому первое сообщение успевает появиться, а последняя инструкция этого скрипта уже не выполняется.
Такую ситуацию называют ошибкой выполнения.
Другая опечатка — console.lgo("Каталог готов.");.
Здесь имя console написано правильно, но вместо готовой команды log указано lgo.
В таком случае браузер обычно сообщает TypeError с пояснением вроде
console.lgo is not a function: выполнить указанный вызов не получается.
Смысл этих двух типов ошибок будем уточнять по мере знакомства с языком.
Ошибка в записи программы
Теперь рассмотрим синтаксическую ошибку — нарушение правил записи, из-за которого программа не может быть разобрана. Например, в строке ниже не закрыты кавычки:
console.log("Каталог готов.);В следующем редакторе исходный код исправен. Запустите его, затем удалите закрывающую кавычку после «Каталог готов.» во второй команде и запустите снова.
Сравните два вида ошибки
Сначала выводятся три сообщения. После удаления закрывающей кавычки во второй команде появится SyntaxError, а сообщения этого запуска не появятся. Верните кавычку и запустите код ещё раз.
index.html
<html lang="ru">
<head>
<meta charset="utf-8">
<title>Консоль и ошибки</title>
</head>
<body>
<h1>Проверка программы</h1>
<script src="script.js"></script>
</body>
</html>
script.js
console.log("Начало проверки");
console.log("Каталог готов.");
console.log("Проверка завершена.");
Нажмите , чтобы запустить пример.
При такой ошибке не выполнится даже первая команда этого файла: сначала нужно успешно разобрать весь скрипт. Это отличается от предыдущего примера, где выполнение уже началось и остановилось на второй команде. В данном уроке мы рассматриваем один файл с последовательными командами. Ошибка в нём не означает, что весь браузер или все остальные скрипты страницы перестали работать.
При SyntaxError смотрите не только на отмеченную позицию, но и немного выше.
Например, пропущенная закрывающая скобка может обнаружиться лишь на следующей строке,
где браузер уже ожидал другое продолжение. Проверьте парность кавычек и скобок, точное написание команды.
Как проверять исправление
Начните с первой ошибки вашего файла в текущем запуске. Найдите указанную строку, сравните код с ожидаемой записью и исправьте одну причину. Сохраните файл, очистите консоль и обновите страницу. После устранения первой ошибки выполнение может дойти до следующей — это значит, что вы продвинулись дальше, а не что прежняя правка обязательно была неверной.
Если красных сообщений больше нет, проверьте сами результаты: их текст, количество и порядок.
Команда console.log("Нет в наличии"); записана корректно, но не подходит для задачи,
где требовалось сообщить «Есть в наличии». Такой промах не обязан вызывать ошибку JavaScript.
Команду можно выполнить прямо в консоли
В строке ввода консоли своей страницы напечатайте console.log("Проверка ввода");
и нажмите Enter. Появится сообщение «Проверка ввода».
Консоль может дополнительно показать undefined как результат самой команды —
это не сообщение об ошибке. Это значение разберём в отдельном уроке.
Такой запуск удобен для короткой проверки, но не дописывает команду в ваш script.js.
Чтобы программа работала после нового открытия страницы, сохраняйте нужный код в файле проекта.
Коротко
- Сообщение об ошибке читаем по частям: тип (
ReferenceError), пояснение (Console is not defined), файл и строка (script.js:2). SyntaxError— код записан не по правилам языка, поэтому скрипт не выполняется совсем, даже первая команда.- Ошибка выполнения (
ReferenceError,TypeError) возникает в конкретной команде: всё, что было до неё, уже выполнилось. - Исправляйте одну ошибку за раз: сохраните файл, очистите консоль, обновите страницу. Отсутствие ошибок ещё не значит, что результат правильный: проверьте текст и порядок сообщений.
Полный синтаксис и особенности — в справочнике: Unexpected token, x is not defined, x is not a function, Cannot read properties of undefined (reading 'x').
Проверьте себя
Выберите ответ — объяснение появится сразу. Ответ можно менять.
Задание
Тони добавил в конец js/shop.js блок «Проверка склада» и допустил в нём две опечатки.
- Запустите исходный код, прочитайте первую ошибку и исправьте только её.
- После повторного запуска найдите и исправьте следующую ошибку.
Тексты и порядок сообщений не меняйте.
Ожидаемый результат
- Сначала после сообщений магазина видны «Начало проверки» и ошибка.
- После первого исправления появляется «Мячей на складе: 12», но остаётся вторая ошибка.
- После второго исправления блок выводит три сообщения: «Начало проверки», «Мячей на складе: 12», «Проверка завершена.» — без ошибок.
Назовите обе опечатки и объясните, почему сразу не выполнялась последняя команда.
Выполните задание
Условие задания
js/shop.js
/*
Лавка Тони: сообщения магазина.
Выводим только готовые сообщения.
*/
console.log("Лавка Тони");
console.log("Мяч для прогулок");
console.log("Есть в наличии");
// Акция ещё не готова к показу.
// console.log("Черновик акции");
console.log("Магазин открыт.");
// Проверка склада
console.log("Начало проверки");
console.lgo("Мячей на складе: 12");
Console.log("Проверка завершена.");
pages/shop.html
<html lang="ru">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="Лавка Тони — учебный магазин игрушек и вещей для собак.">
<title>Лавка Тони</title>
<link rel="stylesheet" href="../css/style.css">
</head>
<body>
<header>
<nav>
<ul>
<li><a href="../index.html">Главная</a></li>
<li><a href="toys.html">Мои игрушки</a></li>
<li><a href="signup.html">Запись на прогулку</a></li>
<li><a href="shop.html">Лавка Тони</a></li>
</ul>
</nav>
</header>
<main>
<h1>Лавка Тони</h1>
<p>Скоро здесь появятся игрушки и вещи для прогулок. Пока Тони готовит программу магазина.</p>
</main>
<script src="../js/shop.js"></script>
</body>
</html>
Нажмите , чтобы запустить пример.
Подсказка
Сравните две последние команды с правильной записью console.log(). В одном месте перепутаны буквы, в другом изменён регистр. После каждого исправления запускайте программу заново, чтобы увидеть, до какой команды она дошла.
Продолжите в VS Code
Перенесите блок «Проверка склада» в js/shop.js своего сайта сначала с опечатками и откройте страницу Лавки. Проверка: в консоли браузера рядом с ошибкой указаны файл shop.js и номер строки. Исправьте ошибки по очереди, обновляя страницу после каждого исправления.
Самостоятельная практика
Три вида ошибок
Программа проверки склада должна вывести пять сообщений, но в ней три ошибки разного вида. Запускайте программу после каждого исправления и записывайте тип ошибки, которую видите. Исправляйте только то место, на которое указывает текущая ошибка. Тексты сообщений и их порядок не меняйте.
Ожидаемый результат: первый запуск — SyntaxError и ни одного сообщения. После первого исправления — «Проверка склада», «Мячей: 12» и ReferenceError. После второго — ещё «Поводков: 5» и TypeError. В конце — пять сообщений без ошибок: «Проверка склада», «Мячей: 12», «Поводков: 5», «Канатов: 3», «Склад проверен.». Объясните, почему при первом запуске не появилось даже первое сообщение.
Выполните задание
Условие задания
index.html
<html lang="ru">
<head>
<meta charset="utf-8">
<title>Три вида ошибок</title>
</head>
<body>
<h1>Проверка программы</h1>
<script src="script.js"></script>
</body>
</html>
script.js
console.log("Проверка склада");
console.log("Мячей: 12";
consol.log("Поводков: 5");
console.lgo("Канатов: 3");
console.log("Склад проверен.");
Нажмите , чтобы запустить пример.
Подсказка
Синтаксическая ошибка мешает разобрать весь файл: проверьте парность скобок. ReferenceError означает, что имя не найдено, — сравните его по буквам с console. TypeError с пояснением «is not a function» указывает на неверное имя команды после точки.
Задание со звёздочкой: что не так?
Запустите код. Почему вместо сообщения появляется ошибка? Найдите причину и исправьте программу.
index.html
<html lang="ru">
<head>
<meta charset="utf-8">
<title>Задание со звёздочкой: что не так?</title>
</head>
<body>
<h1>Проверка программы</h1>
<script src="script.js"></script>
</body>
</html>
script.js
сonsole.log('Задание со звездочкой. Что не так?');
Нажмите , чтобы запустить пример.
Подсказка
В имени сonsole первая буква — кириллическая с, а нужна латинская c.
Они выглядят почти одинаково, но для JavaScript это разные символы. Поэтому сonsole и
console — разные имена: первое не определено, и возникает ReferenceError.
Переключите раскладку на английскую и замените первую букву. Правильная запись:
console.log('Задание со звездочкой. Что не так?');.
Кириллица в тексте сообщения внутри кавычек допустима — её менять не нужно.