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

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);
});

المعلمات

الاسمالنوعالوصف
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"]}