عناصر Location

مفهوم Window Location

يحتوي عناصر Location على معلومات حول URL الحالية.

عنصر Location هو خاصية من عنصر النافذة.

يتم الوصول إلى عناصر Location بطرق التالي:

window.location أو فقط location

المثال

let origin = window.location.origin;

جربها بنفسك

let origin = location.origin;

جربها بنفسك

خصائص Object Location

خصائص وصف
hash تعيين أو العودة إلى جزء العلامة في URL (#).
host تعيين أو العودة إلى اسم المضيف ورقم المنفذ في URL.
hostname تعيين أو العودة إلى اسم المضيف في URL.
href تعيين أو العودة إلى URL الكامل.
origin العودة إلى بروتوكول URL،اسم المضيف ورقم المنفذ.
pathname تعيين أو العودة إلى مسمى المسار في URL.
port تعيين أو العودة إلى رقم المنفذ في URL.
protocol تعيين أو العودة إلى بروتوكول URL.
search تعيين أو العودة إلى جزء سلسلة الاستعلام في URL.

طريقة Object Location

الطريقة وصف
assign() تحميل وثيقة جديدة.
reload() إعادة تحميل الوثيقة الحالية.
الطريقة replace() استبدال الوثيقة الحالية بوثيقة جديدة.

وصف Object Location

يخزن Object Location في خاصية Location لـ Object Window،ويعكس عنوان الويب للوثيقة التي يتم عرضها حاليًا في ذلك النافذة.ويمكنه خصائص hrefتخزن URL الكاملة للوثيقة،ويصف باقي خصائص URL جزءًا بعد جزء.هذه الخصائص تشبه كثيرًا خصائص URL لـ Object Anchor (أو Object Area).عند تحويل Object Location إلى سلسلة،يتم العودة إلى قيمة خاصية href.وهذا يعني أنه يمكنك استخدام تعبير location بدلاً من location.href.

لكن Object Anchor يمثل رابطًا في الوثيقة،بينما Object Location يمثل URL (أو الموقع) للوثيقة التي يتم عرضها حاليًا في المتصفح.لكن Object Location يمكن أن يفعل أكثر من ذلك بكثير،فهو يمكنه أيضًا التحكم في موقع الوثيقة التي يتم عرضها في المتصفح.إذا تم تخصيص سلسلة تحتوي على URL لـ Object Location أو خاصيته href،سيقوم المتصفح بتحميل الوثيقة المحددة من قبل URL الجديد وعرضها.

إضافة إلى تعيين location أو location.href باستخدام URL كامل لتبديل URL الحالية،يمكن أيضًا تعديل جزء من URL،فقط بحاجة إلى تعيين باقي خصائص Object Location.بهذا الشكل سيتم إنشاء URL جديد يحتوي على جزء مختلف عن URL الأصلي،سيقوم المتصفح بتحميله وعرضه.على سبيل المثال،إذا تم تعيين خصائص hash،إذاً،سيقوم المتصفح بالانتقال إلى موقع معين مخصص في الوثيقة الحالية. وبالمثل،إذا تم تعيين خاصية searchفسيقوم المتصفح بإعادة تحميل URL المضاف إليها سلسلة الاستعلام الجديدة.

باستثناء خاصية URL، طريقة reload()يمكن إعادة تحميل الوثيقة الحالية،الطريقة replace() يمكن تحميل وثيقة جديدة دون الحاجة إلى إنشاء سجل تاريخي جديد لها، مما يعني أن الوثيقة الجديدة ستستبدل الوثيقة الحالية في قائمة التاريخ الخاصة بالbrowser.