Merge pull request #103 from vahrammer/master

1-js/11-async/08-async-await translated

Author: javascript-translate-bot

1-js/11-async/08-async-await/01-rewrite-async/solution.md

@@ -1,5 +1,5 @@
 
-The notes are below the code:
+Комментарии к решению под кодом:
 
 ```js run
 async function loadJson(url) { // (1)
@@ -17,17 +17,17 @@ loadJson('no-such-user.json')
   .catch(alert); // Error: 404 (4)
 ```
 
-Notes:
+Комментарии:
 
-1. The function `loadJson` becomes `async`.
-2. All `.then` inside are replaced with `await`.
-3. We can `return response.json()` instead of awaiting for it, like this:
+1. Функция `loadJson` теперь асинхронная.
+2. Все `.then` внутри неё заменены на `await`.
+3. Можно было бы просто вернуть промис во внешний код `return response.json()`, вот так:
 
     ```js
     if (response.status == 200) {
       return response.json(); // (3)
     }
     ```
 
-    Then the outer code would have to `await` for that promise to resolve. In our case it doesn't matter.
-4. The error thrown from `loadJson` is handled by `.catch`. We can't use `await loadJson(…)` there, because we're not in an `async` function.
+    Тогда внешнему коду пришлось бы получать результат промиса самостоятельно (через `.then` или `await`). В нашем варианте это не обязательно.
+4. Выброшенная из `loadJson` ошибка перехватывается с помощью `.catch`. Здесь нельзя использовать `await loadJson(…)`, так как мы находимся не в теле функции `async`.

1-js/11-async/08-async-await/01-rewrite-async/task.md

@@ -1,7 +1,7 @@
 
-# Rewrite using async/await
+# Перепишите, используя async/await
 
-Rewrite the one of examples from the chapter <info:promise-chaining> using `async/await` instead of `.then/catch`:
+Перепишите один из примеров раздела <info:promise-chaining>, используя `async/await` вместо `.then/catch`:
 
 ```js run
 function loadJson(url) {

1-js/11-async/08-async-await/02-rewrite-async-2/solution.md

@@ -1,5 +1,5 @@
 
-There are no tricks here. Just replace `.catch` with `try...catch` inside `demoGithubUser` and add `async/await` where needed:
+В этой задаче нет ничего сложного. Нужно заменить `.catch` на `try...catch` внутри `demoGithubUser` и добавить `async/await`, где необходимо:
 
 ```js run
 class HttpError extends Error {
@@ -19,29 +19,29 @@ async function loadJson(url) {
   }
 }
 
-// Ask for a user name until github returns a valid user
+// Запрашивать логин, пока github не вернёт существующего пользователя.
 async function demoGithubUser() {
 
   let user;
   while(true) {
-    let name = prompt("Enter a name?", "iliakan");
+    let name = prompt("Введите логин?", "iliakan");
 
     try {
       user = await loadJson(`https://api.github.com/users/${name}`);
-      break; // no error, exit loop
+      break; // ошибок не было, выходим из цикла
     } catch(err) {
       if (err instanceof HttpError && err.response.status == 404) {
-        // loop continues after the alert
-        alert("No such user, please reenter.");
+        // после alert начнётся новая итерация цикла
+        alert("Такого пользователя не существует, пожалуйста, повторите ввод.");
       } else {
-        // unknown error, rethrow
+        // неизвестная ошибка, пробрасываем её
         throw err;
       }
     }      
   }
 
 
-  alert(`Full name: ${user.name}.`);
+  alert(`Полное имя: ${user.name}.`);
   return user;
 }
 

1-js/11-async/08-async-await/02-rewrite-async-2/task.md

@@ -1,9 +1,9 @@
 
-# Rewrite "rethrow" async/await
+# Перепишите, используя async/await
 
-Below you can find the "rethrow" example from the chapter <info:promise-chaining>. Rewrite it using `async/await` instead of `.then/catch`.
+Ниже пример из раздела <info:promise-chaining>, перепишите его, используя `async/await` вместо `.then/catch`.
 
-And get rid of the recursion in favour of a loop in `demoGithubUser`: with `async/await` that becomes easy to do.
+В функции `demoGithubUser` замените рекурсию на цикл: используя `async/await` сделать это просто.
 
 ```js run
 class HttpError extends Error {
@@ -25,18 +25,18 @@ function loadJson(url) {
     })
 }
 
-// Ask for a user name until github returns a valid user
+// Запрашивать логин, пока github не вернёт существующего пользователя.
 function demoGithubUser() {
-  let name = prompt("Enter a name?", "iliakan");
+  let name = prompt("Введите логин?", "iliakan");
 
   return loadJson(`https://api.github.com/users/${name}`)
     .then(user => {
-      alert(`Full name: ${user.name}.`);
+      alert(`Полное имя: ${user.name}.`);
       return user;
     })
     .catch(err => {
       if (err instanceof HttpError && err.response.status == 404) {
-        alert("No such user, please reenter.");
+        alert("Такого пользователя не существует, пожалуйста, повторите ввод.");
         return demoGithubUser();
       } else {
         throw err;

1-js/11-async/08-async-await/03-async-from-regular/solution.md

@@ -1,7 +1,7 @@
 
-That's the case when knowing how it works inside is helpful.
+Это тот случай, когда понимание внутреннего устройства работы `async/await` очень кстати.
 
-Just treat `async` call as promise and attach `.then` to it:
+Здесь нужно думать о вызове функции `async`, как о промисе. И просто воспользоваться `.then`:
 ```js run
 async function wait() {
   await new Promise(resolve => setTimeout(resolve, 1000));
@@ -10,7 +10,7 @@ async function wait() {
 }
 
 function f() {
-  // shows 10 after 1 second
+  // покажет 10 через 1 секунду
 *!*
   wait().then(result => alert(result));
 */!*

1-js/11-async/08-async-await/03-async-from-regular/task.md

@@ -1,7 +1,7 @@
 
-# Call async from non-async
+# Вызовите async–функцию из "обычной"
 
-We have a "regular" function. How to call `async` from it and use its result?
+Есть "обычная" функция. Как можно внутри неё получить результат выполнения `async`–функции?
 
 ```js
 async function wait() {
@@ -11,10 +11,10 @@ async function wait() {
 }
 
 function f() {
-  // ...what to write here?
-  // we need to call async wait() and wait to get 10
-  // remember, we can't use "await"
+  // ...что здесь написать?
+  // чтобы вызвать wait() и дождаться результата "10" от async–функции
+  // не забывайте, здесь нельзя использовать "await"
 }
 ```
 
-P.S. The task is technically very simple, but the question is quite common for developers new to async/await.
+P.S. Технически задача очень простая, но этот вопрос часто задают разработчики, недавно познакомившиеся с async/await.