docs: improve translation & fix typos

Author: atefBB

1-js/04-object-basics/01-object/article.md

@@ -1,11 +1,11 @@
 
 # الكائنات
 
-كما عرفنا من فصل[أنواع البيانات](info:types), هنالك ثماني أنواع للبيانات في الجافا اسكريبت.سبعة منهم يسمون "أوليةprimitive",لأن قيمهم تحتوي شيئا واحداً (لتكن سلسلة نصية أو رقم أو أي شيْ)
+كما عرفنا من فصل [أنواع البيانات](info:types)، هنالك ثماني أنواع للبيانات في الجافاسكريبت. سبعة منهم يسمون "أولية primitive"، لأن قيمهم تحتوي شيئا واحداً (لتكن سلسلة نصية أو رقم أو أي شيْء).
 
-في المقابل,تستخدم الكائنات لحفظ مجموعات keyed collections من مختلف البيانات و الكيانات المركبة.في الجافا اسكريبت,تدخل الكائنات تقريبا في كل جانب من جوانب اللغة. لذا يتوجب علينا فهمها قبل التعمق في أي شيئ آخر.
+في المقابل، تستخدم الكائنات لحفظ مجموعات keyed collections من مختلف البيانات والكيانات المركبة.في الجافاسكريبت، تدخل الكائنات تقريبا في كل جانب من جوانب اللغة. لذا يتوجب علينا فهمها قبل التعمق في أي شيء آخر.
 
-يمكن إنشاء أي كائن باستخدام الأقواس المعقوصة `{…}` مع قائمة اختيارية بالخاصيات. الخاصية هي زوج من "مفتاح: قيمة" (`key: value`) إذ يكون المفتاح عبارة عن نص (يُدعى "اسم الخاصية")، والقيمة يمكن أن تكون أي شيء.
+يمكن إنشاء أي كائن باستخدام الأقواس المعقوفة `{…}` مع قائمة اختيارية بالخاصيات. الخاصية هي زوج من "مفتاح: قيمة" (`key: value`) إذ يكون المفتاح عبارة عن نص (يُدعى "اسم الخاصية")، والقيمة يمكن أن تكون أي شيء.
 
 يمكننا تخيل الكائن كخزانة تحوي ملفات. يُخزن كل جزء من هذه البيانات في الملف الخاص به باستخدام المفتاح. يمكن إيجاد، أو إضافة، أو حذف ملف باستخدام اسمه.
 
@@ -20,7 +20,7 @@ let user = {};  // "object literal" syntax
 
 ![](object-user-empty.svg)
 
-تُستخدم الأقواس المعقوصة `{...}` عادة، وهذا النوع من التصريح يُسمى «*الصياغة المختصرة لتعريف كائن*» (*object literal*).
+تُستخدم الأقواس المعقوفة `{...}` عادة، وهذا النوع من التصريح يُسمى «*الصياغة المختصرة لتعريف كائن*» (*object literal*).
 
 ## القيم المُجرَّدة والخاصيات
 
@@ -90,10 +90,10 @@ let user = {
   age: 30*!*,*/!*
 }
 ```
-وهذا يسمى فاصلة "زائدة" أو "معلقة". يجعل من السهل إضافة / إزالة / نقل الخصائص ، لأن جميع الأسطر تصبح متشابهة.
+وهذا يسمى فاصلة "زائدة" أو "معلقة". يجعل من السهل إضافة، إزالة، ونقل الخصائص، لأن جميع الأسطر تصبح متشابهة.
 
 ````smart header="الكائن المعرف بأنه ثابت يمكنه أن يتغير"
-يرجى ملاحظة: يمكن تعديل كائن معلن على أنه ثابت.
+ملاحظة: يمكن تعديل كائن معلن على أنه ثابت.
 
 مثلاً:
 
@@ -109,11 +109,11 @@ user.name = "Pete"; // (*)
 alert(user.name); // Pete
 ```
 
-قد يبدو أن الخط `(*)` سيسبب خطأ ، لكن لا. يُحدِّد "const" قيمة "user" ، وليس إصلاح محتوياتها.
+قد يبدو أن الخط `(*)` سيسبب خطأ، لكن ذلك لن يحدث. يُحدِّد "const" قيمة "user"، وليس إصلاح محتوياتها.
 
-لن يُظهر "const" خطأ إلا إذا حاولنا تعيين "user = ...` ككل.
+لن يُظهر "const" خطأ إلا إذا حاولنا تعيين "user = ...` كله.
 
-هناك طريقة أخرى لعمل خصائص كائن ثابتة ، وسنتناولها لاحقًا في الفصل<info:property-descriptors>.
+هناك طريقة أخرى لخلق خصائص كائن ثابتة، وسنتناولها لاحقًا في الفصل <info:property-descriptors>.
 ````
 
 ## الأقواس المربعة
@@ -125,11 +125,11 @@ alert(user.name); // Pete
 user.likes birds = true
 ```
 
-لا تفهم الجافا اسكريبت هذه الصيغه. يعتقد أننا نتعامل مع "user.likes" ، ثم تعطي خطأ في بناء الجملة عندما يصادف "birds" غير متوقعة
+لا تفهم الجافاسكريبت هذه الصيغه. يعتقد أننا نتعامل مع "user.likes"، ثم تعطي خطأ في بناء الجملة عندما يصادف "birds" غير متوقعة.
 
-تتطلب النقطة أن يكون المفتاح معرفًا متغيرًا صالحًا. هذا يعني: أنه لا يحتوي على مسافات ، ولا يبدأ برقم ولا يتضمن أحرفًا خاصة (يُسمح بـ `$` و` _`).
+تتطلب النقطة أن يكون المفتاح معرفًا متغيرًا صالحًا. هذا يعني: أنه لا يحتوي على مسافات، ولا يبدأ برقم ولا يتضمن أحرفًا خاصة (يُسمح بـ `$` و` _`).
 
-هناك بديل "رمز القوس المربع" يعمل مع أي سلسلة:
+هناك بديل "رمز القوس المربع" الذي يعمل مع أي سلسلة:
 
 ```js run
 let user = {};
@@ -146,7 +146,7 @@ delete user["likes birds"];
 
 الآن كل شيء على ما يرام. يرجى ملاحظة أن السلسلة داخل الأقواس مقتبسة بشكل صحيح (أي نوع من علامات الاقتباس ستفعل).
 
-توفر الأقواس المربعة أيضًا جلب اسم خاصية ناتجة عن قيمة أي تعبير  - على عكس السلسلة الحرفية - مثل المتغير كما يلي:
+توفر الأقواس المربعة أيضًا جلب اسم خاصية ناتجة عن قيمة أي تعبير -على عكس السلسلة الحرفية- مثل المتغير كما يلي:
 
 ```js
 let key = "likes birds";
@@ -155,7 +155,7 @@ let key = "likes birds";
 user[key] = true;
 ```
 
-هنا, المتغير`key` يمكن حسابه وقت التنفيذ run-time أو اعتمادا على ما يدخله المستخدم. من ثم نستخدمها للوصول إلى الخاصية.وهذا يمنحنا قدراً كبيراً من المرونة.
+هنا, المتغير `key` يمكن حسابه وقت التنفيذ (run-time) أو اعتمادا على ما يدخله المستخدم. من ثم نستخدمها للوصول إلى الخاصية. وهذا يمنحنا قدراً كبيراً من المرونة.
 
 مثلاً:
 
@@ -201,9 +201,9 @@ let bag = {
 alert( bag.apple ); // 5 if fruit="apple"
 ```
 
-معنى computed property بسيط: `[fruit]` تعني أن اسم الخاصية يجب أن يؤخذ من `fruit`.
+معنى computed property سهل: `[fruit]` تعني أن اسم الخاصية يجب أن يؤخذ من `fruit`.
 
-لذا, إذا أدخل الزائر `"apple"`, `bag` ستتحول `{apple: 5}`.
+لذا, إذا أدخل الزائر `"apple"`، `bag` ستتحول `{apple: 5}`.
 
 يعمل الأمر السابق بالطريقة التالية ذاتها:
 ```js run
@@ -225,13 +225,13 @@ let bag = {
 };
 ```
 
-الأقواس المربعة أقوى بكثير من استخدام الصيغة النُقطية.حيث تسمح باستخدام أي أسماء خصائص و متغيرات. لكنها أيضا أكثر إرهاقاً في الكتابة.
+الأقواس المربعة أقوى بكثير من استخدام الصيغة النُقطية. حيث تسمح باستخدام أي أسماء خصائص ومتغيرات. لكنها أيضا أكثر إرهاقاً في الكتابة.
 
-لذلك معظم الوقت, حينما يكون اسم خاصية معروفا أو بسيطا, تستخدم الصيغة النُقطية . وإذا أردنا شيئاً أكثر تعقيدا, ننتقل إلى استخدام الأقواس المربعة.
+لذلك، معظم الوقت، حينما يكون اسم خاصية معروفا أو غير مركب، تستخدم الصيغة النُقطية. وإذا أردنا شيئاً أكثر تعقيدا، ننتقل إلى استخدام الأقواس المربعة.
 
-## اختصار قيمة الخاصية(Property value shorthand)
+## اختصار قيمة الخاصية (Property value shorthand)
 
-في الكود الحقيقي ، غالبًا ما نستخدم المتغيرات الموجودة كقيم لأسماء الخصائص.
+في الشيفرة الحقيقية، غالبًا ما نستخدم المتغيرات الموجودة بصفتها قيَمًا لأسماء الخصائص.
 
 مثلاً:
 
@@ -248,9 +248,9 @@ let user = makeUser("John", 30);
 alert(user.name); // John
 ```
 
-في المثال السابق, تمتلك الخصائص نفس أسماء المتغيرات. حالة عمل خاصية من متغير هي أمر شائع جدا, that ذلك أنه من المميز وجود *اختصار قيمة الخاصية* لجعلها مختصرة .
+في المثال السابق، تمتلك الخصائص نفس أسماء المتغيرات. حالة عمل خاصية من متغير هي أمر شائع جدا، that ذلك أنه من المميز وجود *اختصار قيمة الخاصية* لجعلها مختصرة .
 
-بدلاً من `name:name` يمكننا فقط كتابة `name`, كهذا المثال:
+بدلاً من `name:name` يمكننا فقط كتابة `name`، كهذا المثال:
 
 ```js
 function makeUser(name, age) {
@@ -264,7 +264,7 @@ function makeUser(name, age) {
 }
 ```
 
-يمكننا استخدام كل من الخصائص العادية و والاختصارات كليهما في نفس الكائن object :
+يمكننا استخدام كل من الخصائص العادية والاختصارات كليهما في نفس الكائن:
 
 ```js
 let user = {
@@ -276,9 +276,9 @@ let user = {
 
 ## قيود أسماء الخصائص Property names limitations
 
-كما نعلم, لا يمكن للمتغير أن يمتلك اسماً يساوي واحداً من الكلمات المحفوظة للغة language-reserved words مثل "for", "let", "return" إلخ.
+كما نعلم، لا يمكن للمتغير أن يمتلك اسماً يساوي واحداً من الكلمات المحفوظة للغة (language-reserved words) مثل "for", "let", "return" إلخ.
 
-لكن بالنسبة لخاصية في كائن, لا توجد مثل هذه القيود:
+لكن بالنسبة لخاصية في كائن، لا توجد مثل هذه القيود:
 
 ```js run
 // كل هذه الخصائص صحيحة
@@ -292,11 +292,11 @@ alert( obj.for + obj.let + obj.return );  // 6
 ```
 
 
-باختصار, ليس هناك أي قيود لأسماء الخصائص property names. يمكن أن يكونوا أي حرف أو رمز (نوع مميز من identifiers, سيتم الحديث عنه لاحقاً).
+باختصار، ليس هناك أي قيود لأسماء الخصائص. يمكنها أن تكون أي حرف أو رمز (نوع مميز من identifiers، سيتم الحديث عنه لاحقاً).
 
 الأنواع الأخرى تتحول تلقائياً لسلاسل نصية strings.
 
-مثلاً, رقم `0` يتحول إلى حرف `"0"` عند استخدامه كاسم خاصية property key:
+مثلاً, رقم `0` يتحول إلى حرف `"0"` عند استخدامه اسما لخاصية:
 
 ```js run
 let obj = {
@@ -316,13 +316,13 @@ obj.__proto__ = 5; // assign a number
 alert(obj.__proto__); // [object Object] - the value is an object, didn't work as intended
 ```
 
-كما نرى من الكود , إعطاء قيمة أولية  primitive `5` يتم تجاهلها.
+كما نرى في الشيفرة أعلاه، إعطاء قيمة أولية `5` يتم تجاهلها.
 
-سوف نغطي طبيعة `__proto__` في [subsequent chapters](info:prototype-inheritance), واقتراح [ways to fix](info:prototype-methods) مثل هذا السلوك.
+سوف نغطي طبيعة `__proto__` في [subsequent chapters](info:prototype-inheritance)، واقتراح [ways to fix](info:prototype-methods) مثل هذا السلوك.
 
-## فحص الكينونة, "in" معامل
+## فحص الكينونة، "in" معامل
 
-ميزة ملحوظة للكائنات في الجافا اسكريبت ، مقارنة بالعديد من اللغات الأخرى ، هي أنه من الممكن الوصول إلى أي خاصية. لن يكون هناك خطأ إذا كانت الخاصية غير موجودة!
+ميزة ملحوظة للكائنات في الجافاسكريبت، مقارنة بالعديد من اللغات الأخرى، هي أنه من الممكن الوصول إلى أي خاصية. لن يكون هناك خطأ إذا كانت الخاصية غير موجودة!
 
 
 قراءة خاصية غير موجودة تُرجع فقط "غير محدد". لذا يمكننا بسهولة اختبار ما إذا كانت الخاصية موجودة:
@@ -333,7 +333,7 @@ let user = {};
 alert( user.noSuchProperty === undefined ); // "تحقق هذه الموازنة يشير إلى "عدم وجود الخاصية
 ```
 
-يوجد أيضا مُعامل خاصة `"in"` لفحص تواجد أي خاصية.
+يوجد أيضا مُعامل خاصة `"in"` لفحص وجود أي خاصية.
 
 The syntax is:
 ```js
@@ -351,7 +351,7 @@ alert( "blabla" in user ); // false, user.blabla غير موجود
 
 يرجى ملاحظة أنه في الجهة اليسرى من `in` يجب أن يكون هناك *اسم خاصية*. يكون عادة نصًا بين علامتي تنصيص.
 
-إذا حذفنا علامات التنصيص ، فهذا يعني متغيرًا ، يجب أن يحتوي على الاسم الفعلي المراد اختباره. على سبيل المثال:
+إذا حذفنا علامات التنصيص، فهذا يعني متغيرًا، يجب أن يحتوي على الاسم الفعلي المراد اختباره. على سبيل المثال:
 
 ```js run
 let user = { age: 30 };
@@ -362,9 +362,9 @@ alert( *!*key*/!* in user ); // true, خاصية "age" موجودة
 
 لماذا يوجد المعامل `in`? أليس من الكافي المقارنة مقابل `undefined`?
 
-حسناً, في معظم الأحيان المقارنة ب `undefined` تكون جيدة. ولكن هناك حالة خاصة عندما تفشل, لكن `"in"` تعمل بشكل صحيح.
+حسناً، في معظم الأحيان المقارنة بـ`undefined` تكون جيدة. ولكن هناك حالة خاصة عندما تفشل، لكن `"in"` تعمل بشكل صحيح.
 
-يحدث ذلك عند وجود خاصية  داخل كائن ، ولكنها تخزن قيمة `undefined`:
+يحدث ذلك عند وجود خاصية داخل كائن، ولكنها تخزن قيمة `undefined`:
 
 ```js run
 let obj = {
@@ -376,24 +376,24 @@ alert( obj.test ); // تعطي undefined, لذلك - ألا توجد هذه ال
 alert( "test" in obj ); // true, الخاصية موجودة بالفعل!
 ```
  
-في الكود السابق, الخاصية `obj.test` موجودة بالفعل. لذا معامل `in`يعمل بشكل صحيح.
+في الشيفرة السابقة، الخاصية `obj.test` موجودة بالفعل. لذا معامل `in`يعمل بشكل صحيح.
 
-مواقف كهذه تحدث نادراً, لأن `undefined` لا ينبغي تعيينها بشكل ذاتي. عادة ما نستخدم `null` ل "unknown" أو "empty" قيم . لذا معامل `in` يعتبر ضيفاً غريباً في الكود.
+مواقف مثل هذه تحدث نادراً، لأن `undefined` لا ينبغي تعيينها بشكل ذاتي. عادة ما نستخدم `null` للقيم غير المعروفة أو الفارغة. لذا معامل `in` يعتبر ضيفاً غريباً في الشيفرة.
 
 
 ## The "for..in" loop
 
-للمرور على كل مفاتيح الكائن, يوجد شكل خاص آخر للحلقة loop: `for..in`. هذه الحلقة مختلفة تمامًا عما درسناه سابقًا، أي الحلقة `for(;;)`.
+للمرور على كل مفاتيح الكائن، يوجد شكل خاص آخر للحلقة loop: `for..in`. هذه الحلقة مختلفة تمامًا عما درسناه سابقًا، أي الحلقة `for(;;)`.
 
-طريقة الكتابة في الكود:
+طريقة الكتابة في الشيفرة:
 
 ```js
 for (key in object) {
   //يتنفذ ما بداخل الحلقة لكل مفتاح ضمن خاصيات الكائن 
 }
 ```
 
-مثلاً, لنطبع جميع خاصيات الكائن `user`:
+مثلاً، لنطبع جميع خاصيات الكائن `user`:
 
 ```js run
 let user = {
@@ -410,13 +410,13 @@ for (let key in user) {
 }
 ```
 
-لاحظ أن جميع تراكيب "for" تتيح لنا تعريف متغير التكرار بِداخل الحلقة، مثل `let key` في المثال السابق,.
+لاحظ أن جميع تراكيب "for" تتيح لنا تعريف متغير التكرار بِداخل الحلقة، مثل `let key` في المثال السابق.
 
-أيضاً, يمكننا استخدام اسم متغير آخر بدلا من `key`. مثلا, `"for (let prop in obj)"` مستخدم أيضاَ بكثرة.
+أيضاً، يمكننا استخدام اسم متغير آخر بدلا من `key`. مثلا، `"for (let prop in obj)"` مستخدم أيضاَ بكثرة.
 
 ### الترتيب مثل الكائنات
 
-هل الكائنات مرتبة? بمعنى آخر, إن تنقلنا في حلقة خلال كائن, هل نحصل على جميع الخاصيات بنفس الترتيب الذي أُضيفت به؟ وهل يمكننا الاعتماد على هذا؟
+هل الكائنات مرتبة؟ بمعنى آخر، إن تنقلنا في حلقة خلال كائن، هل نحصل على جميع الخاصيات بنفس الترتيب الذي أُضيفت به؟ وهل يمكننا الاعتماد على هذا؟
 
 The short answer is: "ordered in a special fashion": integer properties are sorted, others appear in creation order. The details follow.