Структура кода

Программа состоит из отдельных инструкций – действий, которые JavaScript выполняет одно за другим. В простом коде выполнение идёт сверху вниз: сначала первая инструкция, затем вторая, затем третья.

Движок идёт по инструкциям как по списку дел: закончил одну – перешёл к следующей.

Точка с запятой

Инструкции мы будем заканчивать точкой с запятой ;. JavaScript во многих случаях умеет обходиться и без неё – движок мысленно добавит её сам, – но существуют исключения, к которым вернёмся позже, когда вы будете знать больше синтаксиса. В курсе пишем ; явно – так код читается однозначнее.

Для движка разницы нет – обе программы работают одинаково:

с точкой с запятой
console.log('раз');console.log('два');
без неё
console.log('раз')console.log('два')
Оба варианта работают – в курсе придерживаемся единого стиля: с точкой с запятой.

Комментарии

Комментарий – текст для людей, движок его полностью пропускает. Однострочный начинается с // и живёт до конца строки – его удобно писать и после кода, в той же строке. Многострочный открывается /* и закрывается */ – может занимать сколько угодно строк.

Выбор между ними простой: короткую пометку в одну строку пишут через //, а когда пояснение занимает несколько строк – через /* ... */, чтобы не начинать каждую строку заново.

comments.jsjs
// однострочный: до конца строкиconsole.log('раз'); // можно и после кода/* многострочный:   сколько угодно строк */console.log('два');
Консоль
раз
два
Обе инструкции выполнятся – комментарии для движка невидимы.

В реальном коде особенно полезны комментарии, которые объясняют, почему принято то или иное решение. Пересказывать каждую очевидную строку обычно не нужно:

Объясняет решение
// порог 1000 – из договора с курьерской службойconsole.log('Бесплатно от 1000 ₽');
Пересказывает строку
// выводим сообщение о доставкеconsole.log('Бесплатно от 1000 ₽');

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

debug.jsjs
console.log('раз');// console.log('два');console.log('три');
Консоль
раз
три
Вторая строка выключена комментарием – в консоли только первая и третья.

Код должен быть читаемым

Пустые строки и отступы помогают увидеть структуру программы. В наших простых примерах они не меняют результат:

blank.jsjs
console.log('раз');console.log('два');
Консоль
раз
два

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

groups.jsjs
// приветствиеconsole.log('Привет!');console.log('Это курс JavaScript.');// счётconsole.log(2 + 2);console.log(10 - 3);
Консоль
Привет!
Это курс JavaScript.
4
7
Для движка это одна цепочка инструкций, но читатель сразу видит, где приветствие, а где счёт.

// теперь вы знаете

  1. В простом коде инструкции выполняются сверху вниз, одна за другой
  2. Простые инструкции в курсе заканчиваем ; и обычно пишем с новой строки
  3. // и / ... / создают комментарии – JavaScript их не выполняет
  4. Пустые строки и отступы помогают человеку видеть структуру программы

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

Что изменится, если в простой программе из нескольких console.log убрать все точки с запятой?

Отметьте корректные комментарии JavaScript.

Выбери все верные варианты

Какой комментарий полезнее в реальном коде?

переключают уроки · не работают при фокусе в полях ввода