Комментарии.

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

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

Var accountBalance = calculateBalance(account);

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

AccountBalance.adjust();

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

Var report = new Report();

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

AddToReport(accountBalance, report);

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

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

/*

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

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

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

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

*/

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