Комментарии

Часто код не содержит всю информацию, которую хотелось бы передать читателям-людям, или доносит её в непонятном виде. Иногда вы чувствуете поэтическое вдохновение, или просто хотите поделиться мыслями в своей программе. Для этого служат комментарии.

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

var accountBalance = calculateBalance(account);

// Издалека долго

accountBalance.adjust();

// Течёт река Волга

var report = new Report();

// Течёт река Волга

addToReport(accountBalance, report);

// Конца и края нет

Комментарий продолжается только до конца строки. Код между символами /* и */ будет игнорироваться вместе с возможными переводами строки. Это подходит для включения целых информационных блоков в программу:

/*

Этот город – самый лучший

Город на Земле.

Он как будто нарисован

Мелом на стене.

*/

var myCity = 'Челябинск';