مجموعه‌ی Location
مجموعه‌ی Location
Object Location شامل اطلاعات مربوط به URL فعلی است.
Object Location بخشی از Object Window است و از طریق ویژگی window.location قابل دسترسی است.
مثال
ویژگی‌های Object Location
| ویژگی | توضیح |
|---|---|
| hash | URL از آغاز علامت عدد (#) تنظیم یا بازگردانده می‌شود (anchor). |
| host | نام میزبان و پورت URL فعلی را تنظیم یا بازگردانده می‌شود. |
| hostname | نام میزبان URL فعلی را تنظیم یا بازگردانده می‌شود. |
| href | URL کامل را تنظیم یا بازگردانده می‌شود. |
| pathname | مسیر URL فعلی را تنظیم یا بازگردانده می‌شود. |
| port | پورت URL فعلی را تنظیم یا بازگردانده می‌شود. |
| protocol | URL فعلی را تنظیم یا بازگردانده می‌شود (پrotocol). |
| search | URL از آغاز علامت سوال (?) تنظیم یا بازگردانده می‌شود (بخش جستجو). |
روش‌های Object Location
| ویژگی | توضیح |
|---|---|
| assign() | یک مستند جدید بارگذاری کنید. |
| reload() | مستند فعلی را دوباره بارگذاری کنید. |
| روش replace() | مستند فعلی را با یک مستند جدید جایگزین کنید. |
توضیح Object Location
Object Location در ویژگی Location Object Window ذخیره می‌شود، و نشان‌دهنده آدرس وب مستند نمایش داده شده در آن پنجره است. آن‌ها ویژگی hrefمستند کامل URL ذخیره می‌شود، و ویژگی‌های دیگر به بخش‌های مختلف URL اشاره دارند. این ویژگی‌ها بسیار مشابه ویژگی URL Object (یا Object Area) هستند. وقتی یک Object Location به یک رشته تبدیل می‌شود، مقدار href برمی‌گردد. این به این معناست که می‌توانید از عبارت location به جای location.href استفاده کنید.
اما Object Anchor نشان‌دهنده لینک‌های مستند است، Object Location نشان‌دهنده URL (یا مکان) مستندی است که در حال نمایش در مرورگر است. اما Object Location می‌تواند موارد بیشتری انجام دهد و می‌تواند مکان مستندی که در حال نمایش است را کنترل کند. اگر یک رشته حاوی URL به Object Location یا ویژگی href آن اختصاص داده شود، مرورگر مستندی که URL جدید اشاره دارد را بارگذاری و نمایش خواهد داد.
به جز جایگزینی URL فعلی با URL کامل از طریق location یا location.href، می‌توان بخشی از URL را نیز تغییر داد، تنها کافی است به سایر ویژگی‌های Location object ارزش بدهیم. این کار یک URL جدید ایجاد خواهد کرد که بخشی از آن با URL قبلی متفاوت است و مرورگر آن را بارگذاری و نمایش خواهد داد. به عنوان مثال، اگر به فرض ویژگی hash تنظیم شود، سپس مرورگر به یک مکان مشخص در مستند فعلی منتقل خواهد شد. همچنین، اگر ویژگی search، سپس مرورگر URL جدیدی که شامل یک جستجوی جدید است را بارگذاری خواهد کرد.
به جز ویژگی URL، ویژگی‌های Location روش reload()می‌توان مستند فعلی را دوباره بارگذاری کرد،روش replace() می‌توان یک مستند جدید را بارگذاری کرد بدون اینکه نیاز باشد یک تاریخچه جدید برای آن ایجاد شود، یعنی مستند جدید در لیست تاریخچه مرورگر، مستند فعلی را جایگزین خواهد کرد.
