Location object
الدرس 66 من 818:05كورس مجاني

محتوى الدرس
| الخاصية / الدالة | الوظيفة |
|---|---|
| location.href | قراءة أو تغيير رابط الصفحة الكامل (URL). |
| location.protocol | نوع البروتوكول المستخدم (مثل http: أو https:). |
| location.host / location.hostname | اسم النطاق/الدومين (Domain Name). |
| location.pathname | مسار الصفحة أو المجلد بعد الدومين. |
| location.port | رقم المنفذ (Port) إن وجد. |
| location.assign() | فتح رابط جديد مع الاحتفاظ بالصفحة الحالية في السجل (Back possible). |
| location.replace() | استبدال الصفحة الحالية برابط جديد (بدون التمكن من العودة للخلف). |
1. الرابط الكامل: location.href
تُرجِع هذه الخاصية رابط الصفحة الحالي بالكامل، كما تُستخدم أيضاً لتحويل المستخدم لرابط آخر عند تغيير قيمتها:
JavaScript
// قراءة الرابط الحالي
console.log(location.href);
// التحويل لصفحة جديدة
location.href = "https://www.google.com";2. بروتوكول الاتصال: location.protocol
تُرجِع نوع البروتوكول الذي تعمل به الصفحة، ويمكن تعديلها لتحويل الموقع مثلاً من http: إلى https::
JavaScript
console.log(location.protocol); // النتيجة غالباً: "https:" أو "http:"3. اسم النطاق: location.host & location.hostname
تعرض هذه الخصائص اسم الدومين المستضيف للموقع:
JavaScript
console.log(location.hostname); // النتيجة: "www.w3schools.com"
// تغيير اسم الدومين سيقوم بإعادة توجيه المتصفح للدومين الجديد
location.hostname = "www.facebook.com";ملاحظة: الفرق البسيط أن host يتضمن رقم المنفذ (Port) إن وجد، بينما hostname يُرجع اسم الدومين فقط.
4. مسار الصفحة: location.pathname
تُرجِع المسار الداخلي بعد اسم الدومين (Path):
JavaScript
console.log(location.pathname); // النتيجة مثلاً: "/js/js_window_location.asp"
// يمكن تعديل المسار للانتقال لصفحة أسبوعية/مختلفة داخل نفس الموقع
location.pathname = "test";5. رقم المنفذ: location.port
تُرجِع رقم المنفذ (Port) المفتوح عليه الموقع. إذا كان الموقع يعمل على المنافذ الافتراضية (80 لـ HTTP أو 443 لـ HTTPS) ستكون النتيجة فارغة "":
JavaScript
console.log(location.port); // يُرجع "" أو رقم البورت مثل "3000" أو "8080"6. دوال التوجيه والتحويل: assign() vs replace()
location.assign("URL"): تقوم بفتح صفحة جديدة، وتُسجّل الصفحة القديمة في الـ History، بحيث يمكن للمستخدم الضغط على زر العودة للخلف (Back).
location.replace("URL"): تقوم باستبدال الصفحة الحالية بالصفحة الجديدة وحذف القديمة من الـ History (لن يستطيع المستخدم الضغط على زر Back للعودة).
JavaScript
// توجيه مع إمكانية الرجوع
location.assign("https://google.com");
// توجيه بدون إمكانية الرجوع (مفيد بعد تسجيل الخروج مثلاً)
location.replace("https://google.com");