Merge branch 'master' of https://github.com/mahdiHash/fa.javascript.info

Merge master branch

Author: mahdiHash

1-js/02-first-steps/08-operators/article.md

@@ -194,22 +194,22 @@ alert( +apples + +oranges ); // 5
 | اولویت | نام | علامت |
 |------------|------|------|
 | ... | ... | ... |
-| 17 | جمع یگانه | `+` |
-| 17 | تفریق یگانه | `-` |
-| 16 | بتوان رساندن | `**` |
-| 15 | ضرب | `*` |
-| 15 | تقسیم | `/` |
-| 13 | جمع | `+` |
-| 13 | تفریق | `-` |
+| 15 | جمع یگانه | `+` |
+| 15 | تفریق یگانه | `-` |
+| 14 | بتوان رساندن | `**` |
+| 13 | ضرب | `*` |
+| 13 | تقسیم | `/` |
+| 12 | جمع | `+` |
+| 12 | تفریق | `-` |
 | ... | ... | ... |
-| 3 | مقدارده | `=` |
+| 2 | مقداردهی | `=` |
 | ... | ... | ... |
 
-همانطور که می‌بینیم "عملگر + یگانه" اولویت 17 دارد که از عملگر جمع ( + دوگانه) با اولویت 13 بالاتر است. به همین دلیل است که در عبارت `"+apples + +oranges"` عملگرهای + یگانه پیش از علامت جمع اجرا می‌شوند.
+همانطور که می‌بینیم «عملگر + یگانه» اولویت `15` دارد که از عملگر جمع ( + دوگانه) با اولویت `12` بالاتر است. به همین دلیل است که در عبارت `"+apples + +oranges"` عملگرهای + یگانه پیش از علامت جمع اجرا می‌شوند.
 
 ## مقداردهی
 
-در نظر داشته باشید که مقداردهی با علامت `=` نیز یک عملگر است. در جدول اولویت‌ها با اولویت پایین `3` قرار گرفته است.
+در نظر داشته باشید که مقداردهی با علامت `=` نیز یک عملگر است. در جدول اولویت‌ها با اولویت پایین `2` قرار گرفته است.
 
 به همین دلیل است که وقتی متغیری را مقدار دهی می‌کنیم، مانند `x = 2 * 2 + 1`، ابتدا عملیات محاسباتی انجام شده و سپس مقداردهی `=` صورت می‌گیرد و نتیجه را داخل `x` ذخیره می‌کند. 
 

1-js/02-first-steps/17-arrow-functions-basics/article.md

@@ -48,7 +48,7 @@ alert(sum(1, 2)); // 3
   alert( double(3) ); // 6
   ```
 
-- اگر آرگومان ورودی نداریم، پرانتزها خالی می‌مانند (ولی حتما باید حاضر باشند):
+- اگر آرگومان ورودی نداشته باشیم، پرانتزها خالی می‌مانند ولی حتما باید حاضر باشند:
 
   ```js run
   let sayHi = () => alert("Hello!");
@@ -74,9 +74,9 @@ welcome();
 
 ## وقتی Arrow Functionها چندخطی می‌شوند
 
-مثال‌های بالا از سمت چپ فلش `<=` آرگومان گرفتند و سمت راست را با آن محاسبه کردند.
+توابع کمانی که تا به اینجا دیدیم خیلی ساده بودند. آن‌ها آرگومان‌ها را از سمت چپ `=>` دریافت کردند، آن‌ها را ارزیابی کردند و عبارت سمت راست را از طریق آن‌ها برگرداندند.
 
-گاهی کد پیچیده‌تری داریم که چند expression یا statement دارد. در این مواقع باید کد را درون کمانک قرار دهیم. و درون کمانک نیز از `return` استفاده کنیم.
+گاهی اوقات ما به تابعی پیچیده‌تر همراه با چند عبارت و دستور نیاز داریم. در این صورت، می‌توانیم آن‌ها را درون آکولاد قرار دهیم. تفاوت اصلی این است که آکولادها برای برگرداندن یک مقدار به `return` نیاز دارند (درست مانند یک تابع عادی).
 
 مانند این:
 
@@ -103,7 +103,7 @@ alert( sum(1, 2) ); // 3
 
 ## خلاصه
 
-توابع Arrow function مناسب کدهای تک‌خطی هستند. و به‌صورت‌های مختلفی می‌توان از آن‌ها استفاده کرد.
+توابع Arrow function مناسب عملیات ساده خصوصا کدهای تک‌خطی هستند. آن‌ها دو حالت دارند:
 
-1. بدون کمانک: `(...args) => expression` -- سمت راست یک expression یا عبارت است: تابع آن را می‌خواند و نتیجه را برمی‌گرداند.
-2. با کمانک: `(...args) => { body }` -- کمانک‌ها به ما این امکان را می‌دهند تا چند statement را داخل تابع بنویسیم, اما در این صورت باید حتما از `return` برای بازگرداندن نتیجه استفاده کنیم.
+1. بدون آکولاد: `(...args) => expression` -- سمت راست یک expression یا عبارت است: تابع آن را ارزیابی می‌کند و نتیجه را برمی‌گرداند. اگر تنها یک آرگومان وجود داشته باشد، پرانتزها می‌توانند حذف شوند مانند `n => n * 2`.
+2. با آکولاد: `(...args) => { body }` -- آکولادها به ما این امکان را می‌دهند تا چند دستور را داخل تابع بنویسیم, اما در این صورت باید حتما از `return` برای بازگرداندن نتیجه استفاده کنیم.

1-js/03-code-quality/01-debugging-chrome/article.md

@@ -38,7 +38,7 @@
 
 بعد از اجرای تکه‌کد، نتایج آن در زیر آن نمایش داده می‌شوند.
 
-برای مثال، نتیجه `1+2` می‌شود `3`، و `hello("debugger")` چیزی را بر نمی‌گرداند، پس نتیجه `undefined` است:
+برای مثال، نتیجه `1+2` می‌شود `3`، در حالی که فراخوانی تابع `hello("debugger")` چیزی را بر نمی‌گرداند، پس نتیجه `undefined` است:
 
 ![](chrome-sources-console.svg)
 
@@ -63,12 +63,12 @@
 - و دیگر موارد...
 
 ```smart header="Conditional breakpoints"
-*راست کلیک* بر روی شمارهٔ خط این امکان را می‌دهد تا یک بریک‌پوینت *شرطی* تعریف کنیم. این بریک‌پوینت تنها زمانی صدازده می‌شود که شرط تعیین‌شده درست باشد.
+*راست کلیک* بر روی شمارهٔ خط این امکان را می‌دهد تا یک بریک‌پوینت *شرطی* تعریف کنیم. این بریک‌پوینت تنها زمانی صدازده می‌شود که شرط تعیین‌شده در هنگام ایجاد بریک‌پوینت درست باشد.
 
 این امکان می‌تواند برای زمانی که نیاز داریم تا تنها برای یک متغیر خاص یا پارامترهای خاصی برای فانکشن توقف کنیم کارآمد باشد. 
 ```
 
-## دستور debugger
+## دستور "debugger"
 
 ما همچنین می‌توانیم با استفاده از دستور  `debugger` کد را متوقف کنیم، مثلاً:
 
@@ -84,7 +84,7 @@ function hello(name) {
 }
 ```
 
-این امکان در زمانی که در یک ویرایش‌گر کد هستیم و نمی‌خواهیم به مرورگر برویم و اسکریپت را در developer tools پیدا کنیم و بریک‌پوینت را ست کنیم  خیلی مناسب است.
+چنین دستوری تنها زمانی که ابزارهای توسعه باز باشند کار می‌کند و در غیر این صورت مرورگر آن را نادیده می‌گیرد.
 
 
 ## توقف و گَشتن
@@ -99,7 +99,7 @@ function hello(name) {
 
 1. **`Watch` -- .نمایش مقادیر فعلی برای هر عبارت**
 
-    شما می‌تونید دکمه به‌علاوه  `+` رو فشار بدید و یک عبارت وارد کنید. اشکال‌زدا مقدار آن را در هر لحظه از فرآیند اجرا، به صورت خودکار دوباره محاسبه می‌کنه و نمایش خواهد داد.
+    شما می‌توانید دکمه به‌علاوه  `+` را فشار دهید و یک عبارت وارد کنید. اشکال‌زدا مقدار آن را در هر لحظه از فرآیند اجرا، به صورت خودکار دوباره محاسبه می‌کند و نمایش خواهد داد.
 
 2. **`Call Stack` -- .نمایش زنجیرهٔ صدازدن‌های تودرتو**
 
@@ -134,12 +134,12 @@ function hello(name) {
 
     کلیک کردن دوباره و دوباره این، گام‌به‌گام همهٔ عبارات اسکریپت را اجرا می‌کند.
 
-<span class="devtools" style="background-position:-62px -192px"></span> -- "Step over": دستور بعدی را اجرا می‌کند، اما *داخل یک تابع نمی‌شود*، میانبر `key:F10`.
-: شبیه دستور قبلی «step»، اما اگر عبارت بعدی یک تابع - که built-in نباشد، مانند `alert` باشد، بلکه یک تابع که خودمان آن را تعریف کرده باشیم - باشد، متقاوت رفتار می‌کند.
+<span class="devtools" style="background-position:-62px -192px"></span> -- «Step over»: دستور بعدی را اجرا می‌کند، اما *وارد یک تابع نمی‌شود*، میانبر `key:F10`.
+: مانند دستور قبلی «Step»، اما اگر عبارت بعدی یک فراخوانی تابع باشد متفاوت رفتار می‌کند (در مورد توابع built-in ماننند `alert` صادق نیست، تنها توابعی ما آن‌ها را تعریف می‌کنیم).
 
-    دستور «step» وارد آن می‌شود و فرآیند اجرا را در خطر اول آن متوقف می‌کند، در حالی که دستور «step over» صدازدن‌های تودرتو تابع را نامرئی اجرا می‌کند، از تابع‌های داخلی رد می‌شود.
+    اگر آن‌ها را مقایسه کنیم، دستور «Step» وارد یک فراخوانی تابع تودرتو می‌شود و فرآیند اجرا را در خط اول آن متوقف می‌کند، در حالی که دستور «Step over» فراخوانی‌های تودرتوی تابع را به صورت پنهانی اجرا می‌کند و از تابع‌های داخلی رد می‌شود.
 
-     سپس فرآیند اجرا بعد از آن تابع بلافاصله متوقف می‌شود.
+     سپس فرآیند اجرا بعد از آن فراخوانی تابع بلافاصله متوقف می‌شود.
 
     این دستور اگر نخواهیم ببینیم داخل تابع چه اتفاقی می‌افتد، می‌تواند مفید واقع شود.
 
@@ -155,7 +155,7 @@ function hello(name) {
 : این دکمه فرآیند اجرا را تغییر نمی‌ده. فقط برای خاموش/روشن کردن بریک‌پوین‌ها به صورت کلی‌ست.
 
 <span class="devtools" style="background-position:-90px -146px"></span> -- enable/disable automatic pause in case of an error.
-: زمانی که فعال باشد، و Developer tools باز باشد، در زمان وقوع خطا اسکریپت به صورت خودکار متوقف می‌شود. بعد از آن می‌توانیم متغیرها را تحلیل کنیم تا مشکل را پیدا کنیم. پس اگر اسکریپت ما با یک خطا از کار افتاد، می‌توانیم اشکال‌زدا را باز کنیم، این امکان را فعال کنیم و صفحه را مجدداً بارگزاری کنیم تا ببینیم مشکل در کجا بوده است و نوشته در آن لحظه چه بوده است.
+: زمانی که فعال باشد، و Developer tools باز باشد، در زمان وقوع خطا اسکریپت به صورت خودکار متوقف می‌شود. بعد از آن می‌توانیم درون اشکال‌زدا متغیرها را تحلیل کنیم تا مشکل را پیدا کنیم. پس اگر اسکریپت ما با یک خطا از کار افتاد، می‌توانیم اشکال‌زدا را باز کنیم، این امکان را فعال کنیم و صفحه را مجدداً بارگیری کنیم تا ببینیم مشکل کجا بوده و نوشته در آن لحظه چه بوده است.
 
 ```smart header="Continue to here"
 راست کلیک برروی یک خط کد  context menu را باز می‌کند همراه با امکانی عالی که  «Continue to here» نامیده می‌شود.
@@ -187,7 +187,7 @@ for (let i = 0; i < 5; i++) {
 2. عبارات  `debugger`.
 3. یک خطا (اگر dev tools باز باشد و دکمه <span class="devtools" style="background-position:-90px -146px"></span> «on» باشد).
 
-وقتی متوقف شد، می‌توانیم اشکال‌زدایی کنیم - بررسی توابع و ردیابی کد تا ببینیم کجای فرآیند اجرا به مشکل خورده است.
+وقتی متوقف شد، می‌توانیم اشکال‌زدایی کنیم: متغیرها را بررسی کنیم و کد را تحت نظر بگیریم تا ببینیم کجای فرآیند اجرا به مشکل خورده است.
 
 امکانات بسیار زیادتری در developer tools از چیزی که در این‌جا گفته شد وجود دارد. توضیحات کامل در <https://developers.google.com/web/tools/chrome-devtools> قابل دسترس است.
 

1-js/03-code-quality/06-polyfills/article.md

@@ -42,7 +42,7 @@ height = height !== undefined && height !== null ? height : 100;
 
 حالا که صحبتش شد، بهتر است بدانید [Babel](http://babeljs.io/) یکی از برجسته‌ترین ترنسپایلرها است.
 
-سیستم‌های build پروژه مدرن مثل [webpack](http://webpack.github.io/) این امکان را می‌دهند که بعد از هر بار تغییر کد، ترنسپایلر به‌صورت اتوماتیک اجرا شود و برای همین ادغام کردن آن در روند توسعه کار بسیار ساده‌ای است.
+سیستم‌های build پروژه مدرن مثل [webpack](https://webpack.js.org/) این امکان را می‌دهند که بعد از هر بار تغییر کد، ترنسپایلر به‌صورت اتوماتیک اجرا شود و برای همین ادغام کردن آن در روند توسعه کار بسیار ساده‌ای است.
 
 ## پلیفیل‌ها
 
@@ -82,7 +82,7 @@ if (!Math.trunc) { // اگر چنین تابعی وجود ندارد
 
 فراموش نکنید که از یک ترنسپایلر (اگر از syntax یا عملگرهای مدرن استفاده می‌کنید) و پلیفیل‌ها (برای اضافه کردن تابع‌هایی که ممکن است موجود نباشند) استفاده کنید. و با این کار مطمئن خواهید بود که کد شما کار می‌کند.
 
-برای مثال، بعدها که با جاوااسکریپت آشنایی بیشتری پیدا کنید، می‌توانید یک سیستم build کد با [webpack](http://webpack.github.io/) و پلاگین [babel-loader](https://github.com/babel/babel-loader) راه‌اندازی کنید.
+برای مثال، بعدها که با جاوااسکریپت آشنایی بیشتری پیدا کنید، می‌توانید یک سیستم build کد با [webpack](https://webpack.js.org/) و پلاگین [babel-loader](https://github.com/babel/babel-loader) راه‌اندازی کنید.
 
 منابع خوبی که نشان می‌دهند فیچرهای مختلف در چه حالتی از پشتیبانی قرار دارند:
 - <https://kangax.github.io/compat-table/es6/> - برای جاوااسکریپت.