javascript-tutorial · javascript-translate-bot · Nov 24, 2020 · Nov 24, 2020 · Nov 25, 2020 · Nov 25, 2020
diff --git a/1-js/01-getting-started/1-intro/article.md b/1-js/01-getting-started/1-intro/article.md
@@ -1,6 +1,10 @@
 # مقدّمة للجافاسكربت
 
+<<<<<<< HEAD
 دعونا نرى ما يميز الجافاسكريبت ، وما يمكننا تحقيقه بها ، وأي التقنيات الأخرى التي تعمل بشكل جيد معها.
+=======
+Let's see what's so special about JavaScript, what we can achieve with it, and what other technologies play well with it.
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
 
 ## ماهي الجافاسكربت؟
 
@@ -28,7 +32,13 @@
 - [سبايدر مونكي](https://ar.wikipedia.org/wiki/سبايدر_مونكي_(محرك_جافا_سكريبت)) -- في فايرفوكس.
 - ...هناك أسماء رمزية أخرى مثل  "تريدانت" و "تشاكرا" لاصدارات مختلفه من انترنت اكسبلورر، "تشاكرا كور" لمايكروسوفت إيدج،  "نيترو" و "سكيرلفيش" لسفاري، إلخ. 
 
+<<<<<<< HEAD
 من الجيد تذكر المصطلحات الواردة أعلاه لأنها مستخدمة في مقالات المطورين على الإنترنت. سنستخدمهم أيضًا. على سبيل المثال ، إذا كانت "الميزة إكس مدعومة بواسطة في8" ، فمن المحتمل أنها تعمل في كروم و أوبرا.
+=======
+- [V8](https://en.wikipedia.org/wiki/V8_(JavaScript_engine)) -- in Chrome and Opera.
+- [SpiderMonkey](https://en.wikipedia.org/wiki/SpiderMonkey) -- in Firefox.
+- ...There are other codenames like "Chakra" for IE, "ChakraCore" for Microsoft Edge, "Nitro" and "SquirrelFish" for Safari, etc.
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
 
 ```smart header="كيف تعمل المحركات؟"
 
@@ -110,15 +120,30 @@
 
 أمثلة على هذه اللغات:
 
+<<<<<<< HEAD
 - [كوفي سكريبت](http://coffeescript.org/) هو "سكر نحوي" لجافا سكريبت. إنه يقدم بناء جمل أقصر ، مما يسمح لنا بكتابة كود أكثر وضوحًا ودقة. عادة ،مطورو الروبي يحبونها.
 - يركز [تايب سكريبت](http://www.typescriptlang.org/) على إضافة "كتابة بيانات صارمة" لتبسيط تطوير ودعم الأنظمة المعقدة. تم تطويره بواسطة ميكروسوفت.
 - يضيف [فلاو](http://flow.org/) أيضًا كتابة البيانات ، ولكن بطريقة مختلفة. تم تطويره بواسطة فايسبوك.
 - [دارت](https://www.dartlang.org/) هي لغة قائمة بذاتها لها محركها الخاص الذي يعمل في بيئات غير المتصفح (مثل تطبيقات الهاتف المحمول) ، ولكن يمكن أيضًا تحويلها إلى جافاسكريبت. من تطوير جوجل.
+=======
+- [CoffeeScript](http://coffeescript.org/) is a "syntactic sugar" for JavaScript. It introduces shorter syntax, allowing us to write clearer and more precise code. Usually, Ruby devs like it.
+- [TypeScript](http://www.typescriptlang.org/) is concentrated on adding "strict data typing" to simplify the development and support of complex systems. It is developed by Microsoft.
+- [Flow](http://flow.org/) also adds data typing, but in a different way. Developed by Facebook.
+- [Dart](https://www.dartlang.org/) is a standalone language that has its own engine that runs in non-browser environments (like mobile apps), but also can be transpiled to JavaScript. Developed by Google.
+- [Brython](https://brython.info/) is a Python transpiler to JavaScript that enables the writing of applications in pure Python without JavaScript.
+- [Kotlin](https://kotlinlang.org/docs/reference/js-overview.html) is a modern, concise and safe programming language that can target the browser or Node.
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
 
 هناك أكثر. بالطبع ، حتى لو استخدمنا إحدى اللغات المترجمة ، يجب أن نعرف أيضًا جافاسكريبت لفهم ما نقوم به حقًا.
 
 ## ملخص
 
+<<<<<<< HEAD
 - تم إنشاء الجافاسكريبت في البداية كلغة للمتصفح فقط ، ولكنها تُستخدم الآن في العديد من البيئات الأخرى أيضًا.
 - تتمتع جافاسكريبت اليوم بمكانة فريدة باعتبارها لغة المتصفح الأكثر استخدامًا مع تكاملها التام مع HTML / CSS.
 - هناك العديد من اللغات التي يتم "تحويلها" إلى الجافاسكريبت وتوفر ميزات معينة. يوصى بإلقاء نظرة عليهم ، على الأقل لفترة وجيزة ، بعد إتقان الجافاسكريبت.
+=======
+- JavaScript was initially created as a browser-only language, but it is now used in many other environments as well.
+- Today, JavaScript has a unique position as the most widely-adopted browser language with full integration in HTML/CSS.
+- There are many languages that get "transpiled" to JavaScript and provide certain features. It is recommended to take a look at them, at least briefly, after mastering JavaScript.
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
diff --git a/1-js/01-getting-started/2-manuals-specifications/article.md b/1-js/01-getting-started/2-manuals-specifications/article.md
@@ -14,21 +14,33 @@
 
 أيضاً، إذا كنت تطور من أجل المتصفح، إذا هناك مواصفات أخرى مشمولة في [الجزء الثاني](info:browser-environment) من الدورة التعليمية.
 
+<<<<<<< HEAD
 ## المراجع
+=======
+Also, if you're in developing for the browser, then there are other specifications covered in the [second part](info:browser-environment) of the tutorial.
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
 
 - **MDN (Mozilla) JavaScript Reference** هذا دليل بأمثلة ومعلومات أخرى. وهو مصدر جيد للحصول على معلومات تفصيلية حول ميزات اللغة، وطرق الكائنات المضمنة، وما إلى ذلك.
 
+<<<<<<< HEAD
 يمكن أن تجدها في <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
+=======
+- **MDN (Mozilla) JavaScript Reference** is the main manual with examples and other information. It's great to get in-depth information about individual language functions, methods etc.
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
 
 أيضاً، غالباً ما يكون من الأفضل استخدام البحث عبر الإنترنت بدلاً من ذلك. فقط استخدم "[مصطلح] MDN" للإستعلام، مثال <https://google.com/search?q=MDN+parseInt> لتبحث عن دالة `parseInt`.
 
+<<<<<<< HEAD
 * **MSDN** – مراجع ميكروسوفت يوجد بها معلومات كثيرة، متضمنة جافاسكريبت (غالباً يشار إليها JScript). إذا كنت تريد شيئا أكثر تخصصا عن انترنت اكسبلورر، من الأفضل الذهاب إلى: <http://msdn.microsoft.com/>.
 
 أيضاً، يمكن غن نستخدم بحث الإنترنت بعبارات مثل "RegExp MSDN" or "RegExp MSDN jscript".
 
 ## جدول التوافق
 
 جافاسكريبت لغة فى سياق متطور، تضاف إليها خصائص جديدة بانتظام.
+=======
+Although, it's often best to use an internet search instead. Just use "MDN [term]" in the query, e.g. <https://google.com/search?q=MDN+parseInt> to search for `parseInt` function.
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
 
 لتَّـحَقّـق من الدعم ما بين المتصفحات والمحركات الأخرى، انظر:
 

diff --git a/1-js/01-getting-started/4-devtools/article.md b/1-js/01-getting-started/4-devtools/article.md
@@ -11,9 +11,13 @@
 
 اضغط على F12 (أو الاختصار Cmd+Opt+J إذا كنت تستخدم نظام التشغيل «ماك») وسيفتح ذلك تلقائيًا أدوات المطوّر على لسان «الطرفية» (Console). وتظهر أدوات المطوّر تقريبًا بهذا الشكل: 
 
+<<<<<<< HEAD
 يعتمد شكل أدوات المطوّر على إصدار متصفِّح Chrome الذي تستخدمه، إذ يختلف بشكل بسيط من إصدار إلى آخر. 
 - بإمكانك رؤية رسالة الخطأ باللون الأحمر. معنى الرسالة أن السكربت يحتوي على أمر غير معروف هو "lalala". 
 - لاحظ في أقصى اليمين وجود رابط إلى المصدر bug.html:12 مع رقم سطر الخطأ في الشيفرة.
+=======
+Developer tools are potent, they have many features. To start, we'll learn how to open them, look at errors, and run JavaScript commands.
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
 
 يظهر تحت رسالة الخطأ الرمز `<` باللون الأزرق، ويحدد «سطر الأوامر» (command line) الذي سنكتب عنده أوامر وتعليمات JavaScript. اضغط زر الإدخال Enter لتنفيذ الأمر بعد كتابته (أو Shift+Enter للانتقال إلى السطر التالي عند إدخال أمر متعدد الأسطر). 
 

diff --git a/1-js/02-first-steps/01-hello-world/article.md b/1-js/02-first-steps/01-hello-world/article.md
@@ -9,7 +9,11 @@
 
 ## الوسم "script"
 
+<<<<<<< HEAD
 يمكن وضع برامج الجافاسكريبت في أي جزء في مستند HTML باستخدام وسم `<script>`.
+=======
+JavaScript programs can be inserted almost anywhere into an HTML document using the `<script>` tag.
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
 
 على سبيل المثال:
 

diff --git a/1-js/02-first-steps/04-variables/2-declare-variables/solution.md b/1-js/02-first-steps/04-variables/2-declare-variables/solution.md
@@ -6,7 +6,11 @@
 let ourPlanetName = "Earth";
 ```
 
+<<<<<<< HEAD
 ملاحظة, نحن نستطيع كتابة أسم قصير مثل `planet`, ولكن قد لا يكون واضحًا ما يشير إليه الكوكب. من الجيد أن تكون أكثر تطولًا. علي الاقل يكون اسم المتغير ليس طويل للغاية.
+=======
+Note, we could use a shorter name `planet`, but it might not be obvious what planet it refers to. It's nice to be more verbose. At least until the variable isNotTooLong.
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
 
 ## أسم الزائر الحالي
 

diff --git a/1-js/02-first-steps/05-types/article.md b/1-js/02-first-steps/05-types/article.md
@@ -67,7 +67,11 @@ n = 12.345;
 
 ## BigInt
 
+<<<<<<< HEAD
 في الجافا سكربت، النوع "رقم"  لا يمثل الأعداد الصحيحة أكبر من <code>(2<sup>53</sup>-1)</code> ( `9007199254740991`)، أو أقل من <code>-(-2<sup>53</sup>-1)</code> للأرقام السالبة. إنها قيود فنية ناتجة عن تمثيلهم الداخلي.
+=======
+In JavaScript, the "number" type cannot represent integer values larger than <code>(2<sup>53</sup>-1)</code> (that's `9007199254740991`), or less than <code>-(2<sup>53</sup>-1)</code> for negatives. It's a technical limitation caused by their internal representation.
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
 
 لمعظم الأغراض هذا يكفي، لكن في بعض الأحيان نحتاج لأرقام كبيرة حقاً ، على سبيل المثال. للتشفير أو الطوابع الزمنية الدقيقة للميكرو ثانية.
 
@@ -82,10 +86,18 @@ const bigInt = 1234567890123456789012345678901234567890n;
 
 بما أن أرقام من نوع `BigInt` نحتاجها نادراً ، لن يتم تغطيتها هنا ، لكن سيفرد لها فصل مخصص  <info:bigint>. اقرأه عندما تحتاج لمثل هذه الأرقام الكبيرة.
 
+<<<<<<< HEAD
 ```smart header="مشاكل توافقية"
 الأن `BigInt` متوافق مع الفايرفوكس والكروم ،لكن ليست متوافقة مع  سفاري/انترنت اكسبلورر/ايدج.
+=======
+
+```smart header="Compatibility issues"
+Right now, `BigInt` is supported in Firefox/Chrome/Edge/Safari, but not in IE.
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
 ```
 
+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.
+
 ## String
 
 النص في الجافا سكربت يتم إحاطته بعلامات تنصيص.
@@ -128,7 +140,11 @@ alert( "the result is ${1 + 2}" ); // the result is ${1 + 2} (علامات ال
 ```smart header="لا يوجد نوع *character* ."
 في بعض اللغات، يوجد نوع خاص "character" يعبر عن الحرف الواحد. For example,على سبيل المثال، في لغة سي وجافا يدعى "char".
 
+<<<<<<< HEAD
 في الجافا سكربت، لا يوجد مثل هذا النوع. يوجد نوع واحد فقط: `string`. النص قد يتكون من حرف واحد أو أكثر.
+=======
+In JavaScript, there is no such type. There's only one type: `string`. A string may consist of zero characters (be empty), one character or many of them.
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
 ```
 
 ## Boolean (logical type)
@@ -256,6 +272,7 @@ typeof alert // "function"  (3)
 
 يوجد 8 أنواع للبيانات في جافا سكربت.
 
+<<<<<<< HEAD
 - `number` للأرقام من أي نوع: صحيح أو عشري، الأعداد الصحيحة محدودة بy ±2<sup>53</sup>.
 - `bigint` هو عدد صحيح طوله كبير.
 - `string` للنصوص. النص قد يحتوي على حرف أو أكثر، لا يوجد نوع منفصل للحرف الواحد.
@@ -264,6 +281,16 @@ typeof alert // "function"  (3)
 - `undefined` للقيم غير المعينة -- نوع قائم بذاته له قيمة واحدة فقط `undefined`.
 - `object` من أجل هياكل بيانات معقدة.
 - `symbol` من أجل معرفات فريدة.
+=======
+- `number` for numbers of any kind: integer or floating-point, integers are limited by <code>±(2<sup>53</sup>-1)</code>.
+- `bigint` is for integer numbers of arbitrary length.
+- `string` for strings. A string may have zero or more characters, there's no separate single-character type.
+- `boolean` for `true`/`false`.
+- `null` for unknown values -- a standalone type that has a single value `null`.
+- `undefined` for unassigned values -- a standalone type that has a single value `undefined`.
+- `object` for more complex data structures.
+- `symbol` for unique identifiers.
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
 
 معامل `typeof` يسمح لنا بمعرفة نوع البيانات الموجودة بداخل المتغيرة.
 

diff --git a/1-js/02-first-steps/06-alert-prompt-confirm/article.md b/1-js/02-first-steps/06-alert-prompt-confirm/article.md
@@ -4,7 +4,11 @@
 
 ## alert
 
+<<<<<<< HEAD
 هذه رأيناها بالفعل. إنها تظهر رسالة وتنتظر من المستخدم أن يضغط على "OK".
+=======
+This one we've seen already. It shows a message and waits for the user to press "OK".
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
 
 على سبيل المثال:
 
@@ -31,7 +35,11 @@ result = prompt(title, [default]);
 : معامل ثاني إختياري، القيمة الأولية لحقل الإدخال.
 
 ```smart header="The square brackets in syntax `[...]`"
+<<<<<<< HEAD
 الأقواس المربعة حول `default` في الكود أعلاه يوضح أن المعامل إختياري، ليس مطلوب.
+=======
+The square brackets around `default` in the syntax above denote that the parameter is optional, not required.
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
 ```
 
 الزائر يستطيع كتابة أي شئ في حقل الإدخال ويضغط أوك. ثم نحصل على النص في `النتيجة`. أو يستطيع إلغاء الإدخال بالضغط على إلغاء  أو الضغط على زرار `key:Esc` ، عندها سنحصل على  `null` ك`result`.

diff --git a/1-js/02-first-steps/08-operators/4-fix-prompt/solution.md b/1-js/02-first-steps/08-operators/4-fix-prompt/solution.md
@@ -8,7 +8,11 @@ let b = "2"; // prompt("Second number?", 2);
 alert(a + b); // 12
 ```
 
+<<<<<<< HEAD
 ما يجب علينا فعله هو تحويل السلاسل إلى أرقام قبل `+`. على سبيل المثال ، استخدام `Number ()` أو إلحاقها بـ `+`.
+=======
+What we should do is to convert strings to numbers before `+`. For example, using `Number()` or prepending them with `+`.
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
 
 على سبيل المثال ، قبل "prompt" مباشرةً:
 

diff --git a/1-js/02-first-steps/08-operators/article.md b/1-js/02-first-steps/08-operators/article.md
@@ -105,7 +105,16 @@ alert( 2 + '1' ); // "21"
 alert(2 + 2 + '1' ); // "41" and not "221"
 ```
 
+<<<<<<< HEAD
 هنا العوامل الحسابية تعمل بعد الأخرى.  عامل الإضافة الأول "+" يقوم بجمع الرقمين فيصبح ناتجهمها  "4" ثم يقوم عامل الإضافة الثاني "+" بدمج "4" و "1" في كلمة واحدة فتصبح الناتج النهائي مثل  `4 + '1' = 41`.
+=======
+Here, operators work one after another. The first `+` sums two numbers, so it returns `4`, then the next `+` adds the string `1` to it, so it's like `4 + '1' = '41'`.
+
+```js run
+alert('1' + 2 + 2); // "122" and not "14"
+```
+Here, the first operand is a string, the compiler treats the other two operands as strings too. The `2` gets concatenated to `'1'`, so it's like `'1' + 2 = "12"` and `"12" + 2 = "122"`.
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
 
 عامل الإضافة الثنائي "+" هو العامل الوحيد الذي يدعم الكلمات بهذه الطريقة 
 العوامل الحسابية الأخرى تعمل فقط مع الأرقام ودائما ما تحول المعاملات إلى أرقام 
@@ -188,7 +197,11 @@ alert( +apples + +oranges ); // 5
 هناك العديد من العوامل في JavaScript. لكل عامل رقم أسبقية مطابق. يتم تنفيذ واحد مع العدد الأكبر أولاً. إذا كانت الأسبقية هي نفسها ، فسيكون أمر التنفيذ من اليسار إلى اليمين.
 
 
+<<<<<<< HEAD
 إليك مقتطف من [جدول الأسبقية] (https://developer.mozilla.org/en/JavaScript/Reference/operators/operator_precedence) (لست بحاجة إلى تذكر ذلك ، ولكن لاحظ أن عوامل التشغيل الأحادية أعلى من الخيارات الثنائية المقابلة) منها):
+=======
+Here's an extract from the [precedence table](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Operator_Precedence) (you don't need to remember this, but note that unary operators are higher than corresponding binary ones):
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
 
 | الأسبقية | الاسم | تسجيل |
 | ------------ | ------ | ------ |
@@ -224,7 +237,11 @@ alert( x ); // 5
 
 ترجع معظم عوامل التشغيل في JavaScript قيمة. هذا واضح لـ `+` و` -` ، ولكنه ينطبق أيضًا على `=`.
 
+<<<<<<< HEAD
 تؤدي المكالمة `x = value` إلى كتابة` value` في `x` * ثم إرجاعها *.
+=======
+All operators in JavaScript return a value. That's obvious for `+` and `-`, but also true for `=`.
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
 
 في ما يلي عرض توضيحي يستخدم مهمة كجزء من تعبير أكثر تعقيدًا:
 
@@ -437,7 +454,13 @@ counter++;
 - RIGHT SHIFT ( `>>` )
 - ZERO-FILL RIGHT SHIFT ( `>>>` )
 
+<<<<<<< HEAD
 نادرًا ما يتم استخدام عوامل التشغيل هذه ، عندما نحتاج إلى التلاعب بالأرقام على أدنى مستوى (أحادي البتات). لن نحتاج إلى هؤلاء المشغلين في أي وقت قريب ، لأن تطوير الويب لا يستخدمهم كثيرًا ، ولكن في بعض المجالات الخاصة ، مثل التشفير ، فهي مفيدة. يمكنك قراءة مقالة [عوامل تشغيل Bitwise] (https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Operators/Bitwise_Operators) مقالة حول MDN عند الحاجة. 
+=======
+These operators are used very rarely, when we need to fiddle with numbers on the very lowest (bitwise) level. We won't need these operators any time soon, as web development has little use of them, but in some special areas, such as cryptography, they are useful. You can read the [Bitwise Operators](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Expressions_and_Operators#Bitwise) chapter on MDN when a need arises.
+
+## Comma
+>>>>>>> 97ef86242f9f236b13152e1baf52a55c4db8728a
 
 ## الفاصلة