google.script.url
هي واجهة برمجة تطبيقات JavaScript غير متزامنة من جهة العميل، ويمكنها طلب البحث عن عناوين URL للحصول على معلَمات وأجزاء عناوين URL الحالية.
وتتوافق واجهة برمجة التطبيقات هذه مع واجهة برمجة التطبيقات google.script.history
. ولا يمكن استخدامها إلا في سياق تطبيق الويب الذي يستخدم
IFRAME
.
لم يتم تصميم هذه السمة لاستخدامها مع الأشرطة الجانبية ومربّعات الحوار في سياق الإضافة أو الحاوية. ولمزيد من المعلومات، اطّلِع على دليل استخدام سجلّ المتصفّح في تطبيقات الويب.
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
getLocation(function) |
void |
يحصل على كائن موقع عنوان URL ويمرره إلى دالة رد الاتصال المحددة. |
المستندات التفصيلية
getLocation(function)
يحصل على كائن موقع عنوان URL ويمرِّره إلى دالة رد الاتصال المحدّدة (كالوسيطة الوحيدة).
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 بعد الحرف headingAnchor |
location.parameter |
عنصر من أزواج المفتاح/القيمة التي تتوافق مع معلَمات طلب عنوان URL. سيتم عرض القيمة الأولى فقط للمعلَمات التي تحتوي على قيم متعددة. في حال عدم توفّر معلّمات، سيكون هذا عنصرًا فارغًا. {"name": "alice", "n": "1"} |
location.parameters |
عنصر يشبه {"name": ["alice"], "n": ["1", "2"]} |