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); });
פרמטרים
שם | סוג | תיאור |
---|---|---|
function | Function | בצד הלקוח להפעיל את פונקציית הקריאה החוזרת, באמצעות location object בתור הארגומנט היחיד. |
אובייקט מיקום
הטבלה הבאה מציגה דוגמאות לרכיבי המיקום שיצוינו אם נעשתה שאילתה לגבי כתובת ה-URL הבאה:http://www.example.com?n=1&name=alice&n=2#headingAnchor
שדות | |
---|---|
location.hash |
ערך המחרוזת של מקטע כתובת URL אחרי התו headingAnchor |
location.parameter |
אובייקט של צמדי מפתח/ערך שתואמים לבקשה לכתובת ה-URL . רק הערך הראשון יוחזר לפרמטרים שיש להם כמה ערכים. אם לא קיימים פרמטרים, הפעולה להיות אובייקט ריק. {"name": "alice", "n": "1"} |
location.parameters |
אובייקט שדומה ל- {"name": ["alice"], "n": ["1", "2"]} |