Sync with upstream

Author: OmarioHassan

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

@@ -1,7 +1,6 @@
 # مقدّمة لجافا سكريبت
 
 دعونا نرى ما يميز جافا سكريبت ، وما يمكننا تحقيقه بها ، وأي التقنيات الأخرى التي تعمل بشكل جيد معها.
-
 ## ماهي جافا سكريبت؟
 
 *جافا سكريبت* تم إنشائها في بادئ الأمر "لجعل الصفحات الإلكترونية حية".
@@ -12,7 +11,7 @@
 
 في هذا الجانب ، تختلف جافا سكريبت اختلافًا كبيرًا عن لغة أخرى تسمى [جافا](https://ar.wikipedia.org/wiki/جافا_(لغة_برمجة))
 
-```smart header="لماذا تم تسميتها<u>جافا</u>سكريبت؟" 
+```smart header="لماذا تم تسميتها <u>جافا</u>سكريبت؟" 
 عندما تم إنشاء جافا سكريبت، كانت تحمل اسما اخر  "لايفسكربت".
 
 ولكن كان لجافا شعبية كبيره في ذلك الوقت، لذلك تقرّر أن وضع لغة جديدة كـ "الأخ الأصغر" لجافا سيساعد.
@@ -24,9 +23,9 @@
 
 المحركات المختلفة لها "أسماء رمزية" مختلفة. على سبيل المثال:
 
-- [في8](https://ar.wikipedia.org/wiki/كروم_في_8) -- في كروم و اوبرا.
+- [في 8](https://ar.wikipedia.org/wiki/كروم_في_8) -- في كروم و اوبرا.
 - [سبايدر مونكي](https://ar.wikipedia.org/wiki/سبايدر_مونكي_(محرك_جافا_سكريبت)) -- في فايرفوكس.
-- ...هناك أسماء رمزية أخرى مثل  "تريدانت" و "تشاكرا" لاصدارات مختلفه من انترنت اكسبلورر، "تشاكرا كور" لمايكروسوفت إيدج،  "نيترو" و "سكيرلفيش" لسفاري، إلخ. 
+- ...هناك أسماء رمزية أخرى مثل "تشاكرا" لاصدارات مختلفه من انترنت اكسبلورر، "تشاكرا كور" لمايكروسوفت إيدج،  "نيترو" و "سكيرلفيش" لسفاري، إلخ. 
 
 من الجيد تذكر المصطلحات الواردة أعلاه لأنها مستخدمة في مقالات المطورين على الإنترنت. سنستخدمهم أيضًا. على سبيل المثال ، إذا كانت "الميزة إكس مدعومة بواسطة في8" ، فمن المحتمل أنها تعمل في كروم و أوبرا.
 
@@ -110,15 +109,17 @@
 
 أمثلة على هذه اللغات:
 
-- [كوفي سكريبت](http://coffeescript.org/) هو "سكر نحوي" لجافا سكريبت. إنه يقدم بناء جمل أقصر ، مما يسمح لنا بكتابة كود أكثر وضوحًا ودقة. عادة ،مطورو الروبي يحبونها.
-- يركز [تايب سكريبت](http://www.typescriptlang.org/) على إضافة "كتابة بيانات صارمة" لتبسيط تطوير ودعم الأنظمة المعقدة. تم تطويره بواسطة ميكروسوفت.
-- يضيف [فلاو](http://flow.org/) أيضًا كتابة البيانات ، ولكن بطريقة مختلفة. تم تطويره بواسطة فايسبوك.
+- [كوفي سكريبت](http://coffeescript.org/) هو "سكر نحوي" لجافا سكريبت. إنه يقدم بناء جمل أقصر ، مما يسمح لنا بكتابة كود أكثر وضوحًا ودقة. عادة ،مطورو روبي يحبونها.
+- [تايب سكريبت](http://www.typescriptlang.org/) يركز على إضافة "كتابة بيانات صارمة" لتبسيط تطوير ودعم الأنظمة المعقدة. تم تطويره بواسطة ميكروسوفت.
+- [فلو](http://flow.org/) يضيف أيضًا كتابة البيانات ، ولكن بطريقة مختلفة. تم تطويره بواسطة فايسبوك.
 - [دارت](https://www.dartlang.org/) هي لغة قائمة بذاتها لها محركها الخاص الذي يعمل في بيئات غير المتصفح (مثل تطبيقات الهاتف المحمول) ، ولكن يمكن أيضًا تحويلها إلى جافا سكريبت. من تطوير جوجل.
+- [بريثون](https://brython.info/) هو محول من بايثون إلى جافا سكريبت و الذي يمكّن من كتابة التطبيقات بلغة بايثون بشكل كامل بدون جافا سكريبت.
+- [كوتلن](https://kotlinlang.org/docs/reference/js-overview.html) هي لغة برمجة حديثة وموجزة وآمنة يمكنها استهداف المتصفح أو نود.
 
 هناك أكثر. بالطبع ، حتى لو استخدمنا إحدى اللغات المترجمة ، يجب أن نعرف أيضًا جافا سكريبت لفهم ما نقوم به حقًا.
 
 ## ملخص
 
 - تم إنشاء جافا سكريبت في البداية كلغة للمتصفح فقط ، ولكنها تُستخدم الآن في العديد من البيئات الأخرى أيضًا.
 - تتمتع جافا سكريبت اليوم بمكانة فريدة باعتبارها لغة المتصفح الأكثر استخدامًا مع تكاملها التام مع HTML / CSS.
-- هناك العديد من اللغات التي يتم "تحويلها" إلى جافا سكريبت وتوفر ميزات معينة. يوصى بإلقاء نظرة عليهم ، على الأقل لفترة وجيزة ، بعد إتقان جافا سكريبت.
+- هناك العديد من اللغات التي يتم "تحويلها" إلى جافا سكريبت وتوفر ميزات معينة. يوصى بإلقاء نظرة عليهم ، على الأقل لفترة وجيزة ، بعد إتقان جافا سكريبت.

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

@@ -16,20 +16,18 @@
 
 ## المراجع
 
-- **MDN (Mozilla) JavaScript Reference** هذا دليل بأمثلة ومعلومات أخرى. وهو مصدر جيد للحصول على معلومات تفصيلية حول ميزات اللغة، وطرق الكائنات المضمنة، وما إلى ذلك.
+- **MDN (Mozilla) JavaScript Reference** هو الدليل الرئيسي بالأمثلة والمعلومات الأخرى. وهو مصدر جيد للحصول على معلومات تفصيلية حول ميزات اللغة، وطرق الكائنات المضمنة، وما إلى ذلك.
 
 يمكن أن تجدها في <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
 
 أيضاً، غالباً ما يكون من الأفضل استخدام البحث عبر الإنترنت بدلاً من ذلك. فقط استخدم "[مصطلح] MDN" للإستعلام، مثال <https://google.com/search?q=MDN+parseInt> لتبحث عن دالة `parseInt`.
 
-* **MSDN** – مراجع ميكروسوفت يوجد بها معلومات كثيرة، متضمنة جافا سكريبت (غالباً يشار إليها JScript). إذا كنت تريد شيئا أكثر تخصصا عن انترنت اكسبلورر، من الأفضل الذهاب إلى: <http://msdn.microsoft.com/>.
-
-أيضاً، يمكن غن نستخدم بحث الإنترنت بعبارات مثل "RegExp MSDN" or "RegExp MSDN jscript".
 
 ## جدول التوافق
 
 جافا سكريبت لغة فى سياق متطور، تضاف إليها خصائص جديدة بانتظام.
 
+
 لتَّـحَقّـق من الدعم ما بين المتصفحات والمحركات الأخرى، انظر:
 
 - <http://caniuse.com> - جدول الدعم لكل خاصية، مثال: لترى أيًا من المحركات يدعم دوال التشفير الحديث: <http://caniuse.com/#feat=cryptography>.

1-js/01-getting-started/4-devtools/article.md

@@ -1,11 +1,17 @@
 # أدوات المطور
-أبقِ في بالك أن الشيفرة البرمجية عرضةً لاحتواء الكثير من الأخطاء، إذ احتمال ارتكابك الأخطاء كبير أثناء كتابة الشيفرة البرمجية، لا بل وقوعك فيها هو أمر حتمي طالما أنك إنسان ولست رجلًا آليًا. هل تصدق أنه حتى المبرمجين المتمرسين وذوي الخبرة الطويلة يرتكبون الكثير من الأخطاء في الشيفرة التي يكتبونها! لا تقلق فهذا أمر طبيعي.
-على أي حال، لا تُظهِر المتصفِّحات الأخطاء البرمجية تلقائيًا للمستخدمين. وعند وجود مشكلة ما في السكربت، ولا يمكنك آنذاك تحديد مكانها، وبالتالي لا يمكن إصلاحها. لذلك، أُضيفت «أدوات المطوّر» (developer tools) إلى المتصفِّحات لاسكتشاف الأخطاء وتوفير معلومات مفيدة عن السكربت لتحسينه.
+
+أبقِ في بالك أن الشيفرة البرمجية عرضةً لاحتواء الكثير من الأخطاء، إذ احتمال ارتكابك الأخطاء كبير أثناء كتابة الشيفرة البرمجية، لا بل وقوعك فيها هو أمر حتمي طالما أنك إنسان ولست [رجلًا آليًا](https://en.wikipedia.org/wiki/Bender_(Futurama)).
+
+لا تُظهِر المتصفِّحات الأخطاء البرمجية تلقائيًا للمستخدمين. وعند وجود مشكلة ما في السكربت، ولا يمكنك آنذاك تحديد مكانها، وبالتالي لا يمكن إصلاحها.
+
+لذلك، أُضيفت «أدوات المطوّر» (developer tools) إلى المتصفِّحات لاسكتشاف الأخطاء وتوفير معلومات مفيدة عن السكربت لتحسينه.
 
 يفضل معظم المطورون العمل على متصفِّحي Chrome أو FireFox لاحتوائهما على أفضل أدوات المطوّر. توفر المتصفِّحات الأخرى أيضًا مجموعة أدوات للمطوّر والتي من الممكن أن تحتوي على مزايا خاصة. لكن عادةً ما تحاول اللحاق بمتصفِّحي Chrome و FireFox الأفضل من هذه الناحية. يفضل المطوّرون بشكل عام العمل على متصفِّح واحد وينتقلون إلى متصفِّح آخر عندما تكون المشكلة التي يعملون عليها محدَّدة بهذا المتصفِّح.
 
 بناءً على ذلك، نجد أنَّ أدوات المطور مهمة للغاية لما تمتلكه من مزايا تساعدك أثناء مسيرتك في تطوير الويب عبر JavaScript. سنتعلم في البداية طريقة فتحها، واستخدامها لاستكشاف الأخطاء، وتشغيل تعليمات JavaScript ضمنها.
 
+أدوات المطور قوية, لديها العديد من الميزات. للبدء, سنتعلم كيفية فتحها ، والنظر في الأخطاء ، وتشغيل أوامر جافا سكريبت.
+
 ## أدوات المطور في متصفح Google Chrome
 قم بفتح الصفحة [bug.html](https://javascript.info/article/devtools/bug.html). يوجد خطأ في الشيفرة المكتوبة بلغة JavaScript غير ظاهر للزائر العادي، لذا سنستخدم أدوات المطوّر لاكتشافه.
 

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

@@ -15,7 +15,7 @@ message = 123456;
 لغات البرمجة التي تسمح بذلك مثل جافا سكريبت يطلق عليها 
 "dynamically typed" يعني أنه يوجد أنواع بيانات محددة لكن المتغيرات غير مقيدة بهم .
 
-## Number
+## الرقم
 
 ```js
 let n = 123;
@@ -67,7 +67,7 @@ n = 12.345;
 
 ## BigInt
 
-في جافا سكريبت، النوع "رقم"  لا يمثل الأعداد الصحيحة أكبر من <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> للأرقام السالبة. إنها قيود فنية ناتجة عن تمثيلهم الداخلي.
 
 لمعظم الأغراض هذا يكفي، لكن في بعض الأحيان نحتاج لأرقام كبيرة حقاً ، على سبيل المثال. للتشفير أو الطوابع الزمنية الدقيقة للميكرو ثانية.
 
@@ -83,10 +83,12 @@ const bigInt = 1234567890123456789012345678901234567890n;
 بما أن أرقام من نوع `BigInt` نحتاجها نادراً ، لن يتم تغطيتها هنا ، لكن سيفرد لها فصل مخصص  <info:bigint>. اقرأه عندما تحتاج لمثل هذه الأرقام الكبيرة.
 
 ```smart header="مشاكل توافقية"
-الأن `BigInt` متوافق مع الفايرفوكس والكروم ،لكن ليست متوافقة مع  سفاري/انترنت اكسبلورر/ايدج.
+الأن `BigInt` متوافق مع فايرفوكس/كروم/ايدج/سفاري ،لكن ليست متوافقة مع  إنترنت اكسبلورر
 ```
 
-## String
+You can check [*MDN* BigInt compatibility table](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt#Browser_compatibility) to know which versions of a browser are supported.
+
+## النص
 
 النص في جافا سكريبت يتم إحاطته بعلامات تنصيص.
 
@@ -128,7 +130,7 @@ alert( "the result is ${1 + 2}" ); // the result is ${1 + 2} (علامات ال
 ```smart header="لا يوجد نوع *character* ."
 في بعض اللغات، يوجد نوع خاص "character" يعبر عن الحرف الواحد. For example,على سبيل المثال، في لغة سي وجافا يدعى "char".
 
-في جافا سكريبت، لا يوجد مثل هذا النوع. يوجد نوع واحد فقط: `string`. النص قد يتكون من حرف واحد أو أكثر.
+في جافا سكريبت، لا يوجد مثل هذا النوع. يوجد نوع واحد فقط: `string`. النص قد يتكون من صفر حرف (نص فارغ), حرف واحد أو أكثر.
 ```
 
 ## Boolean (logical type)
@@ -256,9 +258,9 @@ typeof alert // "function"  (3)
 
 يوجد 8 أنواع للبيانات في جافا سكربت.
 
-- `number` للأرقام من أي نوع: صحيح أو عشري، الأعداد الصحيحة محدودة بy ±2<sup>53</sup>.
+- `number` للأرقام من أي نوع: صحيح أو عشري، الأعداد الصحيحة محدودة ب <code>±(2<sup>53</sup>-1)</code>.
 - `bigint` هو عدد صحيح طوله كبير.
-- `string` للنصوص. النص قد يحتوي على حرف أو أكثر، لا يوجد نوع منفصل للحرف الواحد.
+- `string` للنصوص. النص قد يحتوي على صفر حرف أو أكثر، لا يوجد نوع منفصل للحرف الواحد.
 - `boolean` من أجل `صواب`/`خطأ`.
 - `null` للقيم غير المعروفة -- نوع قائم بذاته له قيمة واحدة فقط `null`.
 - `undefined` للقيم غير المعينة -- نوع قائم بذاته له قيمة واحدة فقط `undefined`.

1-js/02-first-steps/08-operators/3-primitive-conversions-questions/solution.md

@@ -9,7 +9,6 @@ true + false = 1
 "$" + 4 + 5 = "$45"
 "4" - 2 = 2
 "4px" - 2 = NaN
-7 / 0 = Infinity
 "  -9  " + 5 = "  -9  5" // (3)
 "  -9  " - 5 = -14 // (4)
 null + 1 = 1 // (5)

1-js/02-first-steps/08-operators/3-primitive-conversions-questions/task.md

@@ -16,7 +16,6 @@ true + false
 "$" + 4 + 5
 "4" - 2
 "4px" - 2
-7 / 0
 "  -9  " + 5
 "  -9  " - 5
 null + 1