Object Location

اجزای Location Window

Object Location شامل اطلاعات مربوط به URL فعلی است.

Object Location یک ویژگی از Object Window است.

Object 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 را تغییر داد، تنها کافی است به سایر ویژگی‌های Object Location دیگر ارزش بدهیم. این کار باعث ایجاد URL جدیدی می‌شود که بخشی از آن با URL قبلی متفاوت است، مرورگر آن را بارگذاری و نمایش خواهد داد. به عنوان مثال، فرض کنید شما به Object Location، ویژگی hash،پس مرورگر به مکان مشخصی در سند فعلی منتقل خواهد شد. همچنین، اگر تنظیم شد ویژگی search، در این صورت مرورگر URL با جستجوی جدیدی بارگذاری خواهد شد.

به جز ویژگی URL، Location Object شامل مетод reload()می‌توان مستند فعلی را دوباره بارگذاری کرد،replace() می‌توان یک مستند جدید را بدون ایجاد یک تاریخچه جدید بارگذاری کرد، یعنی مستند جدید در لیست تاریخچه مرورگر جایگزین مستند فعلی خواهد شد.