Apply suggestions from code review

Правки, потерянные в git'е

Co-Authored-By: alfill <7522884+alfill@users.noreply.github.com>

Author: lex111

1-js/05-data-types/11-json/1-serialize-object/task.md

@@ -2,9 +2,9 @@ importance: 5
 
 ---
 
-# Превратите объект в JSON и верните обратно
+# Преобразуйте объект в JSON, а затем обратно в обычный объект
 
-Превратите `user` в JSON, затем прочитайте его в другую переменную.
+Преобразуйте `user` в JSON, затем поместите в новую переменную изначальный объект.
 
 ```js
 let user = {

1-js/05-data-types/11-json/article.md

@@ -1,6 +1,6 @@
 # Формат JSON, метод toJSON
 
-Допустим, у нас есть сложный объект, и мы хотели бы преобразовать его в строку, отправить по сети или просто вывести для логирования.
+Допустим, у нас есть сложный объект, и мы хотели бы преобразовать его в строку, чтобы отправить по сети или просто вывести для логирования.
 
 Естественно, такая строка должна включать в себя все важные свойства.
 
@@ -21,20 +21,20 @@ let user = {
 alert(user); // {name: "John", age: 30}
 ```
 
-...Но в процессе разработки добавляются новые свойства, старые свойства переименовываются и удаляются. Обновление такого `toString` каждый раз может стать проблемой. Мы могли бы попытаться зациклить свойства в нем, но что, если объект является сложным и имеет вложенные объекты в свойствах? Мы должны были бы также осуществить их преобразование. И, если мы отправляем объект по сети, нам также нужно предоставить код для «чтения» нашего объекта на принимающей стороне.
+...Но в процессе разработки добавляются новые свойства, старые свойства переименовываются и удаляются. Обновление такого `toString` каждый раз может стать проблемой. Мы могли бы попытаться перебрать свойства в нем, но что, если объект является сложным и имеет вложенные объекты в свойствах? Мы должны были бы также осуществить их преобразование. И, если мы отправляем объект по сети, нам также нужно предоставить код для «чтения» нашего объекта на принимающей стороне.
 
 К счастью, нет необходимости писать код для обработки всего этого. У задачи есть простое решение.
 
 ## JSON.stringify
 
-[JSON](https://ru.wikipedia.org/wiki/JSON) (JavaScript Object Notation) это общий формат для представления значений и объектов. Его описание задокументировано в стандарте [RFC 4627](http://tools.ietf.org/html/rfc4627). Первоначально он был создан для JavaScript, но многие другие языки также имеют библиотеки, которые также могут работать с ним. Таким образом, JSON легко использовать для обмена данными, когда клиент использует JavaScript а сервер написан на Ruby/PHP/Java/любой другой язык.
+[JSON](https://ru.wikipedia.org/wiki/JSON) (JavaScript Object Notation) - это общий формат для представления значений и объектов. Его описание задокументировано в стандарте [RFC 4627](http://tools.ietf.org/html/rfc4627). Первоначально он был создан для JavaScript, но многие другие языки также имеют библиотеки, которые могут работать с ним. Таким образом, JSON легко использовать для обмена данными, когда клиент использует JavaScript, а сервер написан на Ruby/PHP/Java/любой другой язык.
 
 JavaScript предоставляет методы:
 
 - `JSON.stringify` для преобразования объектов в JSON.
 - `JSON.parse` для преобразования JSON обратно в объект.
 
-Например, здесь мы преобразуем через `JSON.stringify` карточку студента:
+Например, здесь мы преобразуем через `JSON.stringify` данные студента:
 ```js run
 let student = {
   name: 'John',
@@ -48,11 +48,11 @@ let student = {
 let json = JSON.stringify(student);
 */!*
 
-alert(typeof json); // мы получим строку!
+alert(typeof json); // мы получили строку!
 
 alert(json);
 *!*
-/* выведет записанный в JSON объект:
+/* выведет объект в формате JSON:
 {
   "name": "John",
   "age": 30,
@@ -66,7 +66,7 @@ alert(json);
 
 Метод `JSON.stringify(student)` берет объект и преобразует его в строку.
 
-Полученная `json` строка называется *JSON-кодированным* или *сериализованным*, *строковым* или *структурированным* объектом. Мы готовы отправить его по проводам или поместить в обычное хранилище данных.
+Полученная строка `json` называется *JSON-кодированным* или *сериализованным*, *строковым* или *структурированным* объектом. Мы готовы отправить его по сети или поместить в обычное хранилище данных.
 
 
 Обратите внимание, что JSON-кодированный объект имеет несколько важных отличий от объектного литерала:
@@ -89,22 +89,22 @@ alert(json);
 Например:
 
 ```js run
-// число в JSON - всего лишь числовое значение
+// число в JSON остается числом
 alert( JSON.stringify(1) ) // 1
 
-// строка в JSON по-прежнему является строкой, но имеет двойные кавычки
+// строка в JSON по-прежнему остается строкой, но в двойных кавычках
 alert( JSON.stringify('test') ) // "test"
 
 alert( JSON.stringify(true) ); // true
 
 alert( JSON.stringify([1, 2, 3]) ); // [1,2,3]
 ```
 
-JSON является кросс-языковой спецификацией только для данных, поэтому некоторые специфичные для JavaScript свойства объекта в `JSON.stringify` пропускаются.
+JSON является спецификацией только для данных на нескольких язках, поэтому некоторые специфичные для JavaScript свойства объекта в `JSON.stringify` пропускаются.
 
 А именно:
 
-- Свойства функции (методы).
+- Свойства-функции (методы).
 - Символические свойства.
 - Свойства, которые хранят `undefined`.
 
@@ -138,7 +138,7 @@ let meetup = {
 };
 
 alert( JSON.stringify(meetup) );
-/* вся структура преобразована:
+/* вся структура преобразована в строку:
 {
   "title":"Conference",
   "room":{"number":23,"participants":["john","ann"]},
@@ -175,7 +175,7 @@ JSON.stringify(meetup); // Ошибка: Преобразование цикли
 
 ## Исключение и преобразование: replacer
 
-Полный синтаксис `JSON.stringify` таков:
+Полный синтаксис `JSON.stringify`:
 
 ```js
 let json = JSON.stringify(value[, replacer, space])
@@ -185,12 +185,12 @@ value
 : Значение для кодирования.
 
 replacer
-: Массив свойств для кодирования или функции отображения `function(key, value)`.
+: Массив свойств для кодирования или функции соответствия `function(key, value)`.
 
 space
 : Дополнительное пространство (отступы), используемое для форматирования.
 
-В большинстве случаев `JSON.stringify` используется только с первым аргументом. Но если нам нужно отфильтровать процесс замены, например, отфильтровать циклические ссылки, то можно использовать второй аргумент `JSON.stringify`.
+В большинстве случаев `JSON.stringify` используется только с первым аргументом. Но если нам нужно настроить процесс замены, например, отфильтровать циклические ссылки, то можно использовать второй аргумент `JSON.stringify`.
 
 Если мы передадим ему массив свойств, будут закодированы только эти свойства.
 
@@ -213,9 +213,9 @@ alert( JSON.stringify(meetup, *!*['title', 'participants']*/!*) );
 // {"title":"Conference","participants":[{},{}]}
 ```
 
-Здесь мы, наверное, слишком строги. Список свойств применяется ко всей структуре объекта. Так что участники пусты, потому что `name` нет в списке.
+Здесь мы, наверное, слишком строги. Список свойств применяется ко всей структуре объекта. Так что свойство `participants` пустое, потому что `name` нет в списке.
 
-Давайте включим все свойства, кроме `room.occupiedBy`, что вызовет цикличную ссылку:
+Давайте включим все свойства, кроме `room.occupiedBy`, из-за которого появляется цикличная ссылка:
 
 ```js run
 let room = {
@@ -262,11 +262,11 @@ let meetup = {
 room.occupiedBy = meetup; // room ссылается на meetup
 
 alert( JSON.stringify(meetup, function replacer(key, value) {
-  alert(`${key}: ${value}`); // чтобы посмотреть, что получит заменитель
+  alert(`${key}: ${value}`); // чтобы посмотреть, что получит replacer
   return (key == 'occupiedBy') ? undefined : value;
 }));
 
-/* пары ключ:значение, которые приходят на замену:
+/* пары ключ:значение, которые приходят в replacer:
 :             [object Object]
 title:        Conference
 participants: [object Object],[object Object]
@@ -279,9 +279,9 @@ number:       23
 */
 ```
 
-Обратите внимание, что функция `replacer` получает каждую пару ключ/значение, включая вложенные объекты и элементы массива и это применяется рекурсивно. Значение `this` внутри `replacer` - это объект, который содержит текущее свойство.
+Обратите внимание, что функция `replacer` получает каждую пару ключ/значение, включая вложенные объекты и элементы массива. И она применяется рекурсивно. Значение `this` внутри `replacer` - это объект, который содержит текущее свойство.
 
-Первый вызов - особенный. Он делается с помощью специальной «обертки объекта»: `{"": meetup}`. Другими словами, первая `(key, value)` пара имеет пустой ключ, а значением является целевой объект в целом. Вот почему первая строка будет `":[object Object]"` в примере выше.
+Первый вызов - особенный. Ему передается специальный "объект-обертка": `{"": meetup}`. Другими словами, первая `(key, value)` пара имеет пустой ключ, а значением является целевой объект в целом. Вот почему первая строка будет `":[object Object]"` в примере выше.
 
 Идея состоит в том, чтобы переложить как можно больше действий на `replacer` - у него есть возможность проанализировать и заменить/пропустить весь объект целиком, если это необходимо.
 
@@ -328,11 +328,11 @@ alert(JSON.stringify(user, null, 2));
 */
 ```
 
-Параметр `spaces` используется исключительно для протоколирования и позиционирования выходных данных.
+Параметр `spaces` используется исключительно для логирования и красивого вывода.
 
 ## Пользовательский «toJSON»
 
-Как и `toString` для преобразования строк, объект может предоставлять метод `toJSON` для преобразования в JSON. `JSON.stringify` автоматически вызывает его, если доступно.
+Как и `toString` для преобразования строк, объект может предоставлять метод `toJSON` для преобразования в JSON. `JSON.stringify` автоматически вызывает его, если он есть.
 
 Например:
 
@@ -359,9 +359,9 @@ alert( JSON.stringify(meetup) );
 */
 ```
 
-Здесь мы можем видеть, что `date` `(1)` стал строкой. Это потому, что все объекты имеют встроенный `toJSON` метод, который возвращает такую строку.
+Как видим, `date` `(1)` стал строкой. Это потому, что все объекты имеют встроенный метод `toJSON`, который возвращает такую строку.
 
-Теперь давайте добавим пользовательский `toJSON` для нашего объекта `room` `(2)`:
+Теперь давайте добавим собственную реализацию метода `toJSON` в наш объект `room` `(2)`:
 
 ```js run
 let room = {
@@ -393,7 +393,7 @@ alert( JSON.stringify(meetup) );
 */
 ```
 
-Как видим, `toJSON` используется как для прямого вызова `JSON.stringify(room)`, так и для вложенного объекта.
+Теперь получается, что `toJSON` используется как при прямом вызове `JSON.stringify(room)`, так и на вложенном объекте.
 
 
 ## JSON.parse
@@ -432,7 +432,7 @@ user = JSON.parse(user);
 alert( user.friends[1] ); // 1
 ```
 
-JSON может быть настолько сложным, насколько это необходимо, объекты и массивы могут включать другие объекты и массивы. Но они должны подчиняться формату.
+JSON может быть настолько сложным, насколько это необходимо, объекты и массивы могут включать другие объекты и массивы. Но они должны быть в том же формате.
 
 Вот типичные ошибки в написанном от руки JSON (иногда приходится писать его для отладки):
 
@@ -456,14 +456,14 @@ let json = `{
 
 Представьте себе, мы получили строковый объект `meetup` с сервера.
 
-Похоже на то:
+Вот такой:
 
 ```js
 // title: (meetup title), date: (meetup date)
 let str = '{"title":"Conference","date":"2017-11-30T12:00:00.000Z"}';
 ```
 
-...А теперь нам нужно *десериализовать* его, чтобы снова превратить в объект JavaScript.
+...А теперь нам нужно *десериализовать* его, т.е. снова превратить в объект JavaScript.
 
 Давайте сделаем это, вызвав `JSON.parse`:
 
@@ -481,7 +481,7 @@ alert( meetup.date.getDate() ); // Error!
 
 Значением `meetup.date` является строка, а не `Date` объект. Как мог `JSON.parse` знать, что он должен преобразовать эту строку в `Date`?
 
-Давайте перейдем к `JSON.parse` функции восстановления, которая возвращает все значения «как есть», но  `date` станет `Date`:
+Давайте перейдем к функции восстановления `JSON.parse`, которая возвращает все значения «как есть», но `date` станет `Date`:
 
 ```js run
 let str = '{"title":"Conference","date":"2017-11-30T12:00:00.000Z"}';