12.1. Финальная проверка вместо новой функции

Одиннадцать уроков позади. Игра умеет считать клики, показывать случайное сообщение, менять уровень магии, рассыпать искры и сбрасываться по кнопке. Новых возможностей в этом уроке не появится. Появится то, без чего не обходится ни один настоящий проект: умение находить ошибки и приводить код в порядок.

Ошибка — это не признак того, что «я плохой программист». Это обычная часть работы: код почти никогда не работает с первого раза. Разница между новичком и опытным автором не в том, что второй не ошибается, а в том, что он быстрее понимает, где именно ошибка. Браузер уже знает ответ — он пишет его в консоль.

Сегодня мы научимся трём вещам: читать сообщение об ошибке, находить её место в файле и проверять игру по чек-листу. А в конце разложим проект на три файла — так, как это делают настоящие сайты.

Меняй по одной вещи. Если править пять мест сразу, после ошибки будет непонятно, какая из пяти правок её вызвала. Изменил строку — сохранил, обновил, проверил. Работает — идёшь дальше.

12.2. Консоль: где браузер говорит с тобой

Консоль открывается клавишей F12 или сочетанием Ctrl+Shift+I. На вкладке Console появляются три вида сообщений: обычные (их печатает console.log), предупреждения (жёлтые) и ошибки (красные). Ошибка — самая полезная строка на экране, потому что в ней указано, что случилось и где.

Uncaught TypeError: Cannot read properties of null (reading 'textContent')
    at magicClick (script.js:42:13)

Читать такую запись нужно по частям. TypeError — тип ошибки: код обратился к значению неподходящего типа. Cannot read properties of null — попытка прочитать свойство у null, то есть у «ничего». reading 'textContent' — какое именно свойство читали. Вторая строка указывает файл script.js, строку 42 и столбец 13, а в скобках — функцию magicClick, во время которой это произошло.

Слово Uncaught означает «не поймана»: ошибка не была обработана и остановила выполнение скрипта. Строка at magicClick (script.js:42:13) — ссылка: нажми на неё, и браузер откроет вкладку Sources на нужной строке. Это самый быстрый путь от сообщения к месту в коде.

Кроме ошибок, в консоль можно печатать свои сообщения: console.log выводит текст, console.warn — жёлтое предупреждение, console.error — красную ошибку. Для отладки удобнее всего первый: он не мешает странице и не останавливает игру.

12.3. Ошибка null: элемент не найден

Самая частая ошибка в нашем проекте выглядит так. В разметке сообщение имеет id="magicMessage", а в скрипте набрано #magicMesage — с пропущенной буквой «s». querySelector ищет элемент, не находит и возвращает null. Следующая строка пытается записать текст в это «ничего» — и скрипт останавливается.

const message = document.querySelector("#magicMesage");
message.textContent = "✨ Магия сработала!";

В консоли появится уже знакомая запись Cannot read properties of null или Cannot set properties of null — разница только в том, читали свойство или записывали. Причина одна: элемент с таким именем не найден. Обрати внимание: сама строка с querySelector ошибки не вызывает. Ошибка случается на следующей строке, когда код трогает null.

Как найти виновника за минуту: напиши console.log(message) сразу после поиска — в консоли будет null; открой Elements, найди нужный элемент и скопируй его id оттуда; сравни имена посимвольно, потому что magicButton и magicButon глаз почти не различает.

Ошибка в одном символе Если консоль говорит про null, не ищи причину в CSS и не переписывай обработчик. Сначала проверь имя: в разметке — id, в скрипте — селектор. Совпадение должно быть точным, включая регистр букв.

12.4. Скрипт, который выполнился слишком рано

Браузер читает файл сверху вниз. Встретил разметку — построил элемент. Встретил скрипт — сразу выполнил его. Поэтому место скрипта в документе важно не меньше самого кода. Если поставить его в head, он выполнится раньше, чем появится body с кнопкой, и любой поиск вернёт null.

<head>
  <script src="script.js"></script>
</head>
<body>
  <button id="magicButton">✨ МАГИЯ! ✨</button>
</body>

В такой странице скрипт начнёт работать, когда кнопки ещё нет. Ошибка будет та же самая — Cannot read properties of null, хотя сам код написан правильно. Лечится это переносом строки в конец body, после всей разметки:

<body>
  <button id="magicButton">✨ МАГИЯ! ✨</button>
  <script src="script.js"></script>
</body>

В нашем проекте скрипт стоит в конце body с урока 7. Не переноси его в head «для порядка»: именно этот порядок делает код рабочим.

Порядок — часть программы Один и тот же скрипт работает в конце body и не работает в head. Прежде чем искать ошибку в коде, посмотри, где стоит тег script и что находится выше него.

12.5. Забытые скобки: вызов вместо ссылки

Скобки после имени функции означают «выполни её сейчас». Без скобок имя означает «вот эта функция, выполни её позже». В обработчике события нужен второй вариант: мы передаём функцию браузеру, чтобы он вызвал её при клике.

// правильно: передаём функцию, браузер вызовет её при клике
button.addEventListener("click", magicClick);

// неправильно: функция выполнится сразу, а обработчик получит undefined
button.addEventListener("click", magicClick());

Во втором случае при загрузке страницы magicClick сработает один раз, а на клики кнопка не отреагирует. Ошибки в консоли может не быть вовсе — именно поэтому такую поломку трудно заметить. Если кнопка «молчит», проверь скобки в addEventListener.

Другая ошибка со скобками — незакрытая фигурная скобка. Браузер не может понять, где заканчивается функция, и сообщает:

Uncaught SyntaxError: Unexpected end of input

Такая запись означает, что файл закончился раньше, чем браузер дочитал конструкцию. Синтаксическая ошибка отключает весь файл целиком: не выполнится ни одна строка, даже правильная.

Синтаксис важнее логики Пока в файле не закрыта скобка или кавычка, браузер не станет разбираться в логике. Сначала добейся, чтобы консоль была пустой, и только потом проверяй, правильно ли игра считает клики.

12.6. Кириллица: буква, которой не видно

В русской раскладке есть буквы, которые выглядят почти как латинские: с и c, о и o, е и e, а и a, р и p, х и x. В шрифте редактора разница бывает незаметна, а для браузера это совершенно разные символы.

Правило простое: всё, что является частью кода — имена тегов, классов, id, переменных и функций, — пишется латиницей. Русские буквы допустимы только в тексте между тегами и в строковых значениях, которые видит игрок. Если сомневаешься, скопируй id из разметки в скрипт: копирование не переключает раскладку.

12.7. Файл не сохранён и старый кэш

Бывает, что ошибка уже исправлена, а страница показывает старое поведение. Проверь три вещи по порядку: файл сохранён (в заголовке вкладки редактора нет точки вместо крестика), открыт тот файл и та папка, страница обновлена после сохранения.

Иногда и это не помогает: браузер хранит копии файлов в кэше. Для страницы с диска кэш обновляется обычно сам, но CSS и JavaScript могут остаться старыми. Жёсткое обновление — Ctrl+F5 — загружает файлы заново, без копии из кэша.

Вкладка Network Открой F12 → Network и обнови страницу. Ты увидишь список файлов, которые загрузил браузер: index.html, style.css, script.js. Если нужного файла нет или у него красный статус, проблема в имени или пути, а не в коде. Галочка Disable cache на этой вкладке отключает кэш, пока инструменты открыты.

12.8. Elements: посмотреть, что на самом деле на странице

Вкладка Elements показывает не файл, а построенное дерево страницы: какие элементы существуют на самом деле, как вложены и какие у них атрибуты. Это лучший способ проверить id — прочитать имя в дереве, а не по памяти. Кнопка со стрелкой (или Ctrl+Shift+C) включает выбор элемента: щёлкни по кнопке на странице, и в дереве подсветится её строка.

Правки в Elements живут до обновления страницы, а файл на диске не меняется. Панель — микроскоп, а не редактор: рассматривать можно, лечить нужно в файле.

12.9. Sources и точки останова

Вкладка Sources показывает файлы проекта и позволяет остановить выполнение кода в выбранной строке. Нажми на номер строки слева — появится синяя метка, точка останова. Обнови страницу и нажми на кнопку: браузер остановится перед этой строкой, а справа будут видны значения переменных. Дальше F10 выполняет следующую строку, F8 продолжает до конца. Вместо метки можно временно вставить в код строку debugger;, но не забывай её удалять.

12.10. Три файла вместо одного

До сих пор весь проект лежал в одном index.html: разметка, стили в <style> и скрипт в <script>. Пока файл короткий, это удобно. Но в финальной игре больше двухсот строк, и найти в них нужное правило становится трудно. Настоящие сайты разделяют ответственность между файлами.

C:\magic-button\
    index.html
    style.css
    script.js

index.html хранит только разметку. style.css — только оформление. script.js — только поведение. Каждый файл открывается отдельно, и ошибка в консоли сразу говорит, в каком из них её искать: style.css:87 или script.js:42.

Файлы нужно подключить. Таблица стилей — в head, чтобы оформление было готово до появления элементов. Скрипт — в конце body, после разметки:

<head>
  <title>Волшебная кнопка</title>
  <link rel="stylesheet" href="style.css">
</head>
<body>
  ...разметка игры...
  <script src="script.js"></script>
</body>

У стилей адрес задаёт href, у скрипта — src. Путь "style.css" означает «файл лежит рядом с этой страницей»; если положить его в подпапку, путь изменится. Внутри отдельных файлов не нужны теги <style> и <script>: там пишется только содержимое.

12.11. Живой пример: код пишет в консоль

Посмотрим на связь «код → консоль» в действии. Открой F12, перейди на вкладку Console и нажми на кнопку в примере. Каждый клик будет добавлять в консоль строку: номер клика и случайное сообщение. На самой карточке тоже видно число кликов — так удобно, когда консоль закрыта.

Кликов в примере
0
Открой консоль и нажми на кнопку
Пример пишет в консоль через console.log. В реальном проекте такие строки можно оставить на время отладки, а перед сдачей — убрать или закомментировать.

Обрати внимание: console.log не меняет страницу. Он нужен, чтобы заглянуть внутрь программы, как в окно. Если сообщение в консоли есть, значит код до этой строки дошёл. Если сообщения нет, значит выполнение остановилось раньше — и консоль подскажет где.

12.12. Чек-лист финальной игры

Готовую игру проверяют по списку, а не «на глаз». Пройди пункты по порядку и отметь каждый. Если пункт не выполняется, вернись к нужному уроку.

  1. Файл открывается в браузере, вкладка называется «Волшебная кнопка», в папке лежат три файла.
  2. Стили подключены в head, скрипт — в конце body.
  3. Консоль при загрузке пустая: ошибок нет.
  4. Кнопка «✨ МАГИЯ! ✨» реагирует на наведение и нажатие.
  5. После клика число заклинаний увеличивается на единицу.
  6. Сообщение под кнопкой меняется и берётся из массива.
  7. Уровень совпадает с числом кликов на границах 5, 10, 20, 30 и 50.
  8. Искры появляются и исчезают примерно через секунду.
  9. Кнопка сброса спрашивает подтверждение и обнуляет игру.
  10. На числах 10, 25 и 50 появляется поздравление.

12.13. Итог урока

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

Главный вывод урока Ошибка — это не случайность, а сообщение с адресом. Браузер всегда говорит, что случилось и в какой строке; задача программиста — прочитать это сообщение и проверить указанное место. А порядок в проекте из трёх файлов делает такую проверку быстрой.

Что дальше

Игра готова, но её не обязательно оставлять такой. Самое интересное начинается, когда ты добавляешь то, чего в курсе не было. Вот несколько идей, которые работают с теми же тремя файлами.

Каждая доработка — это снова цикл «правка → сохранение → проверка в консоли». Если что-то сломается, начни с консоли: она подскажет файл и строку быстрее любого учебника.