google.script.url
هي واجهة برمجة تطبيقات غير متزامنة من جهة العميل لـ JavaScript، ويمكنها طلب البحث عن عناوين URL للحصول على معلَمات عناوين URL الحالية وأجزاءها الحالية.
تتوافق واجهة برمجة التطبيقات هذه مع google.script.history
API. ولا يمكن استخدامها إلا في سياق تطبيق ويب يستخدم IFRAME
.
ولم يُصمَّم للاستخدام مع الأشرطة الجانبية ومربّعات الحوار في سياق إضافة أو
حاوية نص برمجي. للاطّلاع على مزيد من المعلومات، يمكنك الاطّلاع على
دليل استخدام سجلّ المتصفّح في تطبيقات الويب.
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
getLocation(function) |
void |
للحصول على كائن موقع عنوان URL وتمريره إلى دالة رد الاتصال المحدّدة. |
الوثائق التفصيلية
getLocation(function)
للحصول على كائن موقع عنوان URL وتمريره إلى دالة رد الاتصال المحدّدة (كالوسيطة الوحيدة).
Index.html
google.script.url.getLocation(function(location) { console.log(location.parameters); console.log(location.hash); });
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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"]} |