Консоль браузера и ошибки

Чтение — около 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
<!doctype html>
<html lang="ru">
<head>
  <meta charset="utf-8">
  <title>Консоль и ошибки</title>
</head>
<body>
  <h1>Проверка программы</h1>
  <script src="script.js"></script>
</body>
</html>
script.js
JavaScript
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: выполнить указанный вызов не получается. Смысл этих двух типов ошибок будем уточнять по мере знакомства с языком.

Ошибка в записи программы

Теперь рассмотрим синтаксическую ошибку — нарушение правил записи, из-за которого программа не может быть разобрана. Например, в строке ниже не закрыты кавычки:

JavaScript
console.log("Каталог готов.);

В следующем редакторе исходный код исправен. Запустите его, затем удалите закрывающую кавычку после «Каталог готов.» во второй команде и запустите снова.

Сравните два вида ошибки

Сначала выводятся три сообщения. После удаления закрывающей кавычки во второй команде появится SyntaxError, а сообщения этого запуска не появятся. Верните кавычку и запустите код ещё раз.

index.html
HTML
<!doctype html>
<html lang="ru">
<head>
  <meta charset="utf-8">
  <title>Консоль и ошибки</title>
</head>
<body>
  <h1>Проверка программы</h1>
  <script src="script.js"></script>
</body>
</html>
script.js
JavaScript
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').

Проверьте себя

Выберите ответ — объяснение появится сразу. Ответ можно менять.

1. Что означает ссылка script.js:2:1 рядом с ошибкой на локальной странице?
Показать ответ

Файл script.js, строка 2, позиция 1 — Ссылка указывает место в исходнике. Имя файла и номер строки помогают найти код для проверки.

2. В файле три команды. Во второй вы не закрыли кавычку и получили SyntaxError. Появится ли сообщение первой команды этого запуска?
Показать ответ

Нет: этот скрипт не сможет быть разобран до выполнения — Сначала разбирается весь скрипт. Синтаксическая ошибка в записи мешает начать выполнение его команд.

3. Что произойдёт в примере с Console.log() во второй строке?
Показать ответ

Первая команда выведет сообщение, на второй возникнет ошибка, третья не выполнится — Код допустим по форме, но при выполнении не найдено имя Console. Выполнение этого скрипта остановится на ошибке.

4. Вы нажали «Очистить консоль». Значит ли это, что ошибка исправлена?
Показать ответ

Нет: очищены записи, код остался прежним — Исправьте исходник, сохраните файл и запустите программу снова. Тогда проверьте сообщения нового запуска.

5. В консоли нет ошибок, но программа сообщает «Нет в наличии» вместо требуемого «Есть в наличии». Задание выполнено?
Показать ответ

Нет: нужно проверить ещё и соответствие результата задаче — Корректно записанная команда может выводить неверный по смыслу текст. Отсутствие ошибок не заменяет проверку результата.

Задание

Тони добавил в конец js/shop.js блок «Проверка склада» и допустил в нём две опечатки.

  1. Запустите исходный код, прочитайте первую ошибку и исправьте только её.
  2. После повторного запуска найдите и исправьте следующую ошибку.

Тексты и порядок сообщений не меняйте.

Ожидаемый результат

  • Сначала после сообщений магазина видны «Начало проверки» и ошибка.
  • После первого исправления появляется «Мячей на складе: 12», но остаётся вторая ошибка.
  • После второго исправления блок выводит три сообщения: «Начало проверки», «Мячей на складе: 12», «Проверка завершена.» — без ошибок.

Назовите обе опечатки и объясните, почему сразу не выполнялась последняя команда.

Выполните задание

js/shop.js
JavaScript
/*
  Лавка Тони: сообщения магазина.
  Выводим только готовые сообщения.
*/
console.log("Лавка Тони");
console.log("Мяч для прогулок");
console.log("Есть в наличии");
// Акция ещё не готова к показу.
// console.log("Черновик акции");
console.log("Магазин открыт.");

// Проверка склада
console.log("Начало проверки");
console.lgo("Мячей на складе: 12");
Console.log("Проверка завершена.");
pages/shop.html
HTML
<!doctype 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
<!doctype html>
<html lang="ru">
<head>
  <meta charset="utf-8">
  <title>Три вида ошибок</title>
</head>
<body>
  <h1>Проверка программы</h1>
  <script src="script.js"></script>
</body>
</html>
script.js
JavaScript
console.log("Проверка склада");
console.log("Мячей: 12";
consol.log("Поводков: 5");
console.lgo("Канатов: 3");
console.log("Склад проверен.");

Подсказка

Синтаксическая ошибка мешает разобрать весь файл: проверьте парность скобок. ReferenceError означает, что имя не найдено, — сравните его по буквам с console. TypeError с пояснением «is not a function» указывает на неверное имя команды после точки.

Задание со звёздочкой: что не так?

Запустите код. Почему вместо сообщения появляется ошибка? Найдите причину и исправьте программу.

index.html
HTML
<!doctype html>
<html lang="ru">
<head>
  <meta charset="utf-8">
  <title>Задание со звёздочкой: что не так?</title>
</head>
<body>
  <h1>Проверка программы</h1>
  <script src="script.js"></script>
</body>
</html>
script.js
JavaScript
сonsole.log('Задание со звездочкой. Что не так?');

Подсказка

В имени сonsole первая буква — кириллическая с, а нужна латинская c. Они выглядят почти одинаково, но для JavaScript это разные символы. Поэтому сonsole и console — разные имена: первое не определено, и возникает ReferenceError.

Переключите раскладку на английскую и замените первую букву. Правильная запись: console.log('Задание со звездочкой. Что не так?');. Кириллица в тексте сообщения внутри кавычек допустима — её менять не нужно.