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

Author: vahrammer

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

@@ -30,4 +30,4 @@ loadJson('no-such-user.json')
     ```
 
     Тогда внешнему коду пришлось бы получать результат промиса самостоятельно (через `.then` или `await`). В нашем варианте это не обязательно.
-4. Брошенная из `loadJson` ошибка перехватывается с помощью `.catch`. Здесь нельзя использовать `await loadJson(…)`, так как мы находимся не в теле `async` функции.
+4. Выброшенная из `loadJson` ошибка перехватывается с помощью `.catch`. Здесь нельзя использовать `await loadJson(…)`, так как мы находимся не в теле функции `async`.

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

@@ -1,7 +1,7 @@
 
-Это тот случай, когда знание о внутренннем устройстве `async/await` очень кстати.
+Это тот случай, когда понимание внутреннего устройства работы `async/await` очень кстати.
 
-Здесь нужно думать о вызове `async` функции, как о промисе. И просто воспользоваться `.then`:
+Здесь нужно думать о вызове функции `async`, как о промисе. И просто воспользоваться `.then`:
 ```js run
 async function wait() {
   await new Promise(resolve => setTimeout(resolve, 1000));

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

@@ -1,7 +1,7 @@
 
-# Вызовите async функцию из "обычной"
+# Вызовите async–функцию из "обычной"
 
-Есть "обычная" функция. Как можно внутри неё получить результат выполнения `async` функции?
+Есть "обычная" функция. Как можно внутри неё получить результат выполнения `async`–функции?
 
 ```js
 async function wait() {
@@ -12,7 +12,7 @@ async function wait() {
 
 function f() {
   // ...что здесь написать?
-  // чтобы вызвать wait() и дождаться результата "10" от async функции
+  // чтобы вызвать wait() и дождаться результата "10" от async–функции
   // не забывайте, здесь нельзя использовать "await"
 }
 ```

1-js/11-async/08-async-await/article.md

@@ -2,19 +2,19 @@
 
 Существует специальный синтаксис для работы с промисами, который называется "async/await". Он очень простой и наглядный.
 
-## Async функции
+## Асинхронные функции
 
-Объявление функции можно начать с ключевого слова `async`:
+Объявление асинхронной функции можно начать с ключевого слова `async`:
 
 ```js
 async function f() {
   return 1;
 }
 ```
 
-Функция, перед объявлением которой находится ключевое слово "async", всегда возвращает промис. Значения, отличные от промисов, будут оборачиваться в успешно завершившийся промис автоматически.
+Функция, перед объявлением которой находится ключевое слово "async", всегда возвращает промис. Значения других типов оборачиваются в завершившийся успешно промис автоматически.
 
-Например, эта функция возвратит промис в `fulfilled` состоянии с результатом `1`:
+Например, эта функция возвратит выполненый промис с результатом `1`:
 
 ```js run
 async function f() {
@@ -34,14 +34,14 @@ async function f() {
 f().then(alert); // 1
 ```
 
-Получается, ключевое слово `async` перед функцией гарантирует, что эта функция в любом случае вернёт промис. Согласитесь, достаточно просто? Но это ещё не всё. Есть другое ключевое слово – `await`, которое можно использовать только внутри `async` функций. 
+Получается, ключевое слово `async` перед функцией гарантирует, что эта функция в любом случае вернёт промис. Согласитесь, достаточно просто? Но это ещё не всё. Есть другое ключевое слово – `await`, которое можно использовать только внутри `async`–функций. 
 
 ## Await
 
 Синтаксис:
 
 ```js
-// работает только внутри async функций
+// работает только внутри async–функций
 let value = await promise;
 ```
 
@@ -68,7 +68,7 @@ f();
 
 В данном примере выполнение функции остановится на строке `(*)` до тех пор, пока промис не перейдёт в состояние `fulfilled`. Это произойдёт через секунду после запуска функции. После чего в переменную `result` будет записан результат выполнения промиса, и браузер отобразит alert-окно «готово!».
 
-Обратите внимание, хотя `await` заставляет JavaScript дожидаться выполнения промиса, это не отнимает ресурсов процессора. Пока промис не выполнится, JS движок может заниматься другими задачами – выполнять прочие скрипты, обрабатывать события и т.п.
+Обратите внимание, хотя `await` заставляет JavaScript дожидаться выполнения промиса, это не отнимает ресурсов процессора. Пока промис не выполнится, JS-движок может заниматься другими задачами – выполнять прочие скрипты, обрабатывать события и т.п.
 
 По сути, это просто "синтаксический сахар" для получения результата промиса, более наглядный, чем `promise.then`.
 
@@ -84,7 +84,7 @@ function f() {
 }
 ```
 
-Ошибки не будет, если мы укажем ключевое слово `async` перед объявлением функции. Как было сказано раньше, `await` можно использовать только внутри `async` функций.
+Ошибки не будет, если мы укажем ключевое слово `async` перед объявлением функции. Как было сказано раньше, `await` можно использовать только внутри `async`–функций.
 ````
 
 Давайте перепишем пример `showAvatar()` из раздела <info:promise-chaining> с помощью `async/await`:
@@ -123,15 +123,15 @@ showAvatar();
 Получилось очень просто и читаемо, правда? Гораздо лучше, чем раньше.
 
 ````smart header="`await` нельзя использовать на верхнем уровне вложенности"
-Программисты, узнав об `await`, часто пытаются использовать эту возможность на верхнем уровне вложенности (вне тела функции). Но из-за того, что `await` работает только внутри `async` функций, так сделать не получится:
+Программисты, узнав об `await`, часто пытаются использовать эту возможность на верхнем уровне вложенности (вне тела функции). Но из-за того, что `await` работает только внутри `async`–функций, так сделать не получится:
 
 ```js run
 // SyntaxError на верхнем уровне вложенности
 let response = await fetch('/article/promise-chaining/user.json');
 let user = await response.json();
 ```
 
-Можно обернуть этот код в анонимную `async` функцию, тогда всё заработает:
+Можно обернуть этот код в анонимную `async`–функцию, тогда всё заработает:
 
 ```js run
 (async () => {
@@ -143,7 +143,7 @@ let user = await response.json();
 
 
 ````
-````smart header="`await` работает с \"thenable\" объектами"
+````smart header="`await` работает с объектами типа \"thenable\""
 Любой объект может не быть промисом, но реализовать их интерфейс (быть промис-совместимым). Если у объекта можно вызвать метод `then`, этого достаточно, чтобы использовать его с `await`.
 
 В примере ниже, экземпляры класса `Thenable` будут работать вместе с `await`:
@@ -173,8 +173,8 @@ f();
 Когда `await` получает объект с `.then` (не являющийся промисом), JavaScript автоматически запускает этот метод, передавая ему аргументы – встроенные функции `resolve` и `reject`. `await` приостановит дальнейшее выполнение кода, пока любая из этих функций не будет вызвана (в примере, это строка `(*)`). После чего выполнение кода продолжится с результатом `resolve` или `reject` соответственно.
 ````
 
-````smart header="Async методы"
-Можно создавать async методы:
+````smart header="Асинхронные методы"
+Для объявления асинхронного метода достаточно написать `async` перед именем:
 
 ```js run
 class Waiter {
@@ -189,7 +189,7 @@ new Waiter()
   .wait()
   .then(alert); // 1
 ```
-Как и с async функциями, такой метод гарантированно возвращает промис и в его теле можно использовать `await`.
+Как и с асинхронными функциями, такой метод гарантированно возвращает промис и в его теле можно использовать `await`.
 
 ````
 ## Обработка ошибок
@@ -252,7 +252,7 @@ async function f() {
 f();
 ```
 
-Если из этой функции убрать блок `try..catch`, промис, сгенерированный вызовом async функции `f()`, возвратится в состоянии rejected. Мы можем использовать метод `.catch` промиса, чтобы обработать ошибку:
+Если из функции `f()` убрать блок `try..catch`, она будет возвращать завершившийся с ошибкой промис (в состоянии rejected). В этом случае мы можем использовать метод `.catch` промиса, чтобы обработать ошибку:
 
 ```js run
 async function f() {
@@ -265,12 +265,12 @@ f().catch(alert); // TypeError: failed to fetch // (*)
 */!*
 ```
 
-Если забыть добавить `.catch` возвращаемому rejected промису, будет сгенерирована ошибка "Uncaught promise error" и информация об этом будет выведена в консоль. Такие ошибки тоже можно отловить и обработать, об этом подробно написано в разделе <info:promise-error-handling>.
+Если забыть добавить `.catch` возвращаемому `rejected`–промису, будет сгенерирована ошибка "Uncaught promise error" и информация об этом будет выведена в консоль. Такие ошибки тоже можно отловить и обработать, об этом подробно написано в разделе <info:promise-error-handling>.
 
 ```smart header="`async/await` и `promise.then/catch`"
 При работе с `async/await`, `.then` используется не часто, так как `await` автоматически ожидает завершения выполнения промиса. В этом случае, обычно (но не всегда) гораздо удобнее перехватывать ошибки используя `try..catch`, нежели чем `.catch`. 
 
-Но на верхнем уровне вложенности (вне `async` функций) `await` использовать нельзя, поэтому `.then/catch` для обработки финального результата или ошибок – обычная практика.
+Но на верхнем уровне вложенности (вне `async`–функций) `await` использовать нельзя, поэтому `.then/catch` для обработки финального результата или ошибок – обычная практика.
 
 Так сделано в строке `(*)` в примере выше.
 ```