Merge pull request #181 from javascript-tutorial/sync-8d04d0d2

Sync with upstream @ 8d04d0d

Author: mahdyar

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

@@ -251,8 +251,18 @@ typeof alert // "function"  (3)
 سه خط آخر احتمالا نیاز به توضیحات بیشتری دارد:
 
 1. `Math` یک شیء built-in (از پیش نوشته شده در هسته زبان) است که عملیات متنوع ریاضیاتی را در اختیار ما قرار می‌دهد. ما آن را در فصل <info:number> یاد می‌گیریم. در اینجا صرفا یک مثال از آن را نمایش دادیم.
-2. خروجی `typeof null` همانطور که می‌بینید `"object"` است. این یک خطا در نوع کار `typeof` می‌باشد که به منظور سازگاری باقی مانده است. مطمئنا `null` یک object نیست. خودِ null یکی از انواع داده در جاوااسکریپت است. 
-3. خروجی `typeof alert` `"function"` است چراکه `alert` خودش هم یک تابع است. ما در بخش‌های بعدی با تابع‌ها بیشتر آشنا خواهیم شد و خواهیم آموخت که نوعی تحت عنوان function در جاوااسکریپت نداریم. تابع‌ها در اصل از نوعِ object هستند. اما عملگر `typeof` به آنها به طرز دیگری برخورد می‌کند و `function` را برمی‌گرداند. این هم از روزهای اول جاوااسکریپت وجود داشته است. به طور فنی، این رفتار درست نیست، اما در عمل می‌تواند مفید باشد.
+2. خروجی `typeof null` برابر با `"object"` است. این یک خطا در طرز کار `typeof` می‌باشد که از روزهای اول در جاوااسکریپت وجود داشته و به منظور سازگاری باقی مانده است. مطمئنا `null` یک object نیست. خودِ null یکی از انواع داده در جاوااسکریپت است. 
+3. خروجی `typeof alert` برابر با `"function"` است چراکه `alert` خودش هم یک تابع است. ما در بخش‌های بعدی با تابع‌ها بیشتر آشنا خواهیم شد و خواهیم آموخت که نوعی تحت عنوان function در جاوااسکریپت نداریم. تابع‌ها در اصل از نوعِ object هستند. اما عملگر `typeof` با آنها به طرز دیگری برخورد می‌کند و `function` را برمی‌گرداند. این هم از روزهای اول جاوااسکریپت وجود داشته است. به طور فنی، این رفتار درست نیست، اما در عمل می‌تواند مفید باشد.
+
+```smart header="سینتکس `typeof(x)`"
+شاید سینتکس دیگری را دیده باشید: `typeof(x)`. این با `typeof x` یکسان است.
+
+برای اینکه واضح باشد: `typeof` یک اپراتور است نه یک تابع. اینجا پرانتزها بخشی از `typeof` نیستند. این نوعی از پرانتز است که برای گروه‌بندی ریاضیاتی استفاده می‌شود.
+
+معمولا چنین پرانتزهایی یک عبارت ریاضیاتی، مانند `(2 + 2)`، را شامل می‌شوند اما اینجا آن‌ها فقط آرگومان `(x)` را دارند. از لحاظ سینتکس، آن‌ها به ما این امکان را می‌دهند که از وجود فاصله بین عملگر `typeof` و آرگومانش جلوگیری کنیم و بعضی از اشخاص آن را دوست دارند.
+
+بعضی از اشخاص `typeof(x)` را ترجیح می‌دهند اگرچه سینتکس `typeof x` رایج‌تر است.
+```
 
 ## خلاصه
 
@@ -269,7 +279,7 @@ typeof alert // "function"  (3)
 
 عملگر `typeof` به شما اجازه می‌دهد نوع مقدار ذخیره شده در یک متغیر را تشخصی دهید.
 
-- به دو طریق : `typeof x` و یا `typeof(x)`.
+- معمولا به صورت `typeof x` استفاده می‌شود، اما `typeof(x)` هم قابل قبول است.
 - یک رشته شامل اسم نوع را برمی‌گرداند، مثل `"string"`.
 - برای `null` مقدار `"object"` را نمایش می‌دهد -- این یک خطا در خودِ زبان است، در واقع null یک object نیست.
 

1-js/02-first-steps/16-function-expressions/article.md

@@ -12,17 +12,29 @@ function sayHi() {
 
 یک سینتکس دیگر هم برای ساخت تابع وجود دارد که *Function Expression* نامیده می‌شود.
 
-اینطور به نظر می‌رسد:
+این سینتکس به ما این امکان را می‌دهد که بین هر عبارتی یک تابع جدید بسازیم.
+
+برای مثال:
 
 ```js
 let sayHi = function() {
   alert( "سلام" );
 };
 ```
 
-اینجا، تابع ساخته شده و مثل هر مقدار دیگری، صراحتا به متغیر تخصیص داده شده است. فرقی ندارد که تابع چگونه تعریف شده، تابع فقط یک مقدار است که داخل متغیر `sayHi` ذخیره شده است.
+اینجا می‌توانیم متغیر `sayHi` را ببینیم که مقداری را دریافت می‌کند، تابع جدید، که به صورت `function() { alert("Hello"); }` ساخته شده است.
+
+چون ایجاد تابع با زمینه (context) عبارت مقداردهی (سمت راست `=`) رخ می‌دهد، این یک *Function Expression* است.
+
+لطفا در نظر داشته باشید، هیچ اسمی بعد از کلمه کلیدی `function` وجود ندارد. حذف کردن اسم برای Function Expressionها مجاز است.
+
+اینجا ما بلافاصله آن را به متغیر اختصاص می‌دهیم پس معنی این قطعه‌های کد یکسان است: «تابعی بساز و آن را درون متغیر `sayHi` قرار بده».
 
-معنی این مثال‌های کد یکسان است: "یک تابع بساز و آن را داخل متغیر `sayHi` بگذار".
+در موقعیت‌های پیشرفته‌تر، که بعدا به آن‌ها می‌رسیم، یک تابع ممکن است ایجاد و بلافاصله فراخوانی شود یا برای اینکه بعدا اجرا شود برنامه‌ریزی صورت گیرد و جایی ذخیره نشود، از این رو ناشناس بماند.
+
+## تابع یک مقدار است
+
+بیایید تکرار کنیم: مهم نیست که تابع چگونه ساخته شده است، یک تابع همیشه یک مقدار است. هر دو مثال بالا تابعی را درون متغیر `sayHi` ذخیره می‌کنند.
 
 ما حتی می‌توانیم آن مقدار را با استفاده از `alert` چاپ کنیم:
 
@@ -63,10 +75,10 @@ sayHi(); // سلام    //     هنوزم کار می‌کند (چرا نکند)
 2. خط `(2)` آن را داخل متغیر `func` کپی می‌کند. لطفا دوباره در نظر داشته باشید: هیچ پرانتزی بعد از `sayHi` وجود ندارد. اگر وجود داشت، سپس `func = sayHi()` *نتیجه صدا زدن* `sayHi()` را در `func` می‌نوشت، نه خود *تابع* `sayHi`.
 3. حالا تابع می‌تواند با `sayHi()` و `func()` صدا زده شود.
 
-همچنین توجه داشته باشید که ما می‌توانستیم از یک Function Expression برای تعریف `sayHi` در خط اول، استفاده کنیم:
+همچنین می‌توانستیم از یک Function Expression برای تعریف `sayHi` در خط اول، استفاده کنیم:
 
 ```js
-let sayHi = function() {
+let sayHi = function() { // (1) ایجاد
   alert( "سلام" );
 };
 
@@ -90,9 +102,9 @@ let sayHi = function() {
 }*!*;*/!*
 ```
 
-جواب ساده است:
-- هیچ نیازی به `;` در انتهای بلوک‌های کد و ساختارهای سینتکس که از آنها مثل `if { ... }`، `for {  }`، `function f { }` و... استفاده می‌شود نیست.
-- یک Function Expression به عنوان یک مقدار، در داخل دستور استفاده می‌شود: `let sayHi = ...;`.این یک بلوک کد نیست، بلکه یک تخصیص دادن است. نقطه ویرگول `;` در انتهای دستورها پیشنهاد می‌شود، بدون توجه به اینکه مقدار چه چیزی باشد. پس نقطه ویرگول در اینجا به خود Function Expression مربوط نیست، فقط دستور را به پایان می‌رساند.
+جواب ساده است: یک Function Expression به صورت `function(…) {…}`، در داخل دستور مقداردهی استفاده می‌شود: `let sayHi = ...;`. نقطه ویرگول `;` در انتهای دستور پیشنهاد می‌شود، این علامت جزء سینتکس تابع نیست.
+
+نقطه ویرگول برای مقداردهی ساده‌تر وجود دارد مثل `let sayHi = 5;` و همچنین برای مقداردهی تابع نیز وجود دارد.
 ````
 
 ## تابع‌های Callback

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

@@ -5,10 +5,10 @@
 به‌خاطر شکلی که دارد، arrow functions نام گرفته است.
 
 ```js
-let func = (arg1, arg2, ..., argN) => expression
+let func = (arg1, arg2, ..., argN) => expression;
 ```
 
-...این کد یک تابع `func` می‌سازد که دو آرگومان `arg1..argN` می‌پذیرد و با استفاده از این دو آرگومان `expression` سمت راست را محاسبه می‌کند و نتیجه را برمی‌گرداند.
+...این کد یک تابع `func` می‌سازد که آرگومان‌های `arg1..argN` را می‌پذیرد و با استفاده از این آرگومان‌ها `expression` سمت راست را ارزیابی می‌کند و نتیجه آن را برمی‌گرداند.
 
 به بیانی دیگر، این کد نسخه‌ی کوتاه‌شده کد زیر است:
 

1-js/04-object-basics/04-object-methods/8-chain-calls/solution.md

@@ -23,7 +23,7 @@ let ladder = {
   }
 };
 
-ladder.up().up().down().up().down().showStep(); // 1
+ladder.up().up().down().showStep().down().showStep(); // اول 1 را نشان می‌دهد و سپس 0 را
 ```
 
 همچنین می‌توانیم به ازای هر خط یک بار صدا بزنیم. برای زنجیره‌های طولانی این روش خوانایی بیشتری دارد:
@@ -33,7 +33,7 @@ ladder
   .up()
   .up()
   .down()
-  .up()
+  .showStep() // 1
   .down()
-  .showStep(); // 1
+  .showStep(); // 0
 ```

1-js/04-object-basics/04-object-methods/8-chain-calls/task.md

@@ -28,12 +28,14 @@ ladder.up();
 ladder.up();
 ladder.down();
 ladder.showStep(); // 1
+ladder.down();
+ladder.showStep(); // 0
 ```
 
 کد `up`، `down` و `showStep` را تغییر دهید تا صدازدن‌ها را زنجیره‌ای کنید، مثل این:
 
 ```js
-ladder.up().up().down().showStep(); // 1
+ladder.up().up().down().showStep().down().showStep(); // اول 1 را نشان می‌دهد سپس 0 را
 ```
 
 چنین روشی در بین کتابخانه‌های جاوااسکریپت به طور گسترده استفاده می‌شود.

1-js/04-object-basics/08-symbol/article.md

@@ -161,7 +161,7 @@ for (let key in user) alert(key); // name, age (بدون سمبل)
 alert( "به طور مستقیم: " + user[id] );
 ```
 
-همچنین `Object.keys(user)` هم آنها را نادیده می‌گیرد. این یک بخش از اصل کلی «مخفی‌سازی ویژگی‌های سمبلی» است. اگر یک اسکریپت یا کتابخانه دیگر در شیء ما حلقه بزند، به تصادفی به ویژگی سمبلی ما دسترسی نخواهد داشت.
+همچنین `Object.keys(user)` هم آنها را نادیده می‌گیرد. این بخشی از اصل کلی «مخفی‌سازی ویژگی‌های سمبلی» است. اگر یک اسکریپت یا کتابخانه دیگر در شیء ما حلقه بزند، به تصادفی به ویژگی سمبلی ما دسترسی نخواهد داشت.
 
 در مقابل، [Object.assign](mdn:js/Object/assign) هم ویژگی‌های رشته و هم سمبل را کپی می‌کند:
 

1-js/06-advanced-functions/04-var/article.md

@@ -256,11 +256,11 @@ function go() {
 ```js run
 // IIFE راه‌هایی برای ایجاد
 
-(function() {
+*!*(*/!*function() {
   alert("پرانتزهای دور تابع");
 }*!*)*/!*();
 
-(function() {
+*!*(*/!*function() {
   alert("پرانتزهای دور تمام عبارت");
 }()*!*)*/!*;
 

2-ui/1-document/05-basic-dom-node-properties/article.md

@@ -27,7 +27,7 @@ The classes are:
     - [HTMLAnchorElement](https://html.spec.whatwg.org/multipage/semantics.html#htmlanchorelement) -- the class for `<a>` elements,
     - ...and so on.
 
-There are many other tags with their own classes that may specific properties and methods, while some elements, such as `<span>`, `<section>`, `<article>` do not have any specific properties, so they are instances of `HTMLElement` class.
+There are many other tags with their own classes that may have specific properties and methods, while some elements, such as `<span>`, `<section>`, `<article>` do not have any specific properties, so they are instances of `HTMLElement` class.
 
 So, the full set of properties and methods of a given node comes as the result of the inheritance.
 

2-ui/3-event-details/3-mousemove-mouseover-mouseout-mouseenter-mouseleave/mouseoverout-fast.view/script.js

@@ -3,7 +3,7 @@ parent.onmouseover = parent.onmouseout = parent.onmousemove = handler;
 
 function handler(event) {
   let type = event.type;
-  while (type < 11) type += ' ';
+  while (type.length < 11) type += ' ';
 
   log(type + " target=" + event.target.id)
   return false;

2-ui/3-event-details/6-pointer-events/article.md

@@ -271,7 +271,7 @@ Pointer events allow handling mouse, touch and pen events simultaneously, with a
 
 Pointer events extend mouse events. We can replace `mouse` with `pointer` in event names and expect our code to continue working for mouse, with better support for other device types.
 
-For drag'n'drops and complex touch interactions that the browser may decide to hijack and handle on its own - remember to cancel the default action on events and set `touch-events: none` in CSS for elements that we engage.
+For drag'n'drops and complex touch interactions that the browser may decide to hijack and handle on its own - remember to cancel the default action on events and set `touch-action: none` in CSS for elements that we engage.
 
 Additional abilities of pointer events are: