מחלקה של google.script.url (ממשק API בצד הלקוח)

google.script.url הוא JavaScript אסינכרוני בצד הלקוח ממשק API שיכול לשלוח שאילתות על כתובות URL כדי לקבל את הפרמטרים והמקטע הנוכחיים של כתובת האתר. ה-API הזה תומך ב-google.script.history API. ניתן להשתמש בה רק בהקשר של אפליקציית אינטרנט שמשתמשת IFRAME היא לא מיועדת לשימוש עם סרגלי צד ותיבות דו-שיח בתוסף, או הקשר לסקריפט קונטיינר. מידע נוסף זמין במאמר מדריך לשימוש בדפדפן ההיסטוריה באפליקציות אינטרנט.

שיטות

שיטהסוג הערך המוחזרתיאור קצר
getLocation(function) void הפונקציה מקבלת אובייקט מיקום של כתובת URL ומעבירה אותו לקריאה החוזרת (callback) שצוינה מותאמת אישית.

מסמכי תיעוד מפורטים

getLocation(function)

הפונקציה מקבלת אובייקט של מיקום כתובת URL ומעבירה אותו לקריאה חוזרת (callback) שצוין פונקציה (כארגומנט היחיד).

Index.html

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

פרמטרים

שםסוגתיאור
functionFunctionבצד הלקוח להפעיל את פונקציית הקריאה החוזרת, באמצעות location object בתור הארגומנט היחיד.

אובייקט מיקום

הטבלה הבאה מציגה דוגמאות לרכיבי המיקום שיצוינו אם נעשתה שאילתה לגבי כתובת ה-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"]}