review fixes

Author: wspwebben

5-network/12-server-sent-events/article.md

@@ -41,15 +41,15 @@ data: в две строки
 - Сообщения разделяются двойным переносом строки `\n\n`.
 - Чтобы разделить сообщение на несколько строк, мы можем отправить несколько `data:` подряд (третье сообщение).
 
-На практике, сложные сообщения обычно отправляются в формате JSON, указывая переносы строк внутри.
+На практике сложные сообщения обычно отправляются в формате JSON, указывая переносы строк внутри.
 
 Например:
 
 ```js
 data: {"user":"Джон","message":"Первая строка*!*\n*/!* Вторая строка"}
 ```
 
-...Так что можно считать, что в каждом `data:` указано ровно одно сообщение.
+...Так что можно считать, что в каждом `data:` содержится ровно одно сообщение.
 
 Для каждого сообщения генерируется событие `message`:
 
@@ -58,7 +58,7 @@ let eventSource = new EventSource("/events/subscribe");
 
 eventSource.onmessage = function(event) {
   console.log("Новое сообщение", event.data);
-  // этот код вывет в консоль 3 сообщения для данных, описанных выше
+  // этот код вывет в консоль 3 сообщения, описанных выше
 };
 
 // или eventSource.addEventListener('message', ...)
@@ -74,7 +74,7 @@ let source = new EventSource("https://another-site.com/events");
 
 Сервер получит заголовок `Origin` и должен будет ответить с заголовком `Access-Control-Allow-Origin`.
 
-Чтобы передать авторизирующие заголовки, нужно передать дополнительный аргумент `withCredentials`:
+Чтобы послать авторизационные данные, следует установить дополнительную опцию `withCredentials`:
 
 ```js
 let source = new EventSource("https://another-site.com/events", {
@@ -87,13 +87,13 @@ let source = new EventSource("https://another-site.com/events", {
 
 ## Переподключение
 
-После создания, `new EventSource` подключается к серверу и, если соединение обрывается, -- переподключается.
+После создания `new EventSource` подключается к серверу и, если соединение обрывается, -- переподключается.
 
 Это очень удобно, так как нам не приходится беспокоиться об этом.
 
-По умолчанию, между попытками возобновить соединение будет небольшая пауза в несколько секунд.
+По умолчанию между попытками возобновить соединение будет небольшая пауза в несколько секунд.
 
-Сервер может выставить рекомендуемую задержку, указав в ответе `retry:` (в милисекундах):
+Сервер может выставить рекомендуемую задержку, указав в ответе `retry:` (в миллисекундах):
 
 ```js
 retry: 15000
@@ -102,7 +102,7 @@ data: Привет, я выставил задержку переподключ
 
 Поле `retry:` может посылаться как вместе с данными, так и отдельным сообщением.
 
-Браузер должен быть подождать окончания задержки перед попыткой переподключения. Если потеряно подключение к интернету, бразуер может дождаться его востанновления и затем попытаться переподключиться.
+Браузеру следует ждать именно столько перед новой попыткой подключения. Если потеряно соединение с сетью, то бразуер может подождать его восстановления и затем попытаться переподключиться.
 
 - Если сервер хочет остановить попытки переподключения, он должен ответить со статусом 204.
 - Если браузер хочет прекратить соединение, он может вызвать `eventSource.close()`:
@@ -156,9 +156,9 @@ EventSource.OPEN = 1;       // подключено
 EventSource.CLOSED = 2;     // подключение закрыто
 ```
 
-При создании объекта и разрыве соединения, оно автоматически устанавливается в значение `EventSource.CONNECTING` (равно `0`).
+При создании объекта и разрыве соединения оно автоматически устанавливается в значение `EventSource.CONNECTING` (равно `0`).
 
-Мы можем обратится к этому свойству, чтобы узнать текущее состояние `EventSource`.
+Мы можем обратиться к этому свойству, чтобы узнать текущее состояние `EventSource`.
 
 ## Типы событий
 
@@ -198,16 +198,16 @@ eventSource.addEventListener('leave', event => {
 });
 ```
 
-## Пример
+## Полный пример
 
 В этом примере сервер посылает сообщения `1`, `2`, `3`, затем `пока-пока` и разрывает соединение.
 
-После этого браузер автоматически восстанавливает соединение.
+После этого браузер автоматически переподключается.
 
 [codetabs src="eventsource"]
 
 
-## Итоги
+## Итого
 
 Объект `EventSource` "общается" с сервером. Он устанавливает постоянное соединение и позволяет серверу отправлять через него сообщения.
 
@@ -228,7 +228,7 @@ eventSource.addEventListener('leave', event => {
 let source = new EventSource(url, [credentials]);
 ```
 
-Второй аргумент - объект с одним свойством: `{ withCredentials: true }`, позволяет передавать вместе с запросом авторизирующие заголовки.
+Второй аргумент - объект с одним свойством: `{ withCredentials: true }`. Он позволяет отправлять авторизационные данные в том числе и на другие домены.
 
 В целом, кросс-доменная безопасность на таком же уровне, как у `fetch` и других методов работы с сетью.
 
@@ -254,17 +254,17 @@ let source = new EventSource(url, [credentials]);
 : Соединение установлено.
 
 `error`
-: Потеряно соединение (произойдёт переподключение) или произошла фатальная ошибка. Мы можем обратиться к свойству `readyState`, чтобы проверить происходит ли переподключение.
+: Потеряно соединение (произойдёт переподключение) или произошла фатальная ошибка. Мы можем обратиться к свойству `readyState`, чтобы проверить, происходит ли переподключение.
 
 Сервер может выставить собственное событие с помощью `event:`. Такие события должны быть обработаны с помощью `addEventListener`, а не `on<event>`.
 
 ### Формат ответа сервера
 
 Сервер посылает сообщения, разделённые двойным переносом строки `\n\n`.
 
-Часть сообщения может начинаться с:
+Сообщения состоят из следующих частей:
 
 - `data:` -- тело сообщения, несколько `data` подряд интерпретируются как одно сообщение, разделённые переносами строк `\n`.
 - `id:` -- обновляет свойство `lastEventId`, отправляемое в `Last-Event-ID` при переподключении.
 - `retry:` -- рекомендованная задержка перед переподключением в миллисекундах. Не может быть установлена с помощью JavaScript.
-- `event:` -- пользовательское имя события, должно быть указано перед `data:`.
+- `event:` -- имя пользовательского события, должно быть указано перед `data:`.