الفئة google.script.url (واجهة برمجة تطبيقات من جهة العميل)

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الوصف
functionFunctionتشغيل دالة استدعاء من جهة العميل، باستخدام كائن الموقع الجغرافي كوسيطة الوحيدة.

كائن الموقع الجغرافي

يعرض الجدول التالي أمثلة لعناصر الموقع التي سيتم تحديدها إذا تم الاستعلام عن عنوان 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"]}