Комментарии в JavaScript
Вы уже умеете писать инструкции и значения с аккуратным синтаксисом. Этот урок добавляет то, что движок пропускает: комментарии — заметки для вас и других людей, читающих код.
Что такое комментарии в JavaScript и как их писать?
Комментарий — текст, который движок JavaScript игнорирует. Он не меняет поведение программы. Используйте // для заметки до конца этой строки или /* … */ для заметки на одну или несколько строк. Комментарии объясняют зачем, оставляют напоминания или временно отключают строку при проверке.
Формы комментариев кратко
📊 Как новичкам использовать комментарии
| Форма | Пример | Когда использовать |
|---|---|---|
Одна строка // |
// Показать приветствие |
Короткая заметка над строкой или в её конце |
Несколько строк /* */ |
/* несколько строк заметок */ |
Более длинное объяснение или сразу несколько строк |
| После кода | console.log(x); // временная проверка |
Маленькое напоминание рядом с инструкцией |
| Отключить строку | // console.log(x); |
Временно остановить инструкцию, не удаляя её |
| Не для движка | (любой комментарий) | Посетители не «запускают» ваши комментарии — их читают люди |
Однострочные комментарии с //
Всё от // до конца этой строки — комментарий. Код перед // в той же строке всё ещё выполняется.
console.log("Hello"); // приветствие для Console
console.log(42); // числовой литерал
Можно поставить // отдельно на своей строке — над описываемой инструкцией.
// Вывести короткое сообщение о статусе
console.log("Ready");
Многострочные комментарии с / /
Начните с /* и закончите */. Всё между ними игнорируется — даже на нескольких строках.
/*
Демо: один раз поприветствовать посетителя.
Для новичков держите это коротко.
*/
console.log("Welcome");
Временно отключить код
Закомментировать строку — привычка при отладке: код остаётся в файле, но не выполняется, пока вы не уберёте комментарий.
console.log("This runs");
// console.log("This stays quiet");
console.log("This also runs");
Тиха только средняя строка. Уберите //, когда снова нужен этот лог.
Комментарии рядом с обновлением страницы
Короткий комментарий зачем помогает будущему вам, когда инструкция обновляет страницу. Сам комментарий на странице не появляется.
<!DOCTYPE html>
<html>
<head>
<title>Comments — Page note</title>
</head>
<body>
<h1 id="msg">Waiting…</h1>
<script>
// Показать понятный статус после запуска скрипта
document.getElementById("msg").textContent = "Comments help humans";
</script>
</body>
</html>
Текст заголовка берётся из строкового литерала. Строка // — только для читателей исходника.
Попробуйте сами
- Добавьте заметку
//надconsole.logи ещё одну в конце той же строки; запустите и убедитесь, что логи всё ещё появляются. - Оберните двухстрочное пояснение в
/* */над логом; измените текст комментария — вывод должен остаться тем же. - Закомментируйте одну из трёх строк
console.logчерез//, запустите, затем верните. - Откройте HTML-демо; измените только текст комментария; обновите и убедитесь, что текст заголовка не изменился.
- Напишите комментарий, который говорит зачем (например «временная проверка»), а не повторяет код дословно.
Частые ошибки
- Забыть закрывающий
*/после/*— последующий код может оказаться внутри комментария - Ждать, что
//продолжится на следующей строке (он заканчивается в конце строки) - Неосторожно вкладывать
/* … /* … */ … */— многострочные комментарии не вкладываются безопасно - Комментарии, которые только пересказывают код, вместо полезного «зачем»
- Путать с синтаксисом (литералы и имена) или ждать уже урок переменных — комментарии это заметки, не хранилище
Итог
- Комментарии для людей; движок их игнорирует
//покрывает остаток одной строки/* */может покрывать одну или много строк- Используйте для «зачем», напоминаний и временного отключения — не для шума
- Дальше: переменные — имена, которые хранят значения для повторного использования
🧠 Проверьте Свои Знания
Проверьте Свои Знания
Бросьте себе вызов с помощью этой интерактивной викторины и узнайте, насколько хорошо вы понимаете тему
📝 Инструкции
- Внимательно прочитайте каждый вопрос
- Выберите лучший ответ на каждый вопрос
- Вы можете пересдавать тест столько раз, сколько захотите
- Ваш прогресс будет показан вверху