Автоматическая вставка точки с запятой

Определение и применение

JavaScript разрешает не ставить точку с запятой в конце инструкции: при разборе он сам вставляет её по правилам (англ. automatic semicolon insertion, ASI). Вставка зависит от синтаксиса, поэтому перенос строки не всегда завершает инструкцию.

Объяснение на задачах — в уроке учебника «Инструкции и комментарии».

Правила

Если следующий токен не допускается грамматикой, ASI может вставить ; перед ним при наличии перевода строки либо перед }. Отдельно учитывается конец do...while. В конце исходного текста ; добавляется, если без него программа не разбирается. Это не безусловная вставка на каждом переносе или перед каждой закрывающей скобкой.

Есть места с запретом перевода строки: после return перед значением, после break/continue перед меткой, после yield перед операндом, перед постфиксными ++/--. Перенос меняет разбор: например, return заканчивается без значения. Перенос после throw или перед => даёт SyntaxError, а не полезное автоматическое завершение. Перенос между async и function может превратить async в отдельное выражение.

ASI не вставляет две разделяющие точки с запятой в заголовке for и не создаёт пустую инструкцию как отсутствующее тело if. Поэтому автоматическая вставка не исправляет любой синтаксически неверный код.

Ловушки

Запись, Что происходит
ЗаписьЧто происходит
return и значение на следующей строкефункция возвращает undefined
строка, начинающаяся с (склеивается с предыдущей: вызов как функции
строка, начинающаяся с [склеивается с предыдущей: доступ к свойству
строка, начинающаяся с обратной кавычкипредыдущее выражение становится тегом шаблонной строки
throw и значение на следующей строкеSyntaxError

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

Опасны также строки, начинающиеся с +, - или /: они могут продолжить арифметическое выражение вместо начала новой инструкции. Это касается и литерала регулярного выражения. В примере ниже сообщение ошибки зависит от браузера, поэтому выводится только её имя.

Разберите пример «return и стрелка с переносом» и сравните результат после предложенного изменения.

Примеры

Запустите примеры: Строка со скобки. Затем измените предложенные значения и сравните вывод.

Строка со скобки

Вывод: скидка — первая пара строк разделена ;, затем TypeError — вторая пара склеилась в вызов price(...). Добавьте точку с запятой после const total = price: вторая функция тоже выполнится.

index.html
HTML
<!doctype html>
<html lang="ru">
<head>
  <meta charset="utf-8">
  <title>Строка со скобки</title>
</head>
<body>
  <script src="main.js"></script>
</body>
</html>
main.js
JavaScript
try {
  const price = 120
  ;(() => console.log("скидка"))()
  const total = price
  (() => console.log("не выполнится"))()
} catch (error) {
  console.log(error.name);
}

return и стрелка с переносом

Вывод: undefined и 120. Перенесите значение после return на ту же строку: появятся два 120. Затем перенесите => на новую строку после value: программа перестанет разбираться с SyntaxError.

index.html
HTML
<!doctype html>
<html lang="ru">
<head>
  <meta charset="utf-8">
  <title>return и стрелка с переносом</title>
</head>
<body>
  <script src="main.js"></script>
</body>
</html>
main.js
JavaScript
function read() {
  return
  120;
}
const arrow = value => value;
console.log(read());
console.log(arrow(120));

Спецификация

ECMAScript: Automatic Semicolon Insertion.