url_handlers

تستخدم التطبيقات المجمّعة لتحديد أنماط عناوين URL التي يريد التطبيق اعتراضها ومعالجتها. ويمكن لأي تطبيق تحديد عدة معالِجات لعناوين URL ضمن إدخال البيان هذا، لكل منها معرِّف ونمط عنوان URL وعنوان. في ما يلي مثال على كيفية تحديد url_handlers:

"url_handlers": {
  "view_foo_presentation": {
    "matches": [
      "https://www.foo.com/presentation/view/*"
    ],
    "title": "View Foo presentation"
  },
  "view_bar_presentation": {
    "matches": [
      "https://www.bar.com/view/slideshow/*"
    ],
    "title": "View bar presentation"
  },
  "edit_spreadsheet": {
    "matches": [
      "https://www.foo.com/spreadsheet/edit/*",
      "https://www.bar.com/spreadsheet/edit/*"
    ],
    "title": "Edit spreadsheet"
  }
}

ولا يمكن للتطبيقات التسجيل إلا لمعالجة أنماط عناوين URL ضمن النطاقات التي تمتلكها، أي يمكنها إثبات ملكيتها على النحو الذي يحدّده سوق Chrome الإلكتروني. وسيتم رفض التطبيقات التي تنتهك هذا الشرط وتحاول التسجيل للتعامل مع عناوين URL الخارجية من خلال "سوق Chrome الإلكتروني" عند التحميل.

وهذا يعني تلقائيًا أنّه يجب دائمًا تحديد نطاق كامل على الأقل لجميع الأنماط ضمن matches. وبخلاف ذلك، لا يمكن إثبات الملكية.

عند التسجيل والتثبيت بنجاح، سيتم تشغيل التطبيق لجميع عمليات التنقل المتطابقة داخل علامات تبويب المتصفح بالإضافة إلى التطبيقات الأخرى. سيتلقّى التطبيق نوعًا جديدًا من الحدث app.runtime.onLaunched، مع كائن launchData الذي يحتوي على معرّف المعالِج المطابِق (مثل "view_foo_presentation" أعلاه)، وعنوان URL الذي يتمّ الانتقال إليه وعنوان URL للمُحيل.

تم حجز الحقل title لاستخدامه في المستقبل في جميع عناصر واجهة المستخدم ذات الصلة. يجب أن يصف هذا الإجراء الإجراء الذي ينفّذه التطبيق عند تشغيله باستخدام هذا النوع من معالِجات عناوين URL.