Merge pull request #293 from xcurveballx/5-network/01-fetch

Задание из главы Fetch

Author: javascript-translate-bot

5-network/01-fetch/01-fetch-users/_js.view/source.js

@@ -1,4 +1,4 @@
 
 async function getUsers(names) {
-  /* your code */
+  /* ваш код */
 }

5-network/01-fetch/01-fetch-users/solution.md

@@ -1,12 +1,12 @@
 
-To fetch a user we need:
+Чтобы получить сведения о пользователе, нам нужно:
 
 1. `fetch('https://api.github.com/users/USERNAME')`.
-2. If the response has status `200`, call `.json()` to read the JS object.
+2. Если в ответ приходит статус `200`, вызываем метод `.json()`, чтобы прочитать JS-объект.
 
-If a `fetch` fails, or the response has non-200 status, we just return `null` in the resulting arrray.
+Если запрос завершается ошибкой или код статуса в ответе отличен от 200, то мы просто возвращаем `null` в массиве результатов.
 
-So here's the code:
+Вот код:
 
 ```js demo
 async function getUsers(names) {
@@ -34,8 +34,8 @@ async function getUsers(names) {
 }
 ```
 
-Please note: `.then` call is attached directly to `fetch`, so that when we have the response, it doesn't wait for other fetches, but starts to read `.json()` immediately.
+Пожалуйста, обратите внимание: вызов `.then` идёт сразу после `fetch`, то есть когда ответ получен, сразу начинаем считывание данных с помощью `.json()`, не дожидаясь завершения других запросов.
 
-If we used `await Promise.all(names.map(name => fetch(...)))`, and call `.json()` on the results, then it would wait for all fetches to respond. By adding `.json()` directly to each `fetch`, we ensure that individual fetches start reading data as JSON without waiting for each other.
+Если бы мы использовали `await Promise.all(names.map(name => fetch(...)))` и вызывали бы `.json()` на результатах запросов, то пришлось бы ждать, пока завершатся все из них. Вызывая `.json()` сразу после каждого `fetch`, мы добились того, что считывание присланных по каждому запросу данных происходит независимо от других запросов.
 
-That's an example of how low-level `Promise` API can still be useful even if we mainly use `async/await`.
+Это пример того, как относительно низкоуровневое `Promise` API может быть полезным, даже если мы в основном используем `async/await` в коде.

5-network/01-fetch/01-fetch-users/task.md

@@ -1,12 +1,12 @@
-# Fetch users from GitHub
+# Получите данные о пользователях GitHub
 
-Create an async function `getUsers(names)`, that gets an array of GitHub user names, fetches them from GitHub and returns an array of GitHub users instead.
+Создайте асинхронную функцию `getUsers(names)`, которая получает на вход массив логинов пользователей GitHub, запрашивает у GitHub информацию о них и возвращает массив объектов-пользователей.
 
-The GitHub url with user informaiton is: `https://api.github.com/users/USERNAME`.
+Информация о пользователе GitHub с логином USERNAME доступна по ссылке: `https://api.github.com/users/USERNAME`.
 
-There's a test example in the sandbox.
+В песочнице есть тестовый пример.
 
-Important details:
+Важные детали:
 
-1. There should be one `fetch` request per user. And requests shouldn't wait for each other. So that the data arrives as soon as possible.
-2. If a request fails, or if there's no such user, the function should return `null` in the resulting array.
+1. На каждого пользователя должен приходиться один запрос `fetch`. Запросы не должны ожидать завершения друг друга. Надо, чтобы данные приходили как можно быстрее.
+2. Если какой-то запрос завершается ошибкой или оказалось, что данных о запрашиваемом пользователе нет, то функция должна возвращать `null` в массиве результатов.

5-network/01-fetch/article.md

@@ -83,7 +83,7 @@ fetch('https://api.github.com/repos/javascript-tutorial/en.javascript.info/commi
   .then(commits => alert(commits[0].author.login));
 ```
 
-Для получения текста, используем `await response.text()` вместо `.json()`:
+Для получения текста используем `await response.text()` вместо `.json()`:
 
 ```js run async
 let response = await fetch('https://api.github.com/repos/javascript-tutorial/en.javascript.info/commits');
@@ -144,7 +144,7 @@ for (let [key, value] of response.headers) {
 }
 ```
 
-Для установки заголовка, мы можем использовать опцию `headers`, например:
+Для установки заголовка мы можем использовать опцию `headers`, например:
 
 ```js
 let response = fetch(protectedUrl, {
@@ -181,7 +181,7 @@ let response = fetch(protectedUrl, {
 
 ## POST-запросы
 
-Для отправки `POST` запроса или запроса с другим методом, нам необходимо использовать `fetch` параметры:
+Для отправки `POST`-запроса или запроса с другим методом, нам необходимо использовать `fetch` параметры:
 
 - **`method`** -- HTTP метод, например `POST`,
 - **`body`** -- один из:
@@ -218,7 +218,7 @@ alert(result.message);
 
 Мы можем отправить бинарные данные напрямую, используя `Blob` или `BufferSource`.
 
-Например, у нас есть элемент `<canvas>`, на котором мы можем рисовать движением мыши. При нажатии на кнопку "Отправить", изображение отправляется на сервер:
+Например, у нас есть элемент `<canvas>`, на котором мы можем рисовать движением мыши. При нажатии на кнопку "Отправить" изображение отправляется на сервер:
 
 ```html run autorun height="90"
 <body style="margin:0">
@@ -285,7 +285,7 @@ fetch(url, options)
 - `response.ok` -- `true`, если статус ответа в диапазоне 200-299.
 - `response.headers` -- похожий на `Map` объект с HTTP-заголовками.
 
-Методы для получения тела ответа: 
+Методы для получения тела ответа:
 - **`response.json()`** -- преобразовывает ответ в JSON-объект,
 - **`response.text()`** -- возвращает ответ как обычный текст,
 - **`response.formData()`** -- возвращает ответ как объект FormData (кодировка form/multipart, см. следующую главу),