class 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"]}