вычитка статьи

Author: alfill

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

@@ -21,7 +21,7 @@ let user = {
 alert(user); // {name: "John", age: 30}
 ```
 
-...Но в процессе разработки добавляются новые свойства, старые свойства переименовываются и удаляются. Обновление такого `toString` каждый раз может стать проблемой. Мы могли бы попытаться перебрать свойства в нем, но что, если объект является сложным и имеет вложенные объекты в свойствах? Мы должны были бы также осуществить их преобразование. И, если мы отправляем объект по сети, нам также нужно предоставить код для «чтения» нашего объекта на принимающей стороне.
+...Но в процессе разработки добавляются новые свойства, старые свойства переименовываются и удаляются. Обновление такого `toString` каждый раз может стать проблемой. Мы могли бы попытаться перебрать свойства в нем, но что, если объект является сложным и имеет вложенные объекты в свойствах? Мы должны были бы также осуществить их преобразование. И, если мы отправляем объект по сети, нам также нужно предоставить код для "чтения" нашего объекта на принимающей стороне.
 
 К счастью, нет необходимости писать код для обработки всего этого. У задачи есть простое решение.
 
@@ -66,17 +66,17 @@ alert(json);
 
 Метод `JSON.stringify(student)` берет объект и преобразует его в строку.
 
-Полученная строка `json` называется *JSON-кодированным* или *сериализованным*, *строковым* или *структурированным* объектом. Мы готовы отправить его по сети или поместить в обычное хранилище данных.
+Полученная строка `json` называется *JSON-форматированным*, *сериализованным*, *строчным* или же *структурированным* объектом. Мы можем отправить его по сети или поместить в обычное хранилище данных.
 
 
-Обратите внимание, что JSON-кодированный объект имеет несколько важных отличий от объектного литерала:
+Обратите внимание, что объект в формате JSON имеет несколько важных отличий от объектного литерала:
 
 - Строки используют двойные кавычки. Никаких одинарных кавычек или обратных кавычек в JSON. Так `'John'` становится `"John"`.
 - Имена свойств объекта также заключаются в двойные кавычки. Это обязательно. Так `age:30` становится `"age":30`.
 
 `JSON.stringify` может быть применен и к примитивам.
 
-Внутренне поддерживаются типы JSON:
+Собственно поддерживаемые типы JSON:
 
 - Объекты `{ ... }`
 - Массивы `[ ... ]`
@@ -100,13 +100,13 @@ alert( JSON.stringify(true) ); // true
 alert( JSON.stringify([1, 2, 3]) ); // [1,2,3]
 ```
 
-JSON является спецификацией только для данных на нескольких язках, поэтому некоторые специфичные для JavaScript свойства объекта в `JSON.stringify` пропускаются.
+JSON является кросс-языковой спецификацией для данных, поэтому `JSON.stringify` пропускает некоторые специфические свойства объектов JavaScript.
 
 А именно:
 
 - Свойства-функции (методы).
 - Символические свойства.
-- Свойства, которые хранят `undefined`.
+- Свойства, содержащие `undefined`.
 
 ```js run
 let user = {
@@ -120,7 +120,7 @@ let user = {
 alert( JSON.stringify(user) ); // {} (пустой объект)
 ```
 
-Обычно это нормально. Если это не то, что мы хотим, то скоро мы увидим, как настроить процесс.
+Обычно это нормально. Если это не то, что мы хотим, то скоро мы увидим, как можно адаптировать этот процесс.
 
 Самое замечательное, что вложенные объекты поддерживаются и конвертируются автоматически.
 
@@ -213,7 +213,7 @@ alert( JSON.stringify(meetup, *!*['title', 'participants']*/!*) );
 // {"title":"Conference","participants":[{},{}]}
 ```
 
-Здесь мы, наверное, слишком строги. Список свойств применяется ко всей структуре объекта. Так что свойство `participants` пустое, потому что `name` нет в списке.
+Здесь мы, наверно, слишком строги. Список свойств применяется ко всей структуре объекта. Так что свойство `participants` пустое, потому что `name` нет в списке.
 
 Давайте включим все свойства, кроме `room.occupiedBy`, из-за которого появляется цикличная ссылка:
 
@@ -242,11 +242,11 @@ alert( JSON.stringify(meetup, *!*['title', 'participants', 'place', 'name', 'num
 
 Теперь все, кроме `occupiedBy`, сериализовано. Но список свойств довольно длинный.
 
-К счастью,в качестве `replacer` мы можем использовать функцию, а не массив.
+К счастью, в качестве `replacer` мы можем использовать функцию, а не массив.
 
-Функция будет вызываться для каждой пары `(key, value)` и должна возвращать «замененное» значение, которое будет использоваться вместо исходного.
+Функция будет вызываться для каждой пары `(key, value)` и должна возвращать "замененное" значение, которое будет использоваться вместо исходного.
 
-В нашем случае мы можем вернуть `value` «как есть» для всего, кроме `occupiedBy`. Чтобы игнорировать  `occupiedBy`, код ниже возвращает `undefined`:
+В нашем случае мы можем вернуть `value` "как есть" для всего, кроме `occupiedBy`. Чтобы игнорировать  `occupiedBy`, код ниже возвращает `undefined`:
 
 ```js run
 let room = {
@@ -281,16 +281,16 @@ number:       23
 
 Обратите внимание, что функция `replacer` получает каждую пару ключ/значение, включая вложенные объекты и элементы массива. И она применяется рекурсивно. Значение `this` внутри `replacer` - это объект, который содержит текущее свойство.
 
-Первый вызов - особенный. Ему передается специальный "объект-обертка": `{"": meetup}`. Другими словами, первая `(key, value)` пара имеет пустой ключ, а значением является целевой объект в целом. Вот почему первая строка будет `":[object Object]"` в примере выше.
+Первый вызов - особенный. Ему передается специальный "объект-обертка": `{"": meetup}`. Другими словами, первая `(key, value)` пара имеет пустой ключ, а значением является целевой объект в целом. Вот почему первая строка из примера выше будет `":[object Object]"`.
 
 Идея состоит в том, чтобы переложить как можно больше действий на `replacer` - у него есть возможность проанализировать и заменить/пропустить весь объект целиком, если это необходимо.
 
 
 ## Форматирование: spacer
 
-Третий аргумент `JSON.stringify(value, replacer, spaces)` - это количество пробелов, используемых для удобного форматирования.
+Третий аргумент в `JSON.stringify(value, replacer, spaces)` - это количество отступов, используемых для удобного форматирования.
 
-Ранее все строковые объекты не имели отступов и лишних пробелов. Это нормально, если мы хотим отправить объект по сети. Аргумент `spacer` используется исключительно для вывода в удобочитаемом виде.
+Ранее все строчные объекты не имели отступов и лишних пробелов. Это нормально, если мы хотим отправить объект по сети. Аргумент `spacer` используется исключительно для вывода в удобочитаемом виде.
 
 Ниже `spacer = 2` указывает JavaScript отображать вложенные объекты в несколько строк с отступом в 2 пробела внутри объекта:
 
@@ -328,9 +328,9 @@ alert(JSON.stringify(user, null, 2));
 */
 ```
 
-Параметр `spaces` используется исключительно для логирования и красивого вывода.
+Параметр `spaces` применяется для логирования и красивого вывода.
 
-## Пользовательский «toJSON»
+## Пользовательский "toJSON"
 
 Как и `toString` для преобразования строк, объект может предоставлять метод `toJSON` для преобразования в JSON. `JSON.stringify` автоматически вызывает его, если он есть.
 
@@ -406,7 +406,7 @@ let value = JSON.parse(str[, reviver]);
 ```
 
 str
-: JSON-строка для разбора.
+: преобразуемая JSON-строка.
 
 reviver
 : Необязательная функция с параметрами (ключ, значение), которая будет вызываться для каждой пары `(key, value)`  и может преобразовывать значение.
@@ -448,13 +448,13 @@ let json = `{
 
 Кроме того, JSON не поддерживает комментарии. Добавление комментария в JSON делает его недействительным.
 
-Существует еще один формат [JSON5](http://json5.org/), который позволяет вводить ключи без кавычек, комментарии и т.д. Но это самостоятельная библиотека, не в спецификации языка.
+Существует еще один формат [JSON5](http://json5.org/), который поддерживает ключи без кавычек, комментарии и т.д. Но это самостоятельная библиотека, а не спецификация языка.
 
 Обычный JSON настолько строг не потому, что его разработчики ленивы, а потому, что позволяет легко, надежно и очень быстро реализовывать алгоритм парсинга.
 
 ## Использование reviver
 
-Представьте себе, мы получили строковый объект `meetup` с сервера.
+Представьте себе, мы получили объект `meetup` с сервера в виде строчки данных.
 
 Вот такой:
 
@@ -477,11 +477,11 @@ 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"}';
@@ -512,7 +512,7 @@ schedule = JSON.parse(schedule, function(key, value) {
 });
 
 *!*
-alert( schedule.meetups[1].date.getDate() ); // 18 - работает!
+alert( schedule.meetups[1].date.getDate() ); // 18 - отлично!
 */!*
 ```
 
@@ -524,4 +524,4 @@ alert( schedule.meetups[1].date.getDate() ); // 18 - работает!
 - JSON поддерживает простые объекты, массивы, строки, числа, логические значения и `null`.
 - JavaScript предоставляет методы [JSON.stringify](mdn:js/JSON/stringify) для сериализации в JSON и [JSON.parse](mdn:js/JSON/parse) для чтения из JSON.
 - Оба метода поддерживают функции преобразования для интеллектуального чтения/записи.
-- Если объект имеет `toJSON`, то он вызывается `JSON.stringify`.
+- Если объект имеет метод `toJSON`, то он вызывается через `JSON.stringify`.