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

Author: mahdiHash

1-js/01-getting-started/1-intro/article.md

@@ -3,49 +3,31 @@
 این کتاب یک راهنما است که به شما کمک می‌کند در نهایت این زبان را بیاموزید. اما وقتی که شما با مفاهیم پایه‌ای آشنا شدید، به منابع دیگر نیاز خواهید داشت.
 ## مشخصات (Specification)
 
-**The ECMA-262 specification** شامل عمیق‌ترین، دقیق‌ترین و رسمی‌ترین اطلاعات در جاوا اسکریپت است که زبان را تعریف می‌کند.
+**The ECMA-262 specification** شامل عمیق‌ترین، دقیق‌ترین و رسمی‌ترین اطلاعات در جاوااسکریپت است که زبان را تعریف می‌کند.
 
 اما در ابتدا اگر بخواهیم آنقدر رسمی و دقیق باشیم، درک این زبان سخت می‌شود. بنابراین اگر به منبع اطلاعات قابل اعتماد در مورد جزئیات این زبان نیاز دارید، Specification بهترین مکان است. اما برای استفاده‌ی روزانه نیست.
 
-آخرین نوشته در <https://tc39.es/ecma262/> است.
+یک نسخه جدید از مشخصات هر سال منتشر می‌شود. میان این انتشارها، آخرین مشخصات در <https://tc39.es/ecma262> است.
 
 برای آگاهی از ویژگی‌های به روز که تقریبا استاندارد هستند، به <https://github.com/tc39/proposals> مراجعه کنید.
 
-همینطور اگر به دنبال برنامه‌نویسی مرورگر هستید، به [بخش دوم](info:browser-environment) مراجعه کنید.
-## کتابچه راهنما
 
-**MDN (Mozilla) JavaScript Reference** یک راهنما با مثال‌ها و اطلاعات دیگرست. خوب است که به عمق اطلاعات در مورد توابع زبان و متدها و غیره وارد شوید.
-میتوانید آنرا در <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference> پیدا کنید. 
+**MDN (Mozilla) JavaScript Reference** یک راهنمای اصلی با مثال‌ها و اطلاعات دیگرست. خوب است که به عمق اطلاعات در مورد توابع زبان و متدها و غیره وارد شوید.
 
-اگرچه اغلب اوقات بهتر است که در عوض، یک جستجویی در اینترنت بکنید. در عبارت مورد جستجوی خود "MDN [موضوع مورد نظر]" را قرار دهید. مثلا؛ در جستجوی تابع `parseInt`، <https://google.com/search?q=MDN+parseInt>.
+می‌توانید آنرا در <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference> پیدا کنید. 
 
-- **MSDN**، کتابچه راهنما مایکروسافت با بسیاری اطلاعات که شامل جاوا اسکریپت (که اغلب با اسم JScript آورده شده). اگر کسی به سوالی خاص در Internet Explorer نیاز داشت، بهتر است که به <http://msdn.microsoft.com/> مراجعه کند.
+اگرچه اغلب اوقات بهتر است که در عوض، یک جستجویی در اینترنت انجام دهید. در عبارت مورد جستجوی خود "MDN [موضوع مورد نظر]" را قرار دهید. مثلا؛ در جستجوی تابع `parseInt`، <https://google.com/search?q=MDN+parseInt>. 
 
-@@@needs translation@@@
-@@@old part@@@
-همینطور میتوانیم جستجوی اینترنتی با عباراتی مثل "RegExp MSDN" یا "RegExp MSDN jscript" را انجام دهیم.
-@@@old part@@@
-@@@new part@@@
-## پشتیبانی از ویژگی‌ها (Features)
-- **MDN (Mozilla) JavaScript Reference** is the main manual with examples and other information. It's great to get in-depth information about individual language functions, methods etc.
-@@@new part@@@
-@@@needs translation@@@
+## Compatibility tables
 
-جاوا اسکریپت یک زبان برنامه‌نویسیت که به طور منظم به آن خواص جدیدی اضافه می‌شود. 
+جاوااسکریپت یک زبان برنامه‌نویسیت که به طور منظم به آن خواص جدیدی اضافه می‌شود.
 
-@@@needs translation@@@
-@@@old part@@@
 برای دیدن پشتیبانی مرورگر و بقیه‌ی موتورها این‌ها را ببینید:
 
 - <http://caniuse.com> جدولی بر اساس پشتیبانی خواص. فرضاً برای دیدن اینکه کدام موتورها توابع مدرن  رمزنگاری را پشتیبانی میکند به <http://caniuse.com/#feat=cryptography> مراجعه کنید.
 
 - <https://kangax.github.io/compat-table> جدولی با ویژگی‌های زبان و موتورهایی که قابلیت پشتیبانی آنهارا دارند یا ندارند.
 
-تمام این منابع در توسعه و برنامه‌نویسی‌ در زندگی واقعی مفیدند چراکه بسیاری اطلاعات ارزشمند راجب جزئیات زبان، پشتیبانیشان و غیره را دارند.
-@@@old part@@@
-@@@new part@@@
-Although, it's often best to use an internet search instead. Just use "MDN [term]" in the query, e.g. <https://google.com/search?q=MDN+parseInt> to search for `parseInt` function.
-@@@new part@@@
-@@@needs translation@@@
+تمام این منابع در توسعه و برنامه‌نویسی‌ در زندگی واقعی مفید هستند چرا که بسیاری اطلاعات ارزشمند درباره جزئیات زبان، پشتیبانی آن‌ها و غیره را دارند.
 
-این صفحه را وقتی به اطلاعات دقیق یا یک ویژگی خاصی نیاز داشتید به یاد داشته باشید.
+این صفحه را وقتی به اطلاعات عمیق درباره یک ویژگی خاصی نیاز داشتید به یاد داشته باشید.

1-js/01-getting-started/2-manuals-specifications/article.md

@@ -12,8 +12,8 @@
 
 اگر هنوز یک IDE انتخاب نکرده‌اید، موارد زیر را در نظر داشته باشید : 
 
-- [Visual Studio Code](https://code.visualstudio.com/) : رایگان - Cross Platform و همچنین تعدادی از قابلیت‌های IDE ها را دارد 
-- [WebStorm](http://www.jetbrains.com/webstorm/) برای توسعه Front End . کمپانی Jetbrains همینطور IDE های دیگری را برای زبان‌های دیگر ارائه می‌کند (که رایگان نیستند) 
+- [Visual Studio Code](https://code.visualstudio.com/) (cross-platform، رایگان).
+- [WebStorm](http://www.jetbrains.com/webstorm/) (cross-platform، پولی).
 
 همینطور برای Windows می‌توانید از Visual Studio استفاده کنید (منظور Visual Studio Code نیست). Visual Studio یک نرم افزار غیر رایگان است و فقط بر روی Windows کار می‌کند که برای توسعه پلتفرم dot net مناسب است. نسخه رایگان این نرم افزار [Visual Studio Community](https://www.visualstudio.com/vs/community/) نام دارد.  
 
@@ -31,9 +31,9 @@
 
 موارد زیر ارزش توجه را دارند: 
 
-- [Atom](https://atom.io/): رایگان - Cross Platform 
-- [Sublime Text](http://www.sublimetext.com): رایگان برای مدت محدود - Cross Platform 
-- [Notepad++](https://notepad-plus-plus.org/): برای Windows - رایگان 
+- [Atom](https://atom.io/) (cross-platform، رایگان). 
+- [Sublime Text](http://www.sublimetext.com) (cross-platform، shareware).
+- [Notepad++](https://notepad-plus-plus.org/) (Windows، رایگان)
 - [Vim](http://www.vim.org/) و [Emacs](https://www.gnu.org/software/emacs/) هم اگر با نحوه کارشان آشنا باشید خوب هستند. 
 
 ## بیایید بحث نکنیم 
@@ -42,4 +42,4 @@
 
 ویرایشگرهای دیگری نیز وجود دارند پس همانی که مورد علاقه شماست را انتخاب کنید. 
 
-انتخاب ویرایشگر یا هر ابزار دیگری شخصی بوده و به نوع پروژه، عادات و سلیقه شخصی بستگی دارد. 
+انتخاب ویرایشگر یا هر ابزار دیگری شخصی بوده و به نوع پروژه، عادات و سلیقه شخصی بستگی دارد. 

1-js/01-getting-started/3-code-editors/article.md

@@ -194,7 +194,7 @@ let my-name; // خط‌های پیوند '-' در نام‌ها ممنوع هس
 ```
 
 ```smart header="بزرگی و کوچکی حروف مهم است"
-متغیر apple با Apple متفاوت است.
+متغیرهای apple و Apple دو متغیر متفاوت هستند.
 ```
 
 ````smart header="کاراکترهای غیر انگلیسی مجاز هستند ولی توصیه نمی‌شوند"
@@ -299,9 +299,9 @@ Constant بودن یک متغیر صرفا بدین معناست که مقدار
 const pageLoadTime = /* زمان بارگیری برای یک صفحه وب */;
 ```
 
-مقدار ثابت `pageLoadTime` پیش از اجرای برنامه مشخص نبوده و به همین دلیل به صورت عادی نوشته شده است. اما همچنان یک ثابت است چراکه زمان اجرای برنامه بعد از مقدار دهی دیگر تغییر نخواهد کرد.
+مقدار `pageLoadTime` پیش از اجرای برنامه مشخص نبوده و به همین دلیل به صورت عادی نوشته شده است. اما همچنان یک ثابت است چراکه زمان اجرای برنامه بعد از مقدار دهی دیگر تغییر نخواهد کرد.
 
-به تعبیری دیگر ثابت‌های با حروف بزرگ زمانی که اصطلاحا مقداری به صورت "hard code" شده داریم، به عنوان نام مستعار استفاده می‌شوند.
+به تعبیری دیگر، ثابت‌های با حروف بزرگ فقط به عنوان نام مستعار برای مقدار های «hard-coded» استفاده می‌شوند.
 
 ## نام‌های مناسب انتخاب کنید
 
@@ -342,4 +342,4 @@ const pageLoadTime = /* زمان بارگیری برای یک صفحه وب */;
 - `var` -- حالت قدیمی تعریف متغیر می‌باشد. معمولا اصلا از این روش استفاده نمی‌کنیم، اما تفاوت‌های آن را در بخش <info:var> بیان خواهیم کرد تا در صورت نیاز بتوانید از آن استفاده نمایید.
 - `const` -- همانند `let` است با این تفاوت که مقدار آن قابل تغییر نیست.
 
-نام متغیرها باید به گونه‌ای باشد که به ما اجازه دهد به راحتی متوجه شویم چه چیزی درون آن است.
+نام متغیرها باید به گونه‌ای باشد که به ما اجازه دهد به راحتی متوجه شویم چه چیزی درون آن است.

1-js/02-first-steps/04-variables/article.md

@@ -68,9 +68,20 @@ n = 12.345;
 
 ## BigInt [#bigint-type]
 
-در جاوااسکریپت، نوع "number" نمی‌تواند مقدارهای صحیح بیشتر از <code>(2<sup>53</sup>-1)</code> (برابر با `9007199254740991`) یا اعداد منفی کمتر از <code>-(2<sup>53</sup>-1)</code> را نشان دهد. این یک محدودیت فنی است که توسط نمایش درون زبانی آنها ایجاد شده است.
+در جاوااسکریپت، نوع "number" نمی‌تواند مقدارهای صحیح بیشتر از <code>(2<sup>53</sup>-1)</code> (برابر با `9007199254740991`) یا اعداد منفی کمتر از <code>-(2<sup>53</sup>-1)</code> برای اعداد منفی را نشان دهد.
 
-آن مقدار برای بیشتر کارها کافی است، اما گاهی به اعداد بسیار بزرگ نیاز داریم، برای مثال در کریپتوگرافی یا timestamps با دقت میکرو ثانیه.
+اگر بخواهیم خیلی دقیق باشیم، نوع "number" می‌تواند اعداد صحیح بزرگ‌تر براذخیره کند (اعدادی تا <code>1.7976931348623157 * 10<sup>308</sup></code>) اما بیرون از محدوده امن عدد صحیح <code>±(2<sup>53</sup>-1)</code>، خطای دقت به وجود می‌آید چون تمام رقم‌ها درون حافظه 64 بیتی جای نمی‌گیرند. بنابراین یک مقدار تقریبی ممکن است ذخیره شود.
+
+برای مثال، این دو عدد (کمی بیشتر از محدوده امن) یکسان هستند:
+
+```js
+console.log(9007199254740991 + 1); // 9007199254740992
+console.log(9007199254740991 + 2); // 9007199254740992
+```
+
+بنابراین، تمام اعداد صحیح فرد که از <code>(2<sup>53</sup>-1)</code> بیشتر هستند نمی‌توانند در نوع "number" ذخیره شوند.
+
+محدوده <code>±(2<sup>53</sup>-1)</code> برای بیشتر کارها کافی است، اما گاهی به اعداد بسیار بزرگ نیاز داریم، برای مثال در کریپتوگرافی یا timestamps با دقت میکرو ثانیه.
 
 نوع `BigInt` برای نمایش دادن اعداد صحیح که طول دلخواهی دارند به تازگی به زبان اضافه شده است.
 
@@ -270,19 +281,21 @@ typeof alert // "function"  (3)
 
 در جاوااسکریپت 8 نوع داده پایه‌ای وجود دارد.
 
-- `number` برای اعداد از هر دسته‌ای: عدد صحیح یا اعشاری، اعداد صحیح به <code>±(2<sup>53</sup>-1)</code> محدود می‌شوند.
-- `bigint` برای اعداد صحیح با طول دلخواه است.
-- `string` برای رشته‌ها. یک رشته ممکن است صفر کاراکتر یا بیشتر داشته باشد، هیج نوع جداگانه‌ی تک کاراکتری وجود ندارد.
-- `boolean` برای `true`/`false`.
-- `null` برای مقدارهای نامشخص -- یک نوع مستقل که فقط یک مقدار `null` دارد.
-- `undefined` برای مقدارهای تخصیص نیافته -- یک نوع مستقل که فقط یک مقدار `undefined` دارد.
-- `object` برای ساختارهای پیچیده‌تر داده.
-- `symbol` برای شناسه‌های یکتا.
+- هفت نوع داده اصلی:
+    - `number` برای اعداد از هر دسته‌ای: عدد صحیح یا اعشاری، اعداد صحیح به <code>±(2<sup>53</sup>-1)</code> محدود می‌شوند.
+    - `bigint` برای اعداد صحیح با طول دلخواه است.
+    - `string` برای رشته‌ها. یک رشته ممکن است صفر کاراکتر یا بیشتر داشته باشد، هیج نوع جداگانه‌ی تک کاراکتری وجود ندارد.
+    - `boolean` برای `true`/`false`.
+    - `null` برای مقدارهای نامشخص -- یک نوع مستقل که فقط یک مقدار `null` دارد.
+    - `undefined` برای مقدارهای تخصیص نیافته -- یک نوع مستقل که فقط یک مقدار `undefined` دارد.
+    - `symbol` برای شناسه‌های یکتا.
+- و یک نوع داده غیر اصلی:
+    - `object` برای ساختارهای پیچیده‌تر داده.
 
 عملگر `typeof` به شما اجازه می‌دهد نوع مقدار ذخیره شده در یک متغیر را تشخصی دهید.
 
 - معمولا به صورت `typeof x` استفاده می‌شود، اما `typeof(x)` هم قابل قبول است.
 - یک رشته شامل اسم نوع را برمی‌گرداند، مثل `"string"`.
 - برای `null` مقدار `"object"` را نمایش می‌دهد -- این یک خطا در خودِ زبان است، در واقع null یک object نیست.
 
-در فصل‌های بعدی، ما روی نوع‌های "اولیه" تمرکز می‌کنیم و هنگامی که با آنها بیشتر آشنا شدیم، به سراغ شیءها می‌رویم.
+در فصل‌های بعدی، ما روی نوع‌های "اولیه" تمرکز می‌کنیم و هنگامی که با آنها بیشتر آشنا شدیم، به سراغ شیءها می‌رویم.

1-js/02-first-steps/05-types/article.md

@@ -8,7 +8,7 @@
 
 
 ```smart header="هنوز در مورد object ها صحبت نکرده‌ایم"
-در این بخش در مورد object ها صحبت نمی‌کنیم. بجای آن ابتدا انواع اولیه را خواهیم آموخت. بعدتر زمانی که در مورد object ها آموختیم، در مورد چگونگی تبدیل object ها صحبت خواهیم کرد.
+در این بخش در مورد object ها صحبت نمی‌کنیم. فعلا فقط درباره انواع اولیه صحبت می‌کنیم.
 ```
 
 ## تبدیل به string
@@ -72,7 +72,7 @@ alert(age); // NaN, conversion failed
 |`undefined`|`NaN`|
 |`null`|`0`|
 |<code>true&nbsp;and&nbsp;false</code> | `1` and `0` |
-| `string` | فاصله‌های خالی ابتدا و انتها حذف می‌شوند. اگر رشته‌ی باقی مانده خالی باشد نتیجه `0` خواهد بود. در غیر اینصورت عدد موجود در رشته کاراکترها خوانده خواهد شد. همینطور اگر خطایی رخ دهد نتیجه `NaN` خواهد بود. |
+| `string` | فاصله‌های خالی ابتدا و انتها (شامل spaceها، tabها `\t`و خطوط جدید `\n` و دیگر موارد) حذف می‌شوند. اگر رشته‌ی باقی مانده خالی باشد نتیجه `0` خواهد بود. در غیر اینصورت عدد موجود در رشته کاراکترها «خوانده» خواهد شد. اگر خطایی رخ دهد نتیجه `NaN` خواهد بود. |
 
 Examples:
 
@@ -146,7 +146,7 @@ alert( Boolean(" ") ); // spaces, also true (any non-empty string is true)
 |`undefined`|`NaN`|
 |`null`|`0`|
 |<code>true&nbsp;/&nbsp;false</code> | `1 / 0` |
-| `string` | فاصله‌های خالی ابتدا و انتها حذف می‌شوند. اگر رشته‌ی باقی مانده خالی باشد نتیجه `0` خواهد بود. در غیر اینصورت عدد موجود در رشته کاراکترها خوانده خواهد شد. همینطور اگر خطایی رخ دهد نتیجه `NaN` خواهد بود. |
+| `string` | رشته همانطور که «هست» خوانده می‌شود و فاصله‌های خالی (شامل spaceها، tabها `\t`، خطوط جدید `\n` و غیره) نادیده گرفته می‌شوند. یک رشته خالی `0` می‌شود. ارور `NaN` را نتیجه می‌دهد. |
 
 **`تبدیل به boolean`** – در عملگرهای  منطقی رخ می‌دهد. از طریق `Boolean(value)` قابل انجام است.
 
@@ -165,4 +165,3 @@ alert( Boolean(" ") ); // spaces, also true (any non-empty string is true)
 - `"0"` و string حاوی جای خالی `"  "` به عنوان `boolean` برابر true خواهند بود.
 
 در اینجا در مورد تبدیل object ها صحبت نکردیم و در بخش‌های بعدی به آنها خواهیم پرداخت. 
-