Merge pull request #51 from javascript-tutorial/sync-69e44506

Sync with upstream @ 69e4450

Author: 3imed-jaberi

1-js/02-first-steps/03-strict-mode/article.md

@@ -19,7 +19,7 @@ For example:
 ...
 ```
 
-Quite soon we're going to learn functions (a way to group commands) soon, so let's note in advance that `"use strict"` can be put at the beginning of a function. Doing that enables strict mode in that function only. But usually people use it for the whole script.
+Quite soon we're going to learn functions (a way to group commands), so let's note in advance that `"use strict"` can be put at the beginning of a function. Doing that enables strict mode in that function only. But usually people use it for the whole script.
 
 ````warn header="Ensure that \"use strict\" is at the top"
 Please make sure that `"use strict"` is at the top of your scripts, otherwise strict mode may not be enabled.

1-js/02-first-steps/09-comparison/article.md

@@ -4,10 +4,10 @@
 
 : وفي لغة الجافسكريبت تكتب كما يلي 
 
-- أكبر من وأصغر من: <code>a &gt; b</code>, <code>a &lt; b</code>.
-- أكبر : <code>a &gt;= b</code>, <code>a &lt;= b</code>.
+- أكبر/أصغر من: <code>a &gt; b</code>, <code>a &lt; b</code>.
+- أكبر/أصغر من او يساوي: <code>a &gt;= b</code>, <code>a &lt;= b</code>.
 - يساوي: `a == b` ، يرجى ملاحظة أن علامة المساواة المزدوجة` = `تعني اختبار المساواة ، في حين أن كلمة واحدة` a = b` تعني  تعيين أو مساواة .
-- لا تساوي. في الرياضيات ، يكون الترميز في JavaScript مكتوب مثل a !=b 
+- لا تساوي. في الرياضيات يكون الترميز <code>&ne;</code> ،لكن في JavaScript تكتب هكذا <code>a != b</code>.
 
 في هذه المقالة سنتعلم المزيد عن الأنواع المختلفة من المقارنات ، وكيف تجعلها JavaScript ، بما في ذلك الخصائص المهمة.
 
@@ -211,4 +211,4 @@ alert( undefined == 0 ); // false (3)
 - تتم مقارنة السلاسل حرفًا بحرف في ترتيب "القاموس".
 - عند مقارنة القيم من أنواع مختلفة ، يتم تحويلها إلى أرقام (باستثناء التحقق من المساواة الصارم).
 - القيمتان "null" و "undefined" تساوي `==` بعضها البعض ولا تساوي أي قيمة أخرى.
-- كن حذرًا عند استخدام مقارنات مثل `>` أو `<` مع المتغيرات التي يمكن أن تكون أحيانًا `خالية / غير محددة '. يُعد التحقق من "null / undefined" بشكل منفصل فكرة جيدة.
+- كن حذرًا عند استخدام مقارنات مثل `>` أو `<` مع المتغيرات التي يمكن أن تكون أحيانًا `خالية / غير محددة '. يُعد التحقق من "null / undefined" بشكل منفصل فكرة جيدة.

1-js/02-first-steps/11-logical-operators/article.md

@@ -129,13 +129,13 @@ alert(undefined || null || 0); // 0 (الكل falsy, ترجع آخر قيمة)
     في هذا المثال سيتم طباعة الرسالة الأولى ولن يتم طباعة الثانية:
 
     ```js run no-beautify
-    *!*false*/!* || alert("printed");
     *!*true*/!* || alert("not printed");
+    *!*false*/!* || alert("printed");
     ```
 
     في السطر الثاني يتوقف العامل OR `||` مباشرة عند الوصول إلى `true` لذلك فإن `alert` لا ينفذ.
 
-    أحيانًا يستخدم الناس هذه الخاصية لتنفيذ أوامر فقط إذا كان الجزء الأيسر truthy.
+    أحيانًا يستخدم الناس هذه الخاصية لتنفيذ أوامر فقط إذا كان الجزء الأيسر زائف.
 
 ## && (AND)
 

1-js/02-first-steps/12-nullish-coalescing-operator/article.md

@@ -17,22 +17,27 @@ x = a !== null && a !== undefined ? a : b;
 
 هذا مثال أطول.
 
-لنفترض أن لدينا `firstName`, `lastName` أو `nickName` وجميعهم اختياريين.
+
+لنفترض أن لدينا مستخدم ولديه المتغيرات `firstName`, `lastName` أو `nickName` وجميعهم اختياريين.
 
 لنختار القيمة المعرفة ونعرضها (أو نعرض "Anonymous" إذا لم يحدد أي شئ):
 
+لنستخدم `??` لتحديد أول عامل محدد
+
 ```js run
 let firstName = null;
 let lastName = null;
 let nickName = "Supercoder";
 
-// show the first not-null/undefined variable
+// show the first not-null/undefined value
+*!*
 alert(firstName ?? lastName ?? nickName ?? "Anonymous"); // Supercoder
+*/!*
 ```
 
 ## المقارنة مع ||
 
-هذا مشابه جدًا للعامل `||`. في الحقيقة يمكننا استبدال `??` ب `||` في المثال السابق وسنحصل على نفس النتيجة.
+هذا مشابه جدًا للمعامل `||`. في الحقيقة يمكننا استبدال `??` ب `||` في المثال السابق وسنحصل على نفس النتيجة. كما وصفنا في [الفصل السابق](info:logical-operators#or-finds-the-first-truthy-value).
 
 الفرق الجوهري بينهما أن:
 
@@ -58,15 +63,17 @@ alert(height || 100); // 100
 alert(height ?? 100); // 0
 ```
 
-هنا `height || 100` تعامل الصفر مثل `null`, `undefined` أو أي قيمة falsy أخرىوهذا قد لا يكون صحيح أحيانًا.
+هنا `height || 100` تعامل الصفر كـ `null`, `undefined` أو أي قيمة زائفة. اذا الصفر يصبح `100`.
 
-ولكن `height ?? 100` ترجع `100` إذا كان فقط `height` يساوي تمامًا `null` أو `undefined`.
+ولكن `height ?? 100` ترجع `100` إذا كان فقط `height` يساوي تمامًا `null` أو `undefined`. اذا الصفر يبقى "كما هو".
+
+يعتمد السلوك الافضل على حالة الاستخدام. تكون `??` الطريقة الافضل عندما يكون صفر height قيمة صالحة.
 
 ## الأولوية
 
 أولوية العامل `??` هي قليلة: `7` وتساوي [MDN جدول](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Operator_Precedence#Table).
 
-هذا أقل من معظم العوامل وأكبر بقليل من `=` و `?`.
+هذا أقل من معظم المعاملات وأكبر بقليل من `=` و `?`.
 
 لذلك إذا أردنا استخدام `??` في تعبيرات معقدة نقوم بإضافة أقواس:
 
@@ -80,14 +87,16 @@ let area = (height ?? 100) * (width ?? 50);
 alert(area); // 5000
 ```
 
-إذا لم نستخدم الأقواس فإن `*` له أولوية أعلى وسينفذ أولًا كأننا كتبنا:
+من ناحية اخرى، إذا لم نستخدم الأقواس فإن `*` له أولوية أعلى وسينفذ أولًا كأننا كتبنا:
 
 ```js
 // غير صحيح
 let area = height ?? 100 * width ?? 50;
 ```
 
-هناك أيضًا قيود لغوية. لأسباب أمنية لا يمكن استخدام `??` مع `&&` أو `||`.
+هناك أيضًا قيود لغوية.
+
+**لأسباب أمنية، لا يمكن استخدام `??` مع `&&` و `||`.**
 
 هذا سينتج خطأ لغوي:
 
@@ -100,7 +109,9 @@ let x = 1 && 2 ?? 3; // Syntax error
 استخدم الأقواس لتجنب الخطأ:
 
 ```js run
+*!*
 let x = (1 && 2) ?? 3; // تعمل دون مشاكل
+*/!*
 alert(x); // 2
 ```
 

1-js/05-data-types/05-array-methods/12-reduce-object/_js.view/test.js

@@ -8,13 +8,14 @@ describe("groupById", function() {
     ];
 
     assert.deepEqual(groupById(users), {
-      john: {id: 'john', name: "John Smith", age: 20}
+      john: {id: 'john', name: "John Smith", age: 20},
       ann: {id: 'ann', name: "Ann Smith", age: 24},
       pete: {id: 'pete', name: "Pete Peterson", age: 31},
     });
   });
 
   it("works with an empty array", function() {
+    users = [];
     assert.deepEqual(groupById(users), {});
   });
 });

1-js/05-data-types/05-array-methods/12-reduce-object/task.md

@@ -23,7 +23,7 @@ let usersById = groupById(users);
 // after the call we should have:
 
 usersById = {
-  john: {id: 'john', name: "John Smith", age: 20}
+  john: {id: 'john', name: "John Smith", age: 20},
   ann: {id: 'ann', name: "Ann Smith", age: 24},
   pete: {id: 'pete', name: "Pete Peterson", age: 31},
 }

1-js/05-data-types/07-map-set/article.md

@@ -198,7 +198,7 @@ let prices = Object.fromEntries([
 alert(prices.orange); // 2
 ```
 
-We can use `Object.fromEntries` to get an plain object from `Map`.
+We can use `Object.fromEntries` to get a plain object from `Map`.
 
 E.g. we store the data in a `Map`, but we need to pass it to a 3rd-party code that expects a plain object.
 
@@ -220,7 +220,7 @@ let obj = Object.fromEntries(map.entries()); // make a plain object (*)
 alert(obj.orange); // 2
 ```
 
-A call to `map.entries()` returns an array of key/value pairs, exactly in the right format for `Object.fromEntries`.
+A call to `map.entries()` returns an iterable of key/value pairs, exactly in the right format for `Object.fromEntries`.
 
 We could also make line `(*)` shorter:
 ```js

1-js/05-data-types/11-date/6-get-seconds-today/solution.md

@@ -23,4 +23,6 @@ function getSecondsToday() {
   let d = new Date();
   return d.getHours() * 3600 + d.getMinutes() * 60 + d.getSeconds();
 }
+
+alert( getSecondsToday() );
 ```

1-js/07-object-properties/02-property-accessors/article.md

@@ -2,9 +2,7 @@
 
 يوجد نوعين من الخصائص.
 
-الأوّل هو خصائص البيانات _data properties_. نحن بالفعل نعلم كيف نتعامل مع هذا النوع. إذ كلّ ما استعملناه من البداية حتى الآن هو خصائص البيانات.
-
-النوع الثاني من الخصائص هو شيئ ما جديد. و هو _accessor properties_. هي دوال بشكل أساسي تجلب القيم و تضبطها, ولكن في الكود تظهرُ لنا وكأنها خصائص عادية.
+النوع الثاني من الخصائص هو شيئ ما جديد. و هو *accessor properties*. هي دوال بشكل أساسي تجلب القيم و تضبطها, ولكن في الكود تظهرُ لنا وكأنها خصائص عادية.
 
 ## الجالبات والضابطات
 

1-js/10-error-handling/1-try-catch/article.md

@@ -354,29 +354,32 @@ try {
 
 بالطبع ، كل شيء ممكن! المبرمجون يرتكبون الأخطاء. حتى في المرافق المفتوحة المصدر التي يستخدمها الملايين لعقود - فجأة يمكن اكتشاف خطأ يؤدي إلى اختراق رهيب.
 
-في حالتنا هذه, `try..catch` المقصود لالتقاط أخطاء "البيانات غير صحيحة".ولكن بطبيعتها ، `catch` يحصل على *كل* الأخطاء من `try`. هنا يحصل على خطأ غير متوقع, ولكن لا يزال يظهر `"JSON Error"`. هذا خطأ ويجعل أيضًا تصحيح التعليمات البرمجية أكثر صعوبة.
+في حالتنا هذه, `try..catch` المقصود لالتقاط أخطاء "البيانات غير صحيحة".ولكن بطبيعتها ، `catch` يحصل على *كل* الأخطاء من `try`. هنا يحصل على خطأ غير متوقع, ولكن لا يزال يظهر `"JSON Error"`. هذا خطأ ويجعل أيضًا تصحيح التعليمات البرمجية أكثر صعوبة.القاعدة بسيطة:
 
-لحسن الحظ ، يمكننا معرفة الخطأ الذي تحصلنا عليه ، على سبيل المثال من `name`:
+**يجب أن يقوم Catch بمعالجة الأخطاء التي يعرفها و "إعادة رمي" كل الآخرين فقط.**
+
+يمكن شرح تقنية "إعادة الرمي" بمزيد من التفصيل على النحو التالي:
+
+1. Catch يحصل على جميع الأخطاء.
+2. في `catch(err) {...}` نقوم بتحليل كائن الخطأ `err`.
+3. إذا لم نكن نعرف كيف نتعامل معها ، فنفعل `throw err`.
+
+عادة ، يمكننا التحقق من نوع الخطأ باستخدام العامل `instanceof`:
 
 ```js run
 try {
   user = { /*...*/ };
-} catch(e) {
+} catch(err) {
 *!*
-  alert(e.name); // "ReferenceError" for accessing an undefined variable
+  if (err instanceof ReferenceError) {
 */!*
+    alert('ReferenceError'); // "ReferenceError" للوصول إلى متغير غير محدد
+
+  }
 }
 ```
 
-القاعدة بسيطة:
-
-**يجب أن يقوم Catch بمعالجة الأخطاء التي يعرفها و "إعادة رمي" كل الآخرين فقط.**
-
-يمكن شرح تقنية "إعادة الرمي" بمزيد من التفصيل على النحو التالي:
-
-1. Catch يحصل على جميع الأخطاء.
-2. في `catch(err) {...}` نقوم بتحليل كائن الخطأ `err`.
-2. إذا لم نكن نعرف كيف نتعامل معها ، فنفعل `throw err`.
+يمكننا أيضًا الحصول على اسم فئة الخطأ من خاصية `err.name`. جميع الأخطاء الأصلية لديها هذه الخاصية. خيار آخر هو قراءة err.constructor.name.
 
 في الكود أدناه ، نستخدم إعادة رمي بحيث `catch` يعالج فقط `SyntaxError`:
 
@@ -399,7 +402,7 @@ try {
 } catch(e) {
 
 *!*
-  if (e.name == "SyntaxError") {
+  if (e instanceof SyntaxError) {
     alert( "JSON Error: " + e.message );
   } else {
     throw e; // إعادة رمي (*)
@@ -426,7 +429,7 @@ function readData() {
 */!*
   } catch (e) {
     // ...
-    if (e.name != 'SyntaxError') {
+    if (!(e instanceof SyntaxError)) {
 *!*
       throw e; // لا تعرف كيفية التعامل معه
 */!*