Translating global Object to Ar

Author: Adham-Niazy

1-js/06-advanced-functions/05-global-object/article.md

@@ -1,87 +1,94 @@
 
-# Global object
+# الكائن العمومي Global object
 
-The global object provides variables and functions that are available anywhere. By default, those that are built into the language or the environment.
+تقدّم الكائنات العمومية متغيراتَ ودوال يمكن استعمالها من أي مكان. هذه الكائنات مضمّنة في بنية اللغة أو البيئة مبدئيًا.
 
-In a browser it is named `window`, for Node.js it is `global`, for other environments it may have another name.
+في المتصفّحات تُدعى بالنافذة `‎window‎` وفي Node.js تُدعى بالعموميات `‎global‎` وفي باقي البيئات تُدعى بأيّ اسم مناسب يراه مطوّروها.
 
-Recently, `globalThis` was added to the language, as a standardized name for a global object, that should be supported across all environments. In some browsers, namely non-Chromium Edge, `globalThis` is not yet supported, but can be easily polyfilled.
+أُضيف حديثًا الكائن `‎globalThis‎` إلى اللغة ليكون اسم قياسيًا للكائن العمومي على أن تدعمه كلّ البيئات. ولكن بعض المتصفّحات (وبالخصوص عدا Chromium Edge) لا تدعم هذا الكائن بعد، ولكن يمكنك «ترقيعه تعدّديًا» بسهولة تامة.
 
-We'll use `window` here, assuming that our environment is a browser. If your script may run in other environments, it's better to use `globalThis` instead.
+سنستعمل هنا `‎window‎` على فرضية بأنّ البيئة هي المتصفّح نفسه. لو كنت ستشغّل السكربت الذي تكتبه في بيئات أخرى فربما تستعمل `‎globalThis‎` بدل النافذة تلك.
 
-All properties of the global object can be accessed directly:
+يمكننا طبعًا الوصول إلى كافة خصائص الكائن العمومي مباشرةً:
 
 ```js run
 alert("Hello");
-// is the same as
+// تتطابق تمامًا مع
 window.alert("Hello");
+
 ```
 
-In a browser, global functions and variables declared with `var` (not `let/const`!) become the property of the global object:
+يمكنك في المتصفّحات التصريح عن الدوال العمومية والمتغيرات باستعمال `‎var‎` (وليس `‎let/const‎` !) لتصير خاصيات للكائن العمومي:
 
 ```js run untrusted refresh
 var gVar = 5;
 
-alert(window.gVar); // 5 (became a property of the global object)
+alert(window.gVar); // ‫5 (تصير خاصية من خاصيات الكائن العمومي)
+
 ```
 
-Please don't rely on that! This behavior exists for compatibility reasons. Modern scripts use [JavaScript modules](info:modules) where such thing doesn't happen.
+ولكن أرجوك ألا تعتمد على هذا الأمر! هذا السلوك موجود للتوافقية لا غير. تستعمل السكربتات الحديثة [وحداتَ جافاسكربت](info:modules) حيث لا يحدث هكذا أمر.
 
-If we used `let` instead, such thing wouldn't happen:
+لن يحدث هذا لو استعملنا `‎let‎` هنا:
 
 ```js run untrusted refresh
 let gLet = 5;
 
-alert(window.gLet); // undefined (doesn't become a property of the global object)
+alert(window.gLet); // ‫غير معرّف (لا تصير خاصية للكائن العمومي)
+
 ```
 
-If a value is so important that you'd like to make it available globally, write it directly as a property:
+لو كانت القيمة هامّة جدًا جدًا وأردت أن تدخل عليها من أيّ مكان عمومي فاكتبها على أنّها خاصية مباشرةً:
 
 ```js run
-*!*
-// make current user information global, to let all scripts access it
+// نجعل من معلومات المستخدم الحالي عمومية لتصل إليها كلّ السكربتات
 window.currentUser = {
   name: "John"
 };
-*/!*
 
-// somewhere else in code
+// وفي مكان آخر يريدها أحد
 alert(currentUser.name);  // John
 
-// or, if we have a local variable with the name "currentUser"
-// get it from window explicitly (safe!)
+// ‫أو (لو كان هناك المتغير المحلي ذا الاسم «currentUser»
+// فنأخذها جهارةً من النافذة (وهذا آمن!)
 alert(window.currentUser.name); // John
+
 ```
 
-That said, using global variables is generally discouraged. There should be as few global variables as possible. The code design where a function gets "input" variables and produces certain "outcome" is clearer, less prone to errors and easier to test than if it uses outer or global variables.
+نختم هنا بأنّ استعمال المتغيرات العمومية غير محبّذ بالمرة ويجب أن يكون عددها بأقل ما يمكن. يُعدّ مبدأ تصميم الشيفرات حين تأخذ الدالة المتغيرات «الداخلة» وتُعطينا «نواتج» معيّنة - يُعدّ هذا المبدأ أفضل وأقلّ عُرضة للأخطاء وأسهل للاختبار موازنةً بالمتغيرات الخارجية أو العمومية.
 
-## Using for polyfills
 
-We use the global object to test for support of modern language features.
+## استعمالها للترقيع تعدديًا
+
+المجال الذي نستعمل الكائنات العمومية فيه هو اختبار لو كانت البيئة تدعم مزايا اللغة الحديثة.
+
+فمثلًا يمكننا اختبار لو كانت كائنات الوعود `‎Promise‎` المضمّنة في اللغة مضمّنة حقًا (لم تكن كذلك في المتصفحات العتيقة):
 
-For instance, test if a built-in `Promise` object exists (it doesn't in really old browsers):
 ```js run
 if (!window.Promise) {
-  alert("Your browser is really old!");
+  alert("Your browser is really old!"); // ‫تستعمل متصفّحا قديماً!
 }
 ```
 
-If there's none (say, we're in an old browser), we can create "polyfills": add functions that are not supported by the environment, but exist in the modern standard.
+لو لم نجد هذه الكائنات (مثلًا نستعمل متصفّحًا قديمًا) فيمكننا «ترقيعه تعدّديًا»: أي إضافة الدوال التي لا تدعمها البيئة بينما هي موجودة في معيار اللغة الحديث.
 
 ```js run
 if (!window.Promise) {
-  window.Promise = ... // custom implementation of the modern language feature
+  window.Promise = ... // شيفرة نكتبها بنفسنا تؤدّي الميزة الحديثة في اللغة هذه
 }
+
 ```
 
-## Summary
+## ملخص
 
 - The global object holds variables that should be available everywhere.
 
-    That includes JavaScript built-ins, such as `Array` and environment-specific values, such as `window.innerHeight` -- the window height in the browser.
-- The global object has a universal name `globalThis`.
+       تشمل المتغيرات هذه كل ما هو مضمّن في بنية لغة جافاسكربت مثل
+        المصفوفات `‎Array‎` والقيم المخصّصة للبيئة مثل `‎window.innerHeight‎` (ارتفاع نافذة المتصفّح).
+- للكائن العمومي اسم عام في المواصفة: `‎globalThis‎`.
 
-    ...But more often is referred by "old-school" environment-specific names, such as `window` (browser) and `global` (Node.js). As `globalThis` is a recent proposal, it's not supported in non-Chromium Edge (but can be polyfilled).
-- We should store values in the global object only if they're truly global for our project. And keep their number at minimum.
-- In-browser, unless we're using [modules](info:modules), global functions and variables declared with `var` become a property of the global object.
-- To make our code future-proof and easier to understand, we should access properties of the global object directly, as `window.x`.
+        ولكن... دومًا ما نُشير إليه بالأسماء «الأثرية» حسب كل بيئة مثل `‎window‎` (في المتصفحات) و`‎global‎` (في Node.js)
+        ، إذ أنّ `‎globalThis‎` هو مُقترح جديد على اللغة وليس مدعومًا في المتصفّحات عدة Chromium Edge (ولكن يمكننا ترقيعه تعدّديًا).
+- علينا ألا نخزّن القيم في الكائن العمومي إلّا لو كانت حقًا وفعلًا عمومية للمشروع الذي نعمل عليه. كما ويجب أن يبقى عددها بأقل ما يمكن.
+- حين نطوّر لاستعمال الشيفرات في المتصفّحات (لو لم نستعمل الوحدات، [وحدات](info:modules))، تصير الدوال العمومية والمتغيرات باستعمال `‎var‎` خاصيات للكائن العمومي.
+- علينا استعمال خاصيات الكائن العمومي مباشرةً (مثل `‎window.x‎`) لتكون الشيفرة سهلة الصيانة مستقبلًا وأسهل فهمًا.