Document.location

تُعيد الخاصيّة Document.location القابلة للقِراءة فقط كائنًا من النّوع Location، والذي يحتوي على معلومات حول عنوان URL الخاصّ بالمُستند ويُتيح توابع لتعديل عنوان URL هذا وتحميل عنوان URL آخر.

ورغم أنّ الخاصيّة Document.location للقِراءة فقط، إلا أنّك تستطيع تعيين سلسلة نصيّة من النّوع DOMString لها كذلك. ما يعني بأنّك تستطيع التّعامل مع هذه الخاصيّة بصفتها سلسلة نصيّة عاديّة في مُعظم الحالات. والسّطران التّاليّان مُتكافئان:

document.location = 'http://www.example.com'
document.location.href = 'http://www.example.com'

للحصول على عنوان URL المُستندِ وحده، يُمكنك استعمال الخاصيّة document.URL كذلك.

إن لم يكن المُستند الحاليّ في سياق تصفّح، فالقيمة المُعادة ستكون null.

البنية العامة

locationObj = document.location
document.location = 'http://www.hsoub.com'

// هذا مُكافئ لما يلي

// document.location.href = 'http://www.hsoub.com'

مثال

dump(document.location); 
// يطبع السّطر أعلاه سلسلة نصيّة مُشابهة لما يلي
// "https://wiki.hsoub.com/JavaScript"

دعم المتصفحات

الميزة	Chrome	Edge	Firefox	Opera	Safari
الدعم الأساسي	نعم	نعم	نعم	نعم	نعم

انظر أيضا

• واجهةُ القيمة المُعادة: Location.
• خاصيّة مُشابهة، لكنّها مُرتبطة بسياقِ تصفّح: Window.location.

مصادر ومواصفات

• مواصفة HTML Living Standard
• مواصفة HTML5