Merge pull request #1 from javascript-tutorial/master

merge with master repo

Author: Ruala

1-js/01-getting-started/4-devtools/article.md

@@ -44,7 +44,7 @@ Chrome и Firefox снискали любовь подавляющего бол
 
 Инструменты разработчика в большинстве браузеров открываются при нажатии на `key:F12`.
 
-Их внешний вид и принципы работы мало, чем отличаются. Разобравшись с инструментами в одном браузере, вы без труда сможете работать с ними и в другом.
+Их внешний вид и принципы работы мало чем отличаются. Разобравшись с инструментами в одном браузере, вы без труда сможете работать с ними и в другом.
 
 ## Safari
 

1-js/02-first-steps/05-types/article.md

@@ -10,7 +10,7 @@ message = 123456;
 
 Языки программирования, в которых такое возможно, называются "динамически типизированными". Это значит, что типы данных есть, но переменные не привязаны ни к одному из них.
 
-Есть семь основных типов данных в JavaScript. В этой главе мы рассмотрим их в общем, а в следующих главах поговорим подробнее о каждом.
+Есть восемь основных типов данных в JavaScript. В этой главе мы рассмотрим их в общем, а в следующих главах поговорим подробнее о каждом.
 
 ## Число
 
@@ -62,6 +62,25 @@ n = 12.345;
 
 Подробнее о работе с числами мы поговорим в главе  <info:number>.
 
+## BigInt
+
+В JavaScript тип "number" не может содержать числа больше, чем <code>2<sup>53</sup></code> (или меньше, чем <code>-2<sup>53</sup></code> для отрицательных). Это техническое ограничение вызвано их внутренним представлением. <code>2<sup>53</sup></code> - это достаточно большое число, состоящее из 16 цифр, поэтому чаще всего проблем не возникает. Но иногда нам нужны действительно гигантские числа, например в криптографии или при использовании метки времени ("timestamp") с микросекундами.
+
+Тип `BigInt` был добавлен в JavaScript, чтобы дать возможность работать с целыми числами произвольной длины.
+
+Чтобы создать значение типа `BigInt`, необходимо добавить `n` в конец числового литерала:
+
+```js
+// символ "n" в конце означает, что это BigInt
+const bigInt = 1234567890123456789012345678901234567890n;
+```
+
+Так как `BigInt` числа нужны достаточно редко, мы рассмотрим их в отдельной главе <info:bigint>.
+
+```smart header="Поддержка"
+В данный момент `BigInt` поддерживается только в браузерах Firefox и Chrome, но не поддерживается в Safari/IE/Edge.
+```
+
 ## Строка
 
 Строка (`string`) в JavaScript должна быть заключена в кавычки.
@@ -80,7 +99,7 @@ let phrase = `Обратные кавычки позволяют встраив
 
 Двойные или одинарные кавычки являются "простыми", между ними нет разницы в JavaScript.
 
-Обратные кавычки же имеют "расширенный функционал". Они позволяют нам встраивать выражения в строку, заключая их в `${…}`. Например:
+Обратные кавычки же имеют "расширенную функциональность". Они позволяют нам встраивать выражения в строку, заключая их в `${…}`. Например:
 
 ```js run
 let name = "Иван";
@@ -94,7 +113,7 @@ alert( `результат: *!*${1 + 2}*/!*` ); // результат: 3
 
 Выражение внутри `${…}` вычисляется, и его результат становится частью строки. Мы можем положить туда всё, что угодно: переменную `name` или выражение `1 + 2`, или что-то более сложное.
 
-Обратите внимание, что это можно делать только в обратных кавычках. Другие кавычки не имеют такого функционала встраивания!
+Обратите внимание, что это можно делать только в обратных кавычках. Другие кавычки не имеют такой функциональности встраивания!
 ```js run
 alert( "результат: ${1 + 2}" ); // результат: ${1 + 2} (двойные кавычки ничего не делают)
 ```
@@ -198,6 +217,8 @@ typeof undefined // "undefined"
 
 typeof 0 // "number"
 
+typeof 10n // "bigint"
+
 typeof true // "boolean"
 
 typeof "foo" // "string"
@@ -226,9 +247,10 @@ typeof alert // "function"  (3)
 
 ## Итого
 
-В JavaScript есть 7 основных типов.
+В JavaScript есть 8 основных типов.
 
-- `number` для любых чисел: целочисленных или чисел с плавающей точкой.
+- `number` для любых чисел: целочисленных или чисел с плавающей точкой, целочисленные значения ограничены диапазоном ±2<sup>53</sup>.
+- `bigint` для целых чисел произвольной длины.
 - `string` для строк. Строка может содержать один или больше символов, нет отдельного символьного типа.
 - `boolean` для `true`/`false`.
 - `null` для неизвестных значений -- отдельный тип, имеющий одно значение `null`.

1-js/02-first-steps/09-alert-prompt-confirm/article.md

@@ -107,4 +107,4 @@ alert( isBoss ); // true, если нажата OK
 1. Расположение окон определяется браузером. Обычно окна находятся в центре.
 2. Визуальное отображение окон зависит от браузера, и мы не можем изменить их вид.
 
-Такова цена простоты. Есть другие способы показать более приятные глазу окна с богатым функционалом для взаимодействия с пользователем, но если "навороты" не имеют значения, то данные методы работают отлично.
+Такова цена простоты. Есть другие способы показать более приятные глазу окна с богатой функциональностью для взаимодействия с пользователем, но если "навороты" не имеют значения, то данные методы работают отлично.

1-js/03-code-quality/05-testing-mocha/article.md

@@ -51,7 +51,7 @@ describe("pow", function() {
 Спецификация состоит из трёх основных блоков:
 
 `describe("заголовок", function() { ... })`
-: Какой функционал мы описываем. В нашем случае мы описываем функцию `pow`. Используется для группировки рабочих лошадок -- блоков `it`.
+: Какую функциональность мы описываем. В нашем случае мы описываем функцию `pow`. Используется для группировки рабочих лошадок -- блоков `it`.
 
 `it("описание", function() { ... })`
 : В первом аргументе блока `it` мы *человеческим языком* описываем конкретный способ использования функции, а во втором -- пишем функцию, которая тестирует данный случай.
@@ -73,7 +73,7 @@ describe("pow", function() {
 4. Теперь у нас есть правильно работающая начальная реализация и тесты.
 5. Мы добавляем новые способы использования в спецификацию, возможно, ещё не реализованные в тестируемом коде. Тесты начинают "падать" (выдавать ошибки).
 6. Возвращаемся на шаг 3, дописываем реализацию до тех пор, пока тесты не начнут завершаться без ошибок.
-7. Повторяем шаги 3-6, пока требуемый функционал не будет готов.
+7. Повторяем шаги 3-6, пока требуемая функциональность не будет готова.
 
 Таким образом, разработка проходит *итеративно*. Мы пишем спецификацию, реализуем её, проверяем, что тесты выполняются без ошибок, пишем ещё тесты, снова проверяем, что они проходят и т.д.
 
@@ -302,7 +302,7 @@ describe("тест", function() {
 
 ## Расширение спецификации
 
-Основной функционал `pow` реализован. Первая итерация разработки завершена. Когда мы закончим отмечать и пить шампанское, давайте продолжим работу и улучшим `pow`.
+Основная функциональность `pow` реализована. Первая итерация разработки завершена. Когда мы закончим отмечать и пить шампанское, давайте продолжим работу и улучшим `pow`.
 
 Как было сказано, функция `pow(x, n)` предназначена для работы с целыми положительными значениями `n`.
 

1-js/04-object-basics/01-object/article.md

@@ -103,7 +103,9 @@ let user = {
 user.likes birds = true
 ```
 
-Так происходит, потому что точка требует, чтобы ключ был именован по правилам именования переменных. То есть не имел пробелов, не начинался с цифры и не содержал специальные символы, кроме `$` и `_`.
+JavaScript видит, что мы обращаемся к свойству `user.likes`, а затем идёт непонятное слово `birds`. В итоге синтаксическая ошибка.
+
+Точка требует, чтобы ключ был именован по правилам именования переменных. То есть не имел пробелов, не начинался с цифры и не содержал специальные символы, кроме `$` и `_`.
 
 Для таких случаев существует альтернативный способ доступа к свойствам через квадратные скобки. Такой способ сработает с любым именем свойства:
 
@@ -208,42 +210,6 @@ let bag = {
 
 Подведём итог: в большинстве случаев, когда имена свойств известны и просты, используется запись через точку. Если же нам нужно что-то более сложное, то мы используем квадратные скобки.
 
-````smart header="Зарезервированные слова разрешено использовать как имена свойств"
-
-Имя переменной не может совпадать с зарезервированными словами, такими как "for", "let", "return" и т.д.
-
-Но для свойств объекта такого ограничения нет:
-
-```js run
-let obj = {
-  for: 1,
-  let: 2,
-  return: 3
-};
-
-alert( obj.for + obj.let + obj.return );  // 6
-```
-
-В принципе, разрешены любые имена свойств, но есть специальное свойство `__proto__`, которое по историческим причинам имеет  особое поведение. Например, его значение всегда должно быть объектом, и мы не можем установить для него никакое другое значение:
-
-```js run
-let obj = {};
-obj.__proto__ = 5;
-alert(obj.__proto__); // [object Object], работает не так, как мы ожидали
-```
-
-Как мы видим, присвоение примитивного значения `5` игнорируется.
-
-Это может стать источником ошибок и даже уязвимостей, если мы намереваемся хранить в объекте произвольные пары "ключ:значение" и позволяем посетителям указывать ключи.
-
-Посетитель может указать `__proto__` в качестве ключа, и логика присваивания будет нарушена (как показано выше).
-
-Есть способ заставить объекты обрабатывать `__proto__` как обычное свойство. Мы поговорим о нём позже, а пока нам нужно узнать больше об объектах.
-
-Также существует другая структура данных [Map](info:map-set), которая поддерживает произвольные ключи. Мы изучим её в главе <info:map-set>.
-````
-
-
 ## Свойство из переменной
 
 В реальном коде часто нам необходимо использовать существующие переменные как значения для свойств с тем же именем.
@@ -288,7 +254,61 @@ let user = {
 };
 ```
 
-## Проверка существования свойства
+## Ограничения на имена свойств
+
+Мы можем использовать только строки и символы в качестве ключей свойств. Все другие типы данных будут автоматически преобразованы к строке.
+
+Например, если использовать как ключ число `0`, то оно превратится в строку `"0"`:
+
+```js run
+let obj = {
+  0: "Тест" // то же самое что и "0": "Тест"
+};
+
+// обе функции alert выведут одно и то же свойство (число 0 преобразуется в строку "0")
+alert( obj["0"] ); // Тест
+alert( obj[0] ); // Тест (то же свойство)
+```
+
+**Зарезервированные слова разрешено использовать как имена свойств.**
+
+Как мы уже знаем, имя переменной не может совпадать с зарезервированными словами, такими как "for", "let", "return" и т.д.
+
+Но для свойств объекта такого ограничения нет:
+
+```js run
+let obj = {
+  for: 1,
+  let: 2,
+  return: 3
+};
+
+alert( obj.for + obj.let + obj.return );  // 6
+```
+
+**В принципе, разрешены любые имена свойств, но есть специальное свойство `__proto__`, которое по историческим причинам имеет  особое поведение.**
+
+Например, его значение всегда должно быть объектом:
+
+```js run
+let obj = {};
+obj.__proto__ = 5;
+alert(obj.__proto__); // [object Object], работает не так, как мы ожидали
+```
+
+Как мы видим, присвоение примитивного значения `5` игнорируется.
+
+Мы более подробно исследуем происходящее свойство `__proto__` позже, в главе [](info:prototype-inheritance).
+
+Сейчас важно знать, что такое поведение `__proto__` может стать источником ошибок и даже уязвимостей, если мы намереваемся хранить в объекте произвольные данные и позволяем посетителям указывать ключи.
+
+Посетитель может указать `"__proto__"` в качестве ключа, и логика присваивания будет нарушена (как показано выше).
+
+Позже мы изучим, как обойти эту проблему:
+1. Можно заставить объект обрабатывать `__proto__` как обычное свойство, мы это увидим в главе [](info:prototype-methods).
+2. Есть другая структура данных [Map](info:map-set), которую мы изучим в главе <info:map-set>, она поддерживает произвольные ключи.
+
+## Проверка существования свойства, оператор "in"
 
 Особенность объектов в том, что можно получить доступ к любому свойству. Даже если свойства не существует - ошибки не будет! При обращении к свойству, которого нет, возвращается `undefined`. Это позволяет просто проверить существование свойства - сравнением его с `undefined`: