کلاس google.script.url (API سمت مشتری)

google.script.url یک API جاوا اسکریپت سمت کلاینت ناهمزمان است که می تواند URL ها را برای به دست آوردن پارامترها و قطعه URL فعلی جستجو کند. این API از google.script.history API پشتیبانی می کند. این فقط در زمینه یک برنامه وب که از IFRAME استفاده می کند قابل استفاده است. این برای استفاده با نوارهای کناری و گفتگو در یک متن افزودنی یا اسکریپت کانتینری در نظر گرفته نشده است. برای اطلاعات بیشتر، راهنمای استفاده از سابقه مرورگر در برنامه‌های وب را ببینید.

مواد و روش ها

روش	نوع برگشت	توضیح مختصر
getLocation(function)	void	یک شی مکان URL را دریافت می کند و آن را به تابع بازخوانی مشخص شده ارسال می کند.

مستندات دقیق

getLocation(function)

یک شی مکان URL را دریافت می کند و آن را به تابع callback مشخص شده (به عنوان تنها آرگومان) ارسال می کند.

Index.html

google.script.url.getLocation(function(location) {
  console.log(location.parameters);
  console.log(location.hash);
});

مولفه های

نام	تایپ کنید	شرح
function	Function	یک تابع فراخوانی سمت کلاینت برای اجرا، با استفاده از شی مکان به عنوان تنها آرگومان.

شی مکان

جدول زیر نمونه‌هایی از عناصر مکان را نشان می‌دهد که در صورت درخواست URL زیر مشخص می‌شوند: http://www.example.com?n=1&name=alice&n=2#headingAnchor

زمینه های
location.hash	مقدار رشته قطعه URL بعد از کاراکتر # یا یک رشته خالی اگر قطعه URL وجود نداشته باشد headingAnchor
location.parameter	یک شی از جفت‌های کلید/مقدار که با پارامترهای درخواست URL مطابقت دارند. فقط اولین مقدار برای پارامترهایی که چندین مقدار دارند برگردانده می شود. اگر هیچ پارامتری وجود نداشته باشد، این یک شی خالی خواهد بود. {"name": "alice", "n": "1"}
location.parameters	یک شی شبیه location.parameter ، اما با آرایه ای از مقادیر برای هر کلید. اگر هیچ پارامتری وجود نداشته باشد، این یک شی خالی خواهد بود. {"name": ["alice"], "n": ["1", "2"]}

---