Translate Prototypal inheritance to AR

Author: Ahmed-Adel3

1-js/03-code-quality/05-testing-mocha/article.md

@@ -1,14 +1,14 @@
-# Automated testing with Mocha
+# الاختبار الآلي باستخدام Mocha
 
-Automated testing will be used in further tasks, and it's also widely used in real projects.
+سيتم استخدام الاختبار الآلي في مهام قادمة ، كما أنه يستخدم على نطاق واسع في المشاريع الحقيقية.
 
-## Why we need tests?
+## لماذا نحتاج إلى الاختبارات؟
 
-When we write a function, we can usually imagine what it should do: which parameters give which results.
+عندما نكتب دالة ، يمكننا عادةً تخيل ما يجب أن تفعله: أي من المعطيات تعطي النتائج.
 
-During development, we can check the function by running it and comparing the outcome with the expected one. For instance, we can do it in the console.
+أثناء التطوير ، يمكننا التحقق من الدالة عن طريق تشغيلها ومقارنة النتيجة بالنتيجة المتوقعة. على سبيل المثال ، يمكننا القيام بذلك في وحدة التحكم. (console).
 
-If something is wrong -- then we fix the code, run again, check the result -- and so on till it works.
+إذا كان هناك شيء خاطئ - ثم نقوم بإصلاح الكود ، ونعمل مرة أخرى ، ونتحقق من النتيجة - وهكذا حتى يعمل.
 
 But such manual "re-runs" are imperfect.
 

1-js/08-prototypes/01-prototype-inheritance/1-property-after-delete/solution.md

@@ -1,4 +1,4 @@
 
-1. `true`, taken from `rabbit`.
-2. `null`, taken from `animal`.
-3. `undefined`, there's no such property any more.
+1. `true`,  تأتي من `rabbit`.
+2. `null`,  تأتي من `animal`.
+3. `undefined`, إذ ليس هناك خاصية بهذا الاسم بعد الآن.

1-js/08-prototypes/01-prototype-inheritance/1-property-after-delete/task.md

@@ -1,12 +1,13 @@
-importance: 5
+_الأهمية: 5_
 
 ---
 
-# Working with prototype
+# العمل مع prototype
 
-Here's the code that creates a pair of objects, then modifies them.
+إليك شيفرة تُنشئ كائنين وتعدّلها.
+
+ما القيم الّتي ستظهر في هذه العملية؟
 
-Which values are shown in the process?
 
 ```js
 let animal = {
@@ -28,4 +29,4 @@ delete animal.jumps;
 alert( rabbit.jumps ); // ? (3)
 ```
 
-There should be 3 answers.
+ هنالك ثلاث إجابات.

1-js/08-prototypes/01-prototype-inheritance/2-search-algorithm/solution.md

@@ -1,5 +1,6 @@
 
-1. Let's add `__proto__`:
+1. لنُضيف خاصيات `__proto__`:
+
 
     ```js run
     let head = {
@@ -27,6 +28,7 @@
     alert( table.money ); // undefined
     ```
 
-2. In modern engines, performance-wise, there's no difference whether we take a property from an object or its prototype. They remember where the property was found and reuse it in the next request.
+2. حين نتكلّم عن المحرّكات الحديثة، فليس هناك فرق (من ناحية الأداء) لو أخذنا الخاصية من الكائن أو من النموذج الأولي، فهي تتذكّر مكان الخاصية وتُعيد استعمالها عند طلبها ثانيةً.
+
+فمثلًا ستتذكّر التعليمة `pockets.glasses` بأنّها وجدت `glasses` في كائن `head`، وفي المرة التالية ستبحث هناك مباشرة. كما أنّها ذكية لتُحدّث ذاكرتها الداخلية ما إن يتغيّر شيء ما لذا فإن الأداء الأمثل في أمان.
 
-    For instance, for `pockets.glasses` they remember where they found `glasses` (in `head`), and next time will search right there. They are also smart enough to update internal caches if something changes, so that optimization is safe.

1-js/08-prototypes/01-prototype-inheritance/2-search-algorithm/task.md

@@ -1,12 +1,13 @@
-importance: 5
+_الأهمية: 5_
 
 ---
 
-# Searching algorithm
+# خوارزمية بحث
 
-The task has two parts.
+ينقسم هذا التمرين إلى قسمين.
+
+لديك الكائنات التالية:
 
-Given the following objects:
 
 ```js
 let head = {
@@ -27,5 +28,7 @@ let pockets = {
 };
 ```
 
-1. Use `__proto__` to assign prototypes in a way that any property lookup will follow the path: `pockets` -> `bed` -> `table` -> `head`. For instance, `pockets.pen` should be `3` (found in `table`), and `bed.glasses` should be `1` (found in `head`).
-2. Answer the question: is it faster to get `glasses` as `pockets.glasses` or `head.glasses`? Benchmark if needed.
+
+1. استعمل `__proto__` لإسناد كائنات النموذج الأولي بحيث يكون البحث عن الخاصيات بهذه الطريقة: `pockets` ثمّ `bed` ثمّ `table` ثمّ `head` (من الأسفل إلى الأعلى على التتالي). فمثلًا، قيمة `pockets.pen` تكون `3` (من `table`)، وقيمة `bed.glasses` تكون `1` (من `head`).
+2. أجِب عن هذا السؤال: ما الأسرع، أن نجلب `glasses` هكذا `pockets.glasses` أم هكذا `head.glasses`؟ قِس أداء كلّ واحدة لو لزم.
+

1-js/08-prototypes/01-prototype-inheritance/3-proto-and-this/solution.md

@@ -1,7 +1,8 @@
-**The answer: `rabbit`.**
+**الإجابة هي: الكائن `rabbit`.**
 
-That's because `this` is an object before the dot, so `rabbit.eat()` modifies `rabbit`.
+لأنّ قيمة `this` هي الكائن قبل النقطة، بذلك يُعدّل `rabbit.eat()‎`.
 
-Property lookup and execution are two different things.
+عملية البحث عن الخاصيات تختلف تمامًا عن عملية تنفيذ تلك الخاصيات.
+
+نجد التابِع `rabbit.eat` سيُستدعى أولًا من كائن النموذج الأولي، وبعدها نُنفّذه على أنّ `this=rabbit`.
 
-The method `rabbit.eat` is first found in the prototype, then executed with `this=rabbit`.

1-js/08-prototypes/01-prototype-inheritance/3-proto-and-this/task.md

@@ -1,12 +1,13 @@
-importance: 5
+_الأهمية: 5_
 
 ---
 
-# Where does it write?
+#  أين سيحدث التعديل؟
 
-We have `rabbit` inheriting from `animal`.
+لدينا الكائن `rabbit` يرث من الكائن `animal`.
+
+لو استدعينا `rabbit.eat()‎` فأيّ الكائنين ستُعدل به الخاصية `full`، الكائن `animal` أم الكائن `rabbit`؟
 
-If we call `rabbit.eat()`, which object receives the `full` property: `animal` or `rabbit`? 
 
 ```js
 let animal = {

1-js/08-prototypes/01-prototype-inheritance/4-hamster-proto/solution.md

@@ -1,26 +1,27 @@
-Let's look carefully at what's going on in the call `speedy.eat("apple")`.
+لنرى ما يحدث داخل الاستدعاء `‎speedy.eat("apple")‏` بدقّة.
 
-1. The method `speedy.eat` is found in the prototype (`=hamster`), then executed with `this=speedy` (the object before the dot).
+1. نجد التابِع `speedy.eat` في كائن النموذج الأولي الهامستر (`=hamster`)، وبعدها ننفّذه بقيمة `this=speedy` (الكائن قبل النقطة).
 
-2. Then `this.stomach.push()` needs to find `stomach` property and call `push` on it. It looks for `stomach` in `this` (`=speedy`), but nothing found.
+2. بعدها تأتي مهمة البحث للتابِع `this.stomach.push()‎` ليجد خاصية المعدة `stomach` ويستدعي عليها `push`. يبدأ البحث عن `stomach` في `this` (أي في `speedy`)، ولكنّه لا يجد شيئًا.
 
-3. Then it follows the prototype chain and finds `stomach` in `hamster`.
+3. بعدها يتبع سلسلة الوراثة ويجد المعدة `stomach` في `hamster`.
 
-4. Then it calls `push` on it, adding the food into *the stomach of the prototype*.
+4. ثمّ يستدعي `push` عليها ويذهب الطعام في *معدة النموذج الأولي*.
 
-So all hamsters share a single stomach!
+بهذا تتشارك الهامسترات كلها معدةً واحدة!
 
-Both for `lazy.stomach.push(...)` and `speedy.stomach.push()`, the property `stomach` is found in the prototype (as it's not in the object itself), then the new data is pushed into it.
+أكان `lazy.stomach.push(...)‎` أم `speedy.stomach.push()‎`، لا نجد خاصية المعدة `stomach` إلّا في كائن النموذج الأولي (إذ ليست موجودة في الكائن نفسه)، بذلك ندفع البيانات الجديدة إلى كائن النموذج الأولي.
+
+لاحظ كيف أنّ هذا لا يحدث لو استعملنا طريقة الإسناد البسيط `this.stomach=‎`:
 
-Please note that such thing doesn't happen in case of a simple assignment `this.stomach=`:
 
 ```js run
 let hamster = {
   stomach: [],
 
   eat(food) {
 *!*
-    // assign to this.stomach instead of this.stomach.push
+    // نُسند إلى this.stomach بدلًا من this.stomach.push
     this.stomach = [food];
 */!*
   }
@@ -34,17 +35,18 @@ let lazy = {
   __proto__: hamster
 };
 
-// Speedy one found the food
+// وجد الهامستر السريع الطعام
 speedy.eat("apple");
 alert( speedy.stomach ); // apple
 
-// Lazy one's stomach is empty
+// معدة ذاك الكسول فارغة
 alert( lazy.stomach ); // <nothing>
 ```
 
-Now all works fine, because `this.stomach=` does not perform a lookup of `stomach`. The value is written directly into `this` object.
+الآن يعمل كلّ شيء كما يجب، إذ لا تبحث عملية الإسناد `this.stomach=‎` عن خاصية `stomach`، بل تكتبها مباشرةً في كائن الهامستر الّذي وجد الطعام (المستدعى قبل النقطة).
+
+ويمكننا تجنّب هذه المشكلة من الأساس بتخصيص معدة لكلّ هامستر (كما الطبيعي):
 
-Also we can totally avoid the problem by making sure that each hamster has their own stomach:
 
 ```js run
 let hamster = {
@@ -69,12 +71,12 @@ let lazy = {
 */!*
 };
 
-// Speedy one found the food
+// وجد الهامستر السريع الطعام
 speedy.eat("apple");
 alert( speedy.stomach ); // apple
 
-// Lazy one's stomach is empty
+// معدة ذاك الكسول فارغة
 alert( lazy.stomach ); // <nothing>
 ```
 
-As a common solution, all properties that describe the state of a particular object, like `stomach` above, should be written into that object. That prevents such problems.
+يكون الحلّ العام هو أن تُكتب الخاصيات كلّها الّتي تصف حالة الكائن المحدّد ذاته (مثل `stomach` أعلاه) - أن تُكتب في الكائن ذاته، وبهذا نتجنّب مشاكل تشارك المعدة.

1-js/08-prototypes/01-prototype-inheritance/4-hamster-proto/task.md

@@ -1,12 +1,13 @@
-importance: 5
+_الأهمية: 5_
 
 ---
 
-# Why are both hamsters full?
+# لماذا أصابت التخمة كِلا الهامسترين؟
 
-We have two hamsters: `speedy` and `lazy` inheriting from the general `hamster` object. 
+لدينا هامسترين، واحد سريع `speedy` وآخر كسول `lazy`، والاثنين يرثان كائن الهامستر العمومي `hamster`.
+
+حين نُعطي أحدهما الطعام، نجد الآخر أُتخم أيضًا. لماذا ذلك؟ كيف نُصلح المشكلة؟
 
-When we feed one of them, the other one is also full. Why? How can we fix it?
 
 ```js run
 let hamster = {
@@ -25,11 +26,11 @@ let lazy = {
   __proto__: hamster
 };
 
-// This one found the food
+// وجد هذا الهامستر الطعامَ قبل الآخر
 speedy.eat("apple");
 alert( speedy.stomach ); // apple
 
-// This one also has it, why? fix please.
+// هذا أيضًا وجده. لماذا؟ أصلِح الشيفرة.
 alert( lazy.stomach ); // apple
 ```