موضوع Location Window

موضوع Location Window

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

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

Object Location قابل دسترسی به روش‌های زیر است:

window.location یا فقط location

مثال

let origin = window.location.origin;

آزمایش کنید خودتان

let origin = location.origin;

آزمایش کنید خودتان

ویژگی‌های شیء Location

ویژگی توضیح
hash بخش اتصال URL (#) را تنظیم یا بازگرداند.
host نام دامنه و پورت URL را تنظیم یا بازگرداند.
hostname نام دامنه URL را تنظیم یا بازگرداند.
href تمام URL را تنظیم یا بازگرداند.
origin پروتکل، نام دامنه و پورت URL را بازگرداند.
pathname بخش نام مسیر URL را تنظیم یا بازگرداند.
port بخش پورت URL را تنظیم یا بازگرداند.
protocol بخش پروتکل URL را تنظیم یا بازگرداند.
search بخش کوئری URL را تنظیم یا بازگرداند.

روش‌های شیء Location

روش توضیح
assign() مستند جدید را بارگذاری کند.
reload() مستند فعلی را دوباره بارگذاری کند.
replace() مستند فعلی را با مستند جدید جایگزین کند.

توضیح شیء Location

شیء Location در ویژگی Location شیء Window ذخیره می‌شود و نشان‌دهنده آدرس وب مستندی است که در حال حاضر در آن پنجره نمایش داده می‌شود. ویژگی‌های آن ویژگی hrefمحتوای URL کامل مستند را ذخیره می‌کند، و ویژگی‌های دیگر هر بخش از URL را توصیف می‌کنند. این ویژگی‌ها بسیار مشابه ویژگی‌های URL شیء Anchor (یا Area) هستند. وقتی یک شیء Location به یک رشته تبدیل شود، ارزش ویژگی href بازمی‌گردد. این به این معناست که می‌توانید از عبارت location به جای location.href استفاده کنید.

اما شیء Anchor نشان‌دهنده لینک‌های مستند است، در حالی که شیء Location نشان‌دهنده URL (یا مکان) مستندی است که در حال حاضر در مرورگر نمایش داده می‌شود. اما عملکرد شیء Location بسیار بیشتر از این است، زیرا می‌تواند مکان مستندی که در حال نمایش است را کنترل کند. اگر یک رشته حاوی URL به شیء Location یا ویژگی href آن اختصاص داده شود، مرورگر مستندی که URL جدید اشاره دارد را بارگذاری و نمایش خواهد داد.

به جای جایگزینی location یا location.href با URL کامل، می‌توان بخشی از URL را تغییر داد، تنها کافی است به سایر ویژگی‌های شیء Location ارزش بدهیم. این کار یک URL جدید ایجاد می‌کند که بخشی از آن با URL قبلی متفاوت است، مرورگر آن را بارگذاری و نمایش خواهد داد. به عنوان مثال، فرض کنید شما به ویژگی href شیء Location对象的 ویژگی hash، پس مرورگر به یک مکان مشخص در مستند فعلی منتقل خواهد شد. همچنین، اگر تنظیم شده باشد ویژگی search، پس مرورگر URL را دوباره بارگذاری خواهد کرد که شامل کوئری جدید است.

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