Merge pull request #219 from ARTM2000/feat/async-await

Async/await

Author: mahdyar

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,19 @@ loadJson('https://javascript.info/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:
+۱. تابع `loadJson` به `async` تغییر کرد.
+
+۲. تمام `then.` ها با `await` جایگزین شده اند.
+
+۳. ما می توانیم بجای صبر کردن برای نتیجه، مستقیما آن `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.
+    بنابراین کد بیرونی باید برای اجرا شدن Promise از `await` استفاده کند. در مثال ما خیلی اهمیت ندارد.
+۵. خطای ایجاد شده از `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 this example code 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,7 +19,7 @@ async function loadJson(url) {
   }
 }
 
-// Ask for a user name until github returns a valid user
+// نام کاربری را می پرسد تا زمانی که گیت هاب یک کاربر معتبر برگرداند
 async function demoGithubUser() {
 
   let user;
@@ -28,13 +28,13 @@ async function demoGithubUser() {
 
     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 ادامه می یابد
         alert("No such user, please reenter.");
       } else {
-        // unknown error, rethrow
+        // خطای ناشناخته، مجدد throw می شود
         throw err;
       }
     }      

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

@@ -1,9 +1,9 @@
 
-# Rewrite "rethrow" with async/await
+# بازنویسی "rethrow" با async/await
 
-Below you can find the "rethrow" example. Rewrite it using `async/await` instead of `.then/catch`.
+در زیر ما مثالی از "rethrow" پیدا می کنیم. آن را با استفاده از ‍`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,7 +25,7 @@ function loadJson(url) {
     });
 }
 
-// Ask for a user name until github returns a valid user
+// نام کاربری را می پرسد تا زمانی که گیت هاب یک کاربر معتبر برگرداند
 function demoGithubUser() {
   let name = prompt("Enter a name?", "iliakan");
 

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.
+این مورد زمانی است که دانستن نحوه عملکرد آن در داخل تابع عادی مفید است.
 
-Just treat `async` call as promise and attach `.then` to it:
+فقط کافیست که با `async` مانند Promise عمل کنیم و `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
+  // بعد از ۱ ثانیه ۱۰ را نشان می دهند‍‍
 *!*
   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 از non-async
 
-We have a "regular" function called `f`. How can you call the `async` function `wait()` and use its result inside of `f`?
+ما یک تابع معمولی داریم که `f` نامگذاری شده است. چگونه می توانید تابع `()wait` که `async` است را فراخوانی کنید و از نتیجه آن داخل `f` استفاده کنید؟
 
 ```js
 async function wait() {
@@ -11,10 +11,10 @@ async function wait() {
 }
 
 function f() {
-  // ...what should you write here?
-  // we need to call async wait() and wait to get 10
-  // remember, we can't use "await"
+  // ... چی باید اینچا بنویسیم?
+  // ما باید async wait() را فراخوانی کنیم و صبر کنیم تا ۱۰ را بگیریم
+  // به یاد داشته باشید، نمی توانیم از "await" استفاده کنیم
 }
 ```
 
-P.S. The task is technically very simple, but the question is quite common for developers new to async/await.
+ضمیمه: این کار از نظر فنی بسیار ساده است اما این سوال برای توسعه دهندگان که با async/await تازه آشنا شده اند بسیار متداول است.