You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: 1-js/02-first-steps/02-structure/article.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,7 +34,7 @@ alert('Привет')
34
34
alert('Мир')
35
35
```
36
36
37
-
В этом случае JavaScript интерпретирует перенос строки как "неявную" точку с запятой. Это называется [автоматическая вставка точки с запятой](https://tc39.github.io/ecma262/#sec-automatic-semicolon-insertion).
37
+
В этом случае JavaScript интерпретирует перенос строки, как "неявную" точку с запятой. Это называется [автоматическая вставка точки с запятой](https://tc39.github.io/ecma262/#sec-automatic-semicolon-insertion).
38
38
39
39
**В большинстве случаев новая строка подразумевает точку с запятой. Но "в большинстве случаев" не значит "всегда"!**
40
40
@@ -46,7 +46,7 @@ alert(3 +
46
46
+2);
47
47
```
48
48
49
-
Код выведет `6` потому что JavaScript не вставляет здесь точку с запятой. Интуитивно очевидно, что если строка заканчивается знаком `"+"`, значит это "незавершённое выражение", поэтому точка с запятой не требуется. И в этом случае всё работает как задумано.
49
+
Код выведет `6`, потому что JavaScript не вставляет здесь точку с запятой. Интуитивно очевидно, что, если строка заканчивается знаком `"+"`, значит, это "незавершённое выражение", поэтому точка с запятой не требуется. И в этом случае всё работает, как задумано.
50
50
51
51
**Но есть ситуации, где JavaScript "забывает" вставить точку с запятой там, где она нужна.**
52
52
@@ -59,7 +59,7 @@ alert(3 +
59
59
[1, 2].forEach(alert)
60
60
```
61
61
62
-
Пока нет необходимости знать значение скобок `[]` и `forEach`. Мы изучим их позже. Пока что, просто запомните результат выполнения этого кода: выводится `1`, а затем `2`.
62
+
Пока нет необходимости знать значение скобок `[]` и `forEach`. Мы изучим их позже. Пока что просто запомните результат выполнения этого кода: выводится `1`, а затем `2`.
63
63
64
64
А теперь добавим `alert` перед кодом и *не* поставим в конце точку с запятой:
65
65
@@ -81,26 +81,26 @@ alert("Теперь всё в порядке");
81
81
Теперь мы получим сообщение "Теперь всё в порядке", следом за которым будут `1` и `2`.
82
82
83
83
84
-
В первом примере без точки с запятой возникает ошибка, потому что JavaScript не вставляет точку с запятой перед квадратными скобками `[...]`. И поэтому код в первом примере выполняется как одна инструкция. Вот как движок видит его:
84
+
В первом примере без точки с запятой возникает ошибка, потому что JavaScript не вставляет точку с запятой перед квадратными скобками `[...]`. И поэтому код в первом примере выполняется, как одна инструкция. Вот, как движок видит его:
85
85
86
86
```js run no-beautify
87
87
alert("Сейчас будет ошибка")[1, 2].forEach(alert)
88
88
```
89
89
90
-
Но это должны быть две отдельные инструкции, а не одна. Такое слияние, в данном случае, неправильное, от того и ошибка. Это может произойти и в некоторых других ситуациях.
90
+
Но это должны быть две отдельные инструкции, а не одна. Такое слияние в данном случае неправильное, оттого и ошибка. Это может произойти и в некоторых других ситуациях.
91
91
````
92
92
93
93
Мы рекомендуем ставить точку с запятой между инструкциями, даже если они отделены переносами строк. Это правило широко используется в сообществе разработчиков. Стоит отметить ещё раз -- в большинстве случаев *можно* опускать точку с запятой. Но безопаснее, особенно для новичка -- ставить её.
94
94
95
95
## Комментарии
96
96
97
-
Со временем программы становятся всё сложнее и сложнее. Возникает необходимость добавлять *комментарии*, которые бы описывали что делает код и почему.
97
+
Со временем программы становятся всё сложнее и сложнее. Возникает необходимость добавлять *комментарии*, которые бы описывали, что делает код и почему.
98
98
99
99
Комментарии могут находиться в любом месте скрипта. Они не влияют на его выполнение, поскольку движок просто игнорирует их.
100
100
101
101
**Однострочные комментарии начинаются с двойной косой черты `//`.**
102
102
103
-
Часть строки после `//` считается комментарием. Такой комментарий может как занимать строку целиком, так и находиться после инструкции.
103
+
Часть строки после `//` считается комментарием. Такой комментарий может, как занимать строку целиком, так и находиться после инструкции.
104
104
105
105
Как здесь:
106
106
@@ -135,7 +135,7 @@ alert('Мир');
135
135
```
136
136
137
137
```smart header="Используйте горячие клавиши!"
138
-
В большинстве редакторов строку кода можно закомментировать, нажав комбинацию клавиш `key:Ctrl+/` для однострочного комментария и что-то вроде `key:Ctrl+Shift+/` -- для многострочных комментариев (выделите кусок кода и нажмите комбинацию клавиш). В системе Mac попробуйте `key:Cmd` вместо `key:Ctrl`.
138
+
В большинстве редакторов строку кода можно закомментировать, нажав комбинацию клавиш `key:Ctrl+/` для однострочного комментария и что-то, вроде `key:Ctrl+Shift+/` -- для многострочных комментариев (выделите кусок кода и нажмите комбинацию клавиш). В системе Mac попробуйте `key:Cmd` вместо `key:Ctrl`.
139
139
```
140
140
141
141
````warn header="Вложенные комментарии не поддерживаются!"
@@ -153,6 +153,6 @@ alert( 'Мир' );
153
153
154
154
Не стесняйтесь использовать комментарии в своём коде.
155
155
156
-
Комментарии увеличивают размер кода, но это не проблема. Есть множество инструментов, которые минифицируют код перед публикацией на рабочий сервер. Они убирают комментарии, так что они не содержатся в рабочих скриптах. Таким образом, комментарии никаким образом не вредят рабочему коду.
156
+
Комментарии увеличивают размер кода, но это не проблема. Есть множество инструментов, которые минифицируют код перед публикацией на рабочий сервер. Они убирают комментарии, так что они не содержатся в рабочих скриптах. Таким образом, комментарии никоим образом не вредят рабочему коду.
157
157
158
158
Позже в учебнике будет глава <info:code-quality>, которая объяснит, как лучше писать комментарии.
0 commit comments