chrome.webviewTag

الوصف

استخدِم علامة webview لتحميل محتوى مباشر من الويب على الشبكة وتضمينه في تطبيق Chrome. يمكن لتطبيقك التحكّم في مظهر webview والتفاعل مع محتوى الويب، وبدء عمليات التنقّل في صفحة ويب مضمّنة، والتفاعل مع أحداث الأخطاء التي تحدث فيها، وغير ذلك (راجِع الاستخدام).

الأذونات

webview

الأنواع

ClearDataOptions

الخيارات التي تحدّد البيانات التي يجب أن يتم محوها بواسطة clearData

أماكن إقامة

  • منذ

    رقم اختياري

    تمحو هذه السمة البيانات التي تم تجميعها في هذا التاريخ أو بعده، ويتم تمثيلها بالمللي ثانية منذ بدء حساب الفترة (يمكن الوصول إليها من خلال طريقة getTime لعنصر Date في JavaScript). في حال عدم توفّر القيمة، يتم ضبطها تلقائيًا على 0 (ما يؤدي إلى إزالة جميع بيانات التصفح).

ClearDataTypeSet

مجموعة من أنواع البيانات يتم تفسير المواقع غير المتوفّرة على أنّها false.

أماكن إقامة

  • appcache

    منطقي اختياري

    ذاكرة التخزين المؤقت للتطبيقات على المواقع الإلكترونية

  • ذاكرة التخزين المؤقت

    منطقي اختياري

    Chrome 44 والإصدارات الأحدث

    بدايةً من الإصدار 43 من متصفّح Chrome ذاكرة التخزين المؤقت للمتصفح ملاحظة: عند إزالة البيانات، يتم محو ذاكرة التخزين المؤقت بالكامل، ولا يقتصر ذلك على النطاق الذي تحدّده.

  • ملفات تعريف الارتباط

    منطقي اختياري

    ملفات تعريف ارتباط القسم

  • fileSystems

    منطقي اختياري

    أنظمة ملفات المواقع الإلكترونية

  • indexedDB

    منطقي اختياري

    بيانات IndexedDB للمواقع الإلكترونية

  • localStorage

    منطقي اختياري

    بيانات التخزين المحلي للمواقع الإلكترونية

  • persistentCookies

    منطقي اختياري

    الإصدار 58 من Chrome والإصدارات الأحدث

    ملفات تعريف الارتباط الثابتة للقسم

  • sessionCookies

    منطقي اختياري

    الإصدار 58 من Chrome والإصدارات الأحدث

    ملفات تعريف ارتباط الجلسة للقسم

  • webSQL

    منطقي اختياري

    بيانات WebSQL لمواقع الويب

ContentScriptDetails

Chrome 44 والإصدارات الأحدث

تفاصيل نص المحتوى الذي سيتم إدخاله يُرجى الاطّلاع على مستندات النصوص البرمجية للمحتوى للحصول على مزيد من التفاصيل.

أماكن إقامة

  • all_frames

    منطقي اختياري

    إذا كان all_frames يساوي true، يعني ذلك أنّه يجب إدراج JavaScript أو CSS في جميع إطارات الصفحة الحالية. القيمة التلقائية لـ all_frames هي false ويتم إدخال JavaScript أو CSS في الإطار العلوي فقط.

  • css

    ‫InjectionItems اختيارية

    رمز CSS أو قائمة بملفات CSS التي سيتم إدراجها في الصفحات المطابقة ويتم إدراجها بالترتيب الذي تظهر به، قبل إنشاء أيّ عنصر DOM أو عرضه للصفحة.

  • exclude_globs

    سلسلة اختيارية

    يتم تطبيقها بعد المطابقات لاستبعاد عناوين URL التي تتطابق مع هذا النطاق الشامل. يهدف إلى محاكاة الكلمة الرئيسية @exclude في Greasemonkey.

  • exclude_matches

    سلسلة اختيارية

    يستبعد الصفحات التي سيتم إدراج نص برمجي للمحتوى فيها.

  • include_globs

    سلسلة اختيارية

    يتم تطبيقها بعد المطابقات لتضمين عناوين URL التي تتطابق أيضًا مع هذا النطاق الشامل فقط. يهدف إلى محاكاة الكلمة الرئيسية @include في Greasemonkey.

  • js

    ‫InjectionItems اختيارية

    رمز JavaScript أو قائمة بملفات JavaScript التي سيتم إدراجها في الصفحات المطابقة ويتم إدراجها بالترتيب الذي تظهر به.

  • match_about_blank

    منطقي اختياري

    ما إذا كان سيتم إدراج نص برمجي للمحتوى في about:blank وabout:srcdoc لن يتمّ حقن نصوص برمجة المحتوى في الصفحات إلا عندما يتطابق عنوان URL المُكتسَب مع أحد الأنماط المعلَن عنها في حقل المطابقات. عنوان URL المُكتسَب هو عنوان URL للمستند الذي أنشأ الإطار أو النافذة. لا يمكن إدراج نصوص برمجية للمحتوى في إطارات وضع الحماية.

  • فلتر مطابق لـ

    string[]

    تُستخدَم لتحديد الصفحات التي سيتم إدراج نص المحتوى هذا فيها.

  • الاسم

    سلسلة

    اسم نص المحتوى المطلوب إدراجه

  • run_at

    ‫RunAt اختيارية

    أقرب وقت يتم فيه إدخال JavaScript أو CSS في علامة التبويب. الإعداد التلقائي هو "document_idle".

ContentWindow

الاسم المعرِّف للمراسلة في نافذة ضيف

أماكن إقامة

  • postMessage

    غير صالح

    تنشر رسالة في محتوى الويب المضمّن ما دام المحتوى المضمّن يعرض صفحة من المصدر المستهدَف. تتوفّر هذه الطريقة بعد اكتمال تحميل الصفحة. انتظِر الحدث contentload ثم استخدِم الطريقة.

    سيتمكّن الضيف من إرسال ردود إلى المستخدم الذي أدرج المحتوى من خلال نشر رسالة إلى event.source في حدث الرسالة الذي يتلقّاه.

    هذه الواجهة متطابقة مع HTML5 postMessage API للتواصل بين صفحات الويب. يمكن لمُدرِج المحتوى الاستماع إلى الردود من خلال إضافة أداة معالجة أحداث message إلى إطاره الخاص.

    تبدو الدالة postMessage على النحو التالي: 

    (message: any, targetOrigin: string) => {...}

    • رسالة

      أي واحد

      عنصر الرسالة المطلوب إرساله إلى الضيف

    • targetOrigin

      سلسلة

      تحدِّد هذه الوسيطة مصدر نافذة الضيف المطلوب إرسال الحدث إليها.

ContextMenuCreateProperties

Chrome 44 والإصدارات الأحدث

أماكن إقامة

  • تم التحديد

    منطقي اختياري

    الحالة الأولية لمربّع اختيار أو زر اختيار: صحيح (true) للعنصر المحدّد وخطأ (false) للعنصر غير المحدّد. يمكن اختيار عنصر راديو واحد فقط في كل مرة في مجموعة معيّنة من عناصر الراديو.

  • السياقات

    [ContextType, ...ContextType[]] اختياري

    قائمة السياقات التي سيظهر فيها عنصر القائمة هذا يتم ضبط القيمة تلقائيًا على ['page'] في حال عدم تحديدها.

  • documentUrlPatterns

    سلسلة اختيارية

    يتيح لك حصر العنصر ليسري على المستندات التي يتطابق عنوان URL الخاص بها مع أحد الأنماط المحدّدة فقط. (ينطبق ذلك أيضًا على اللقطات). لمعرفة التفاصيل حول تنسيق النمط، يُرجى الاطّلاع على أنماط المطابقة.

  • مفعّلة

    منطقي اختياري

    ما إذا كان عنصر قائمة السياقات هذا مفعّلاً أم غير مفعّل الإعداد التلقائي هو true.

  • id

    سلسلة اختيارية

    المعرّف الفريد الذي سيتمّ تعيينه لهذا العنصر. مطلوب لصفحات الفعاليات. لا يمكن أن يكون هو نفسه معرّف آخر لهذه الإضافة.

  • parentId

    سلسلة | رقم اختياري

    معرّف عنصر قائمة رئيسي، ما يجعل العنصر فرعيًا لعنصر تمت إضافته سابقًا.

  • targetUrlPatterns

    سلسلة اختيارية

    تشبه documentUrlPatterns، ولكنها تتيح لك الفلترة استنادًا إلى سمة src لعلامات img/audio/video وسمة href لعلامات الربط.

  • title

    سلسلة اختيارية

    النص الذي سيتم عرضه في العنصر، وهو مطلوب ما لم يكن type هو "فاصل". عندما يكون السياق "selection" (الاختيار)، يمكنك استخدام %s داخل السلسلة لعرض النص المحدّد. على سبيل المثال، إذا كانت قيمة هذه المَعلمة هي "ترجمة %s إلى لغة Pig Latin" واختار المستخدم الكلمة "رائع"، سيكون عنصر قائمة السياقات للاختيار هو "ترجمة كلمة "رائع" إلى لغة Pig Latin".

  • كتابة

    ‫ItemType اختيارية

    نوع عنصر القائمة. يتم ضبط القيمة تلقائيًا على "عادي" في حال عدم تحديدها.

  • onclick

    void اختياري

    دالة سيتمّ استدعاؤها عند النقر على عنصر القائمة.

    تبدو الدالة onclick على النحو التالي: 

    (info: OnClickData) => {...}

    • معلومات

      OnClickData

      معلومات عن العنصر الذي تم النقر عليه والسياق الذي حدثت فيه النقرة

ContextMenus

Chrome 44 والإصدارات الأحدث

أماكن إقامة

  • onShow

    الحدث<functionvoidvoid>

    يتم تشغيله قبل عرض قائمة سياق على هذا webview. يمكن استخدامها لإيقاف قائمة السياقات هذه من خلال استدعاء event.preventDefault().

    تبدو الدالة onShow.addListener على النحو التالي: 

    (callback: function) => {...}

    • ردّ الاتصال

      دالة

      تظهر المَعلمة callback على النحو التالي: 

      (event: object) => void

      • حدث

        عنصر

        • preventDefault

          غير صالح

          يمكنك استدعاء هذا الإجراء لمنع عرض قائمة السياقات.

          تبدو الدالة preventDefault على النحو التالي: 

          () => {...}

  • إنشاء

    غير صالح

    لإنشاء عنصر جديد في قائمة السياقات يُرجى العلم أنّه في حال حدوث خطأ أثناء الإنشاء، قد لا يتم اكتشافه إلى أن يتم تشغيل ردّ الاتصال بالإنشاء (ستظهر التفاصيل في runtime.lastError).

    تبدو الدالة create على النحو التالي: 

    (createProperties: object, callback?: function) => {...}

    • createProperties

      عنصر

      السمات المستخدَمة لإنشاء العنصر

    • ردّ الاتصال

      الدالة اختيارية

      تظهر المَعلمة callback على النحو التالي: 

      () => void

    • returns

      سلسلة | رقم

      معرّف العنصر الذي تم إنشاؤه حديثًا.

  • إزالة

    غير صالح

    تزيل عنصرًا من قائمة السياقات.

    تبدو الدالة remove على النحو التالي: 

    (menuItemId: string | number, callback?: function) => {...}

    • menuItemId

      سلسلة | رقم

      رقم تعريف عنصر قائمة السياقات المطلوب إزالته

    • ردّ الاتصال

      الدالة اختيارية

      تظهر المَعلمة callback على النحو التالي: 

      () => void

  • removeAll

    غير صالح

    تزيل هذه القيمة جميع عناصر قائمة السياقات التي تمت إضافتها إلى هذا webview.

    تبدو الدالة removeAll على النحو التالي: 

    (callback?: function) => {...}

    • ردّ الاتصال

      الدالة اختيارية

      تظهر المَعلمة callback على النحو التالي: 

      () => void

  • تحديث

    غير صالح

    تعديل عنصر قائمة سياق تم إنشاؤه سابقًا

    تبدو الدالة update على النحو التالي: 

    (id: string | number, updateProperties: object, callback?: function) => {...}

    • id

      سلسلة | رقم

      معرّف العنصر المطلوب تعديله.

    • updateProperties

      عنصر

      السمات المطلوب تعديلها تقبل الدالة القيم نفسها التي تقبلها الدالة create.

    • ردّ الاتصال

      الدالة اختيارية

      تظهر المَعلمة callback على النحو التالي: 

      () => void

ContextMenuUpdateProperties

Chrome 44 والإصدارات الأحدث

أماكن إقامة

  • تم التحديد

    منطقي اختياري

    حالة مربّع اختيار أو زر اختيار: صحيح (true) للعنصر المحدّد وخطأ (false) للعنصر غير المحدّد. يمكن اختيار عنصر راديو واحد فقط في كل مرة في مجموعة معيّنة من عناصر الراديو.

  • السياقات

    [ContextType, ...ContextType[]] اختياري

    قائمة السياقات التي سيظهر فيها عنصر القائمة هذا

  • documentUrlPatterns

    سلسلة اختيارية

    يتيح لك حصر العنصر ليسري على المستندات التي يتطابق عنوان URL الخاص بها مع أحد الأنماط المحدّدة فقط. (ينطبق ذلك أيضًا على اللقطات). لمعرفة التفاصيل حول تنسيق النمط، يُرجى الاطّلاع على أنماط المطابقة.

  • مفعّلة

    منطقي اختياري

    ما إذا كان عنصر قائمة السياقات هذا مفعّلاً أم غير مفعّل

  • parentId

    سلسلة | رقم اختياري

    معرّف عنصر قائمة رئيسي، ما يجعل العنصر فرعيًا لعنصر تمت إضافته سابقًا. ملاحظة: لا يمكنك تغيير عنصر ليصبح عنصرًا فرعيًا لأحد سلفه.

  • targetUrlPatterns

    سلسلة اختيارية

    تشبه documentUrlPatterns، ولكنها تتيح لك الفلترة استنادًا إلى سمة src لعلامات img/audio/video وسمة href لعلامات الربط.

  • title

    سلسلة اختيارية

    النص الذي سيتم عرضه في العنصر

  • كتابة

    ‫ItemType اختيارية

    نوع عنصر القائمة.

  • onclick

    void اختياري

    دالة سيتمّ استدعاؤها عند النقر على عنصر القائمة.

    تبدو الدالة onclick على النحو التالي: 

    (info: OnClickData) => {...}

    • معلومات

      OnClickData

      معلومات عن العنصر الذي تم النقر عليه والسياق الذي حدثت فيه النقرة

ContextType

Chrome 44 والإصدارات الأحدث

السياقات المختلفة التي يمكن أن تظهر فيها القائمة ويؤدي تحديد "all" إلى دمج جميع السياقات الأخرى.

Enum

"all"

"page"

"frame"

"selection"

"link"

"editable"

"image"

"video"

"audio"

DialogController

واجهة مرفقة بأحداث dialog DOM

أماكن إقامة

  • إلغاء

    غير صالح

    ارفض مربّع الحوار. يعادل النقر على "إلغاء" في مربّع حوار confirm أو prompt.

    تبدو الدالة cancel على النحو التالي: 

    () => {...}

  • حسنًا

    غير صالح

    اقبل مربّع الحوار. يعادل النقر على "حسنًا" في مربّع حوار alert أو confirm أو prompt.

    تبدو الدالة ok على النحو التالي: 

    (response?: string) => {...}

    • رد

      سلسلة اختيارية

      سلسلة الردّ التي سيتم تقديمها للضيف عند قبول مربّع حوار prompt

DownloadPermissionRequest

نوع عنصر request الذي يصاحب حدث download permissionrequest في نموذج DOM

أماكن إقامة

  • requestMethod

    سلسلة

    نوع طلب HTTP (مثل GET) المرتبط بطلب التنزيل

  • url

    سلسلة

    عنوان URL المطلوب للتنزيل

  • سماح

    غير صالح

    امنح الإذن المطلوب.

    تبدو الدالة allow على النحو التالي: 

    () => {...}

  • رفض

    غير صالح

    رفض طلب الإذن هذا هو السلوك التلقائي في حال عدم استدعاء allow.

    تبدو الدالة deny على النحو التالي: 

    () => {...}

FileSystemPermissionRequest

نوع عنصر request الذي يصاحب حدث filesystem permissionrequest في نموذج DOM

أماكن إقامة

  • url

    سلسلة

    عنوان URL للإطار الذي يطلب الوصول إلى نظام الملفات على الجهاز

  • سماح

    غير صالح

    امنح الإذن المطلوب.

    تبدو الدالة allow على النحو التالي: 

    () => {...}

  • رفض

    غير صالح

    رفض طلب الإذن

    تبدو الدالة deny على النحو التالي: 

    () => {...}

FindCallbackResults

يحتوي على جميع نتائج طلب البحث.

أماكن إقامة

  • activeMatchOrdinal

    الرقم

    الرقم الترتيبي للمطابقة الحالية.

  • مُلغاة

    قيمة منطقية

    يشير إلى ما إذا تم إلغاء طلب البحث هذا.

  • numberOfMatches

    الرقم

    عدد المرات التي تمت فيها مطابقة searchText على الصفحة

  • selectionRect

    SelectionRect

    يصف مستطيلاً حول المطابقة النشطة في إحداثيات الشاشة.

FindOptions

خيارات طلب البحث

أماكن إقامة

  • للخلف

    منطقي اختياري

    وضع علامة للعثور على المطابقات بترتيب عكسي تكون القيمة التلقائية false.

  • matchCase

    منطقي اختياري

    علامة للمطابقة مع الحساسية لحالة الأحرف تكون القيمة التلقائية false.

FullscreenPermissionRequest

Chrome 43 والإصدارات الأحدث

نوع عنصر request الذي يصاحب حدث fullscreen permissionrequest في نموذج DOM

أماكن إقامة

  • الأصل

    سلسلة

    مصدر الإطار داخل webview الذي بدأ طلب ملء الشاشة.

  • سماح

    غير صالح

    امنح الإذن المطلوب.

    تبدو الدالة allow على النحو التالي: 

    () => {...}

  • رفض

    غير صالح

    رفض طلب الإذن

    تبدو الدالة deny على النحو التالي: 

    () => {...}

GeolocationPermissionRequest

نوع عنصر request الذي يصاحب حدث geolocation permissionrequest في نموذج DOM

أماكن إقامة

  • url

    سلسلة

    عنوان URL للإطار الذي يطلب الوصول إلى بيانات الموقع الجغرافي

  • سماح

    غير صالح

    امنح الإذن المطلوب.

    تبدو الدالة allow على النحو التالي: 

    () => {...}

  • رفض

    غير صالح

    رفض طلب الإذن هذا هو السلوك التلقائي في حال عدم استدعاء allow.

    تبدو الدالة deny على النحو التالي: 

    () => {...}

HidPermissionRequest

الإصدار 125 من Chrome والإصدارات الأحدث

نوع عنصر request الذي يصاحب حدث hid permissionrequest في نموذج DOM

أماكن إقامة

  • url

    سلسلة

    عنوان URL للإطار الذي يطلب الوصول إلى HID API

  • سماح

    غير صالح

    امنح الإذن المطلوب.

    تبدو الدالة allow على النحو التالي: 

    () => {...}

  • رفض

    غير صالح

    رفض طلب الإذن هذا هو السلوك التلقائي في حال عدم استدعاء allow.

    تبدو الدالة deny على النحو التالي: 

    () => {...}

InjectDetails

تفاصيل النص البرمجي أو CSS المطلوب إدراجه يجب ضبط رمز الملف أو ملفه، ولكن لا يمكن ضبط كليهما في الوقت نفسه.

أماكن إقامة

  • رمز

    سلسلة اختيارية

    رمز JavaScript أو CSS المطلوب إدراجه

    تحذير: يُرجى توخّي الحذر عند استخدام المَعلمة code. وقد يؤدي استخدامها بشكل غير صحيح إلى تعريض تطبيقك لهجمات النصوص البرمجية عبر المواقع الإلكترونية.

  • ملف

    سلسلة اختيارية

    ملف JavaScript أو CSS المطلوب إدراجه

InjectionItems

Chrome 44 والإصدارات الأحدث

نوع عنصر الحقن: رمز أو مجموعة من الملفات

أماكن إقامة

  • رمز

    سلسلة اختيارية

    رمز JavaScript أو CSS المطلوب إدراجه في الصفحات المطابقة

  • ملفات

    سلسلة اختيارية

    قائمة ملفات JavaScript أو CSS التي سيتم إدراجها في الصفحات المطابقة ويتم إدراجها بالترتيب الذي تظهر به في هذه الصفيف.

LoadPluginPermissionRequest

نوع عنصر request الذي يصاحب حدث loadplugin permissionrequest في نموذج DOM

أماكن إقامة

  • معرّف

    سلسلة

    سلسلة معرّف المكوّن الإضافي

  • الاسم

    سلسلة

    الاسم المعروض للمكوّن الإضافي

  • سماح

    غير صالح

    امنح الإذن المطلوب. هذا هو السلوك التلقائي في حال عدم استدعاء deny.

    تبدو الدالة allow على النحو التالي: 

    () => {...}

  • رفض

    غير صالح

    رفض طلب الإذن

    تبدو الدالة deny على النحو التالي: 

    () => {...}

MediaPermissionRequest

نوع عنصر request الذي يصاحب حدث media permissionrequest في نموذج DOM

أماكن إقامة

  • url

    سلسلة

    عنوان URL للإطار الذي يطلب الوصول إلى وسائط المستخدم.

  • سماح

    غير صالح

    امنح الإذن المطلوب.

    تبدو الدالة allow على النحو التالي: 

    () => {...}

  • رفض

    غير صالح

    رفض طلب الإذن هذا هو السلوك التلقائي في حال عدم استدعاء allow.

    تبدو الدالة deny على النحو التالي: 

    () => {...}

NewWindow

واجهة مرفقة بأحداث newwindow DOM

أماكن إقامة

  • إرفاق

    غير صالح

    إرفاق الصفحة المستهدفة المطلوبة بعنصر webview حالي

    تبدو الدالة attach على النحو التالي: 

    (webview: object) => {...}

    • webview

      عنصر

      عنصر webview الذي يجب إرفاق الصفحة المستهدفة به

  • تجاهل

    غير صالح

    إلغاء طلب النافذة الجديدة

    تبدو الدالة discard على النحو التالي: 

    () => {...}

PointerLockPermissionRequest

نوع عنصر request الذي يصاحب حدث pointerLock permissionrequest في نموذج DOM

أماكن إقامة

  • lastUnlockedBySelf

    قيمة منطقية

    ما إذا كان الإطار الذي يطلب المحتوى هو أحدث عميل عقد قفل المؤشر أم لا

  • url

    سلسلة

    عنوان URL للإطار الذي يطلب قفل المؤشر

  • userGesture

    قيمة منطقية

    ما إذا تم طلب قفل المؤشر نتيجةً لإيماءة إدخال المستخدم أم لا

  • سماح

    غير صالح

    امنح الإذن المطلوب.

    تبدو الدالة allow على النحو التالي: 

    () => {...}

  • رفض

    غير صالح

    رفض طلب الإذن هذا هو السلوك التلقائي في حال عدم استدعاء allow.

    تبدو الدالة deny على النحو التالي: 

    () => {...}

SelectionRect

تصف مستطيلاً في إحداثيات الشاشة.

تشبه دلالات الحصر صفيفًا، أي أنّ الإحداثي (left, top) يُعتبر مضمّنًا في المستطيل، ولكن الإحداثي (left + width, top) ليس كذلك.

أماكن إقامة

  • الطول

    الرقم

    ارتفاع المستطيل

  • اليسرى

    الرقم

    المسافة من الحافة اليسرى للشاشة إلى الحافة اليسرى للمستطيل

  • العلوية

    الرقم

    المسافة من أعلى حافة الشاشة إلى أعلى حافة المستطيل

  • العرض

    الرقم

    عرض المستطيل

WebRequestEventInterface

Chrome 44 والإصدارات الأحدث

واجهة توفّر إمكانية الوصول إلى أحداث webRequest على صفحة الضيف اطّلِع على واجهة برمجة التطبيقات chrome.webRequest للإضافات للحصول على تفاصيل عن دورة حياة webRequest والمفاهيم ذات الصلة. ملاحظة: لا يتوفّر الحدث chrome.webRequest.onActionIgnored لعروض الويب.

لتوضيح كيفية اختلاف الاستخدام عن واجهة برمجة التطبيقات webRequest API للإضافات، ننصحك بالاطّلاع على الرمز البرمجي النموذجي التالي الذي يحظر أي طلبات من الضيوف لعناوين URL تتطابق مع *://www.evil.com/*:

webview.request.onBeforeRequest.addListener(
  function(details) { return {cancel: true}; },
  {urls: ["*://www.evil.com/*"]},
  ["blocking"]);

بالإضافة إلى ذلك، تتيح هذه الواجهة قواعد webRequest التعريفية من خلال أحداث onRequest وonMessage. يُرجى الاطّلاع على declarativeWebRequest لمعرفة تفاصيل واجهة برمجة التطبيقات.

يُرجى العِلم أنّه يجب إنشاء مثيلات للشروط والإجراءات المتعلّقة بطلبات webview التعريفية من نظائرها في chrome.webViewRequest.*. يحظر الرمز البرمجي النموذجي التالي بشكل صريح جميع الطلبات إلى "example.com" على webview myWebview:

var rule = {
  conditions: [
    new chrome.webViewRequest.RequestMatcher({ url: { hostSuffix: 'example.com' } })
  ],
  actions: [ new chrome.webViewRequest.CancelRequest() ]
};
myWebview.request.onRequest.addRules([rule]);

ZoomMode

Chrome 43 والإصدارات الأحدث

تحدِّد كيفية التعامل مع التصغير/التكبير في webview.

Enum

"حسب المصدر"
ستبقى تغييرات التصغير/التكبير محفوظة في مصدر الصفحة التي تم تكبيرها، أي أنّه سيتم تكبير جميع طرق عرض الويب الأخرى في القسم نفسه التي يتم الانتقال إليها من هذا المصدر نفسه. بالإضافة إلى ذلك، per-origin يتم حفظ تغييرات التكبير/التصغير مع المصدر، ما يعني أنّه عند الانتقال إلى صفحات أخرى في المصدر نفسه، سيتم تكبيرها أو تصغيرها جميعًا باستخدام عامل التكبير/التصغير نفسه.

"لكلّ عرض"
لا يتم تطبيق تغييرات التكبير/التصغير إلا في عرض الويب هذا، ولن تؤثّر تغييرات التكبير/التصغير في عروض الويب الأخرى في التكبير/التصغير في عرض الويب هذا. بالإضافة إلى ذلك، per-view تتم إعادة ضبط تغييرات التكبير/التصغير عند التنقّل. سيؤدي التنقّل في عرض ويب إلى تحميل الصفحات دائمًا باستخدام عوامل التكبير/التصغير لكل مصدر (ضمن نطاق التقسيم).

"disabled"
يؤدي هذا الخيار إلى إيقاف كل عمليات التصغير أو التكبير في webview. سيعود المحتوى إلى مستوى التكبير أو التصغير التلقائي، وسيتم تجاهل جميع التغييرات التي تمّت محاولة إجراؤها على مستوى التكبير أو التصغير.

أماكن إقامة

contentWindow

مرجع العنصر الذي يمكن استخدامه لنشر الرسائل في صفحة الضيف

النوع

ContentWindow

contextMenus

Chrome 44 والإصدارات الأحدث

تشبه واجهة برمجة التطبيقات ContextMenus API في Chrome، ولكنّها تنطبق على webview بدلاً من المتصفّح. استخدِم واجهة برمجة التطبيقات webview.contextMenus لإضافة عناصر إلى قائمة سياق webview. يمكنك اختيار أنواع العناصر التي تنطبق عليها إضافات قائمة السياقات، مثل الصور والروابط الفائقة والصفحات.

النوع

ContextMenus

request

واجهة توفّر إمكانية الوصول إلى أحداث webRequest على صفحة الضيف

النوع

WebRequestEventInterface

الطُرق

addContentScripts()

Chrome 44 والإصدارات الأحدث 
chrome.webviewTag.addContentScripts(
  contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
)

تُضيف قواعد حقن النصوص البرمجية للمحتوى إلى webview. عندما ينتقل webview إلى صفحة تتطابق مع قاعدة واحدة أو أكثر، سيتمّ إدراج النصوص البرمجية المرتبطة. يمكنك إضافة قواعد أو تعديل القواعد الحالية آليًا.

يضيف المثال التالي قاعدتَين إلى webview: "myRule" و"anotherRule".

webview.addContentScripts([
  {
    name: 'myRule',
    matches: ['http://www.foo.com/*'],
    css: { files: ['mystyles.css'] },
    js: { files: ['jquery.js', 'myscript.js'] },
    run_at: 'document_start'
  },
  {
    name: 'anotherRule',
    matches: ['http://www.bar.com/*'],
    js: { code: "document.body.style.backgroundColor = 'red';" },
    run_at: 'document_end'
  }]);
 ...

// Navigates webview.
webview.src = 'http://www.foo.com';

يمكنك تأجيل طلب addContentScripts إلى أن تحتاج إلى إدراج النصوص البرمجية.

يوضّح المثال التالي كيفية استبدال قاعدة حالية.

webview.addContentScripts([{
    name: 'rule',
    matches: ['http://www.foo.com/*'],
    js: { files: ['scriptA.js'] },
    run_at: 'document_start'}]);

// Do something.
webview.src = 'http://www.foo.com/*';
 ...
// Overwrite 'rule' defined before.
webview.addContentScripts([{
    name: 'rule',
    matches: ['http://www.bar.com/*'],
    js: { files: ['scriptB.js'] },
    run_at: 'document_end'}]);

إذا تمّ توجيه webview إلى المصدر (مثل foo.com) وطلبت من webview.addContentScripts إضافة "myRule"، عليك الانتظار إلى أن يتمّ التنقّل التالي لإجراء عملية إدراج النصوص البرمجية. إذا كنت تريد إجراء عملية حقن فورية، سيتّخذ executeScript الإجراء المناسب.

يتم الاحتفاظ بالقواعد حتى إذا تعطّلت عملية الضيف أو تم إغلاقها أو حتى إذا تم إعادة ربط webview بوحدة التحكم.

يُرجى الاطّلاع على مستندات النصوص البرمجية للمحتوى للحصول على مزيد من التفاصيل.

المعلمات

back()

chrome.webviewTag.back(
  callback?: function,
)

الانتقال للخلف إلى إدخال واحد في السجلّ إن أمكن هذا الرمز مكافئ للرمز go(-1).

المعلمات

  • ردّ الاتصال

    الدالة اختيارية

    Chrome 44 والإصدارات الأحدث

    تظهر المَعلمة callback على النحو التالي: 

    (success: boolean) => void

    • النجاح

      قيمة منطقية

      يشير إلى ما إذا كانت عملية التنقّل ناجحة.

canGoBack()

chrome.webviewTag.canGoBack()

تشير إلى ما إذا كان من الممكن التنقّل للخلف في السجلّ. يتم تخزين حالة هذه الدالة مؤقتًا، ويتم تعديلها قبل كل loadcommit، لذا فإنّ أفضل مكان لاستدعائها هو loadcommit.

المرتجعات

  • قيمة منطقية

canGoForward()

chrome.webviewTag.canGoForward()

يشير إلى ما إذا كان من الممكن التنقّل إلى الأمام في السجلّ. يتم تخزين حالة هذه الدالة مؤقتًا، ويتم تعديلها قبل كل loadcommit، لذا فإنّ أفضل مكان لاستدعائها هو loadcommit.

المرتجعات

  • قيمة منطقية

captureVisibleRegion()

الإصدار 50 من Chrome والإصدارات الأحدث 
chrome.webviewTag.captureVisibleRegion(
  options?: ImageDetails,
  callback: function,
)

لالتقاط المنطقة المرئية من العرض على الويب

المعلمات

  • الخيارات

    ‫ImageDetails اختيارية

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (dataUrl: string) => void

    • dataUrl

      سلسلة

      عنوان URL للبيانات الذي يشفِّر صورة للمنطقة المرئية من علامة التبويب التي تم التقاطها يمكن تعيينها لسمة src في عنصر صورة HTML لعرضها.

clearData()

chrome.webviewTag.clearData(
  options: ClearDataOptions,
  types: ClearDataTypeSet,
  callback?: function,
)

لمحو بيانات التصفّح للقسيمة webview

المعلمات

  • الخيارات

    ClearDataOptions

    خيارات لتحديد البيانات التي سيتم محوها

  • الأنواع

    ClearDataTypeSet

    أنواع البيانات التي سيتم محوها

  • ردّ الاتصال

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

executeScript()

chrome.webviewTag.executeScript(
  details: InjectDetails,
  callback?: function,
)

يتمّ إدخال رمز JavaScript في صفحة الضيف.

يستخدم نموذج الرمز البرمجي التالي ميزة "إدراج نص برمجي" لضبط لون خلفية صفحة الضيف على اللون الأحمر:

webview.executeScript({ code: "document.body.style.backgroundColor = 'red'" });

المعلمات

  • التفاصيل

    InjectDetails

    تفاصيل النص البرمجي المطلوب تنفيذه

  • ردّ الاتصال

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (result?: any[]) => void

    • نتيجة

      أيّ[] اختيارية

      نتيجة النص البرمجي في كل إطار تمّت حقنه

find()

chrome.webviewTag.find(
  searchText: string,
  options?: FindOptions,
  callback?: function,
)

يبدأ طلب البحث في الصفحة.

المعلمات

  • searchText

    سلسلة

    السلسلة المطلوب العثور عليها في الصفحة.

  • الخيارات

    FindOptions اختيارية

    خيارات طلب البحث

  • ردّ الاتصال

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (results?: FindCallbackResults) => void

    • النتائج

      FindCallbackResults اختياري

      يحتوي على جميع نتائج طلب البحث. يمكن حذف results إذا لم يتم استخدامها في نص دالة ردّ الاتصال، على سبيل المثال، إذا كانت دالة ردّ الاتصال تُستخدَم فقط لتحديد وقت اكتمال طلب البحث.

forward()

chrome.webviewTag.forward(
  callback?: function,
)

الانتقال إلى إدخال سجلّ واحد للأمام إن أمكن هذا الرمز مكافئ للرمز go(1).

المعلمات

  • ردّ الاتصال

    الدالة اختيارية

    Chrome 44 والإصدارات الأحدث

    تظهر المَعلمة callback على النحو التالي: 

    (success: boolean) => void

    • النجاح

      قيمة منطقية

      يشير إلى ما إذا كانت عملية التنقّل ناجحة.

getAudioState()

Chrome 62 والإصدارات الأحدث 
chrome.webviewTag.getAudioState(
  callback: function,
)

يطلب حالة الصوت.

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (audible: boolean) => void

    • تطبيق audible

      قيمة منطقية

getProcessId()

chrome.webviewTag.getProcessId()

تعرِض هذه السمة رقم تعريف العملية الداخلية في Chrome لعملية صفحة الويب للضيف الحالية، ما يسمح لمُدرِجي المحتوى بمعرفة عدد الضيوف الذين سيتأثرون بإيقاف العملية. لن يشارك ضيفان عملية إلا إذا كانا ينتميان إلى التطبيق نفسه وكان لديهما معرّف قسم التخزين نفسه. تكون المكالمة متزامنة وتُرجع المفهوم المخزّن مؤقتًا لمُضمِّن المحتوى عن معرّف العملية الحالي. يختلف رقم تعريف العملية عن رقم تعريف العملية في نظام التشغيل.

المرتجعات

  • الرقم

getUserAgent()

chrome.webviewTag.getUserAgent()

تعرِض هذه السمة سلسلة وكيل المستخدم المستخدَمة من قِبل webview لطلبات صفحات الزوّار.

المرتجعات

  • سلسلة

getZoom()

chrome.webviewTag.getZoom(
  callback: function,
)

الحصول على عامل التكبير أو التصغير الحالي

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (zoomFactor: number) => void

    • zoomFactor

      الرقم

      عامل التكبير أو التصغير الحالي

getZoomMode()

Chrome 43 والإصدارات الأحدث 
chrome.webviewTag.getZoomMode(
  callback: function,
)

الحصول على وضع التكبير أو التصغير الحالي

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (ZoomMode: ZoomMode) => void

    • ZoomMode

      ZoomMode

      وضع التكبير/التصغير الحالي في webview

go()

chrome.webviewTag.go(
  relativeIndex: number,
  callback?: function,
)

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

المعلمات

  • relativeIndex

    الرقم

    فهرس السجلّ النسبي الذي يجب توجيه webview إليه على سبيل المثال، ستؤدي القيمة 2 إلى التنقّل إلى الأمام في إدخالَين من السجلّ إذا أمكن، وستؤدي القيمة -3 إلى التنقّل للخلف في 3 إدخالات.

  • ردّ الاتصال

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (success: boolean) => void

    • النجاح

      قيمة منطقية

      يشير إلى ما إذا كانت عملية التنقّل ناجحة.

insertCSS()

chrome.webviewTag.insertCSS(
  details: InjectDetails,
  callback?: function,
)

يتمّ إدخال CSS في صفحة الضيف.

المعلمات

  • التفاصيل

    InjectDetails

    تفاصيل ملف CSS المطلوب إدراجه

  • ردّ الاتصال

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

isAudioMuted()

Chrome 62 والإصدارات الأحدث 
chrome.webviewTag.isAudioMuted(
  callback: function,
)

يطلب هذا الحقل معرفة ما إذا كان الصوت مكتومًا.

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (muted: boolean) => void

    • تم كتم الصوت

      قيمة منطقية

isSpatialNavigationEnabled()

Chrome 71 والإصدارات الأحدث 
chrome.webviewTag.isSpatialNavigationEnabled(
  callback: function,
)

يطلب هذا الإجراء معرفة ما إذا كان قد تم تفعيل ميزة التنقّل المكاني في webview.

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (enabled: boolean) => void

    • مفعّلة

      قيمة منطقية

isUserAgentOverridden()

chrome.webviewTag.isUserAgentOverridden()

يشير إلى ما إذا تم إلغاء سلسلة وكيل المستخدم webview بواسطة webviewTag.setUserAgentOverride أم لا.

loadDataWithBaseUrl()

chrome.webviewTag.loadDataWithBaseUrl(
  dataUrl: string,
  baseUrl: string,
  virtualUrl?: string,
)

تحمِّل عنوان URL للبيانات مع عنوان URL أساسي محدّد يُستخدَم للروابط النسبية. يمكن اختياريًا تقديم عنوان URL افتراضي ليظهر للمستخدم بدلاً من عنوان URL الخاص بالبيانات.

المعلمات

  • dataUrl

    سلسلة

    عنوان URL للبيانات المطلوب تحميلها.

  • baseUrl

    سلسلة

    عنوان URL الأساسي الذي سيتم استخدامه للروابط النسبية.

  • virtualUrl

    سلسلة اختيارية

    عنوان URL الذي سيتم عرضه للمستخدم (في شريط العناوين).

print()

chrome.webviewTag.print()

تُطبِّع محتوى webview. ويعادل ذلك استدعاء دالة الطباعة البرمجية من webview نفسها.

reload()

chrome.webviewTag.reload()

تؤدي هذه العملية إلى إعادة تحميل الصفحة الحالية من المستوى الأعلى.

removeContentScripts()

Chrome 44 والإصدارات الأحدث 
chrome.webviewTag.removeContentScripts(
  scriptNameList?: string[],
)

تزيل نصوص المحتوى البرمجية من webview.

يزيل المثال التالي القاعدة "myRule" التي تمت إضافتها من قبل.

webview.removeContentScripts(['myRule']);

يمكنك إزالة جميع القواعد من خلال الاتصال على:

webview.removeContentScripts();

المعلمات

  • scriptNameList

    سلسلة اختيارية

    قائمة بأسماء نصوص المحتوى البرمجية التي ستتم إزالتها إذا كانت القائمة فارغة، ستتم إزالة جميع نصوص المحتوى البرمجية التي تمت إضافتها إلى webview.

setAudioMuted()

Chrome 62 والإصدارات الأحدث 
chrome.webviewTag.setAudioMuted(
  mute: boolean,
)

لضبط حالة كتم الصوت في العرض على الويب

المعلمات

  • كتم الصوت

    قيمة منطقية

    قيمة كتم الصوت

setSpatialNavigationEnabled()

Chrome 71 والإصدارات الأحدث 
chrome.webviewTag.setSpatialNavigationEnabled(
  enabled: boolean,
)

لضبط حالة التنقّل المكاني في webview

المعلمات

  • مفعّلة

    قيمة منطقية

    قيمة حالة التنقّل المكاني

setUserAgentOverride()

chrome.webviewTag.setUserAgentOverride(
  userAgent: string,
)

إلغاء سلسلة وكيل المستخدم المستخدَمة من قِبل webview لطلبات صفحات الضيف سيؤدي إلغاء الإعدادات إلى جعل قيم عنوان User-Agent Client Hint والقيم التي يعرضها navigator.userAgentData فارغة لطلبات الصفحات المخصّصة للضيوف التي يتم تطبيق هذا الإلغاء عليها.

المعلمات

  • userAgent

    سلسلة

    سلسلة وكيل المستخدم المطلوب استخدامها

setZoom()

chrome.webviewTag.setZoom(
  zoomFactor: number,
  callback?: function,
)

لتغيير نسبة تكبير الصفحة. يتم تحديد نطاق هذا التغيير واستمراريته حسب وضع التكبير/التصغير الحالي في webview (راجِع webviewTag.ZoomMode).

المعلمات

  • zoomFactor

    الرقم

    عامل التكبير أو التصغير الجديد.

  • ردّ الاتصال

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

setZoomMode()

Chrome 43 والإصدارات الأحدث 
chrome.webviewTag.setZoomMode(
  ZoomMode: ZoomMode,
  callback?: function,
)

لضبط وضع التكبير/التصغير في webview

المعلمات

  • ZoomMode

    ZoomMode

    تحدِّد كيفية التعامل مع التصغير/التكبير في webview.

  • ردّ الاتصال

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

stop()

chrome.webviewTag.stop()

يوقف تحميل webview التنقّل الحالي إذا كان قيد التقدّم.

stopFinding()

chrome.webviewTag.stopFinding(
  action?: "clear" 
  | "keep" 
  | "activate" 
 ,
)

يُنهي هذا الخيار جلسة البحث الحالية (ويزيل كل علامات التمييز) ويُلغي جميع طلبات البحث قيد التقدّم.

المعلمات

  • إجراء

    "clear"
     | "keep"
     | "activate"
     اختياري

    لتحديد الإجراء الذي يجب اتّخاذه بشأن المطابقة النشطة بعد انتهاء جلسة البحث سيؤدي الرمز clear إلى محو التمييز على المطابقة النشطة، وسيؤدي الرمز keep إلى إبقاء المطابقة النشطة مميّزة، وسيؤدي الرمز activate إلى إبقاء المطابقة النشطة مميّزة ومحاكاة نقرة المستخدم على هذه المطابقة. الإجراء التلقائي هو keep.

terminate()

chrome.webviewTag.terminate()

إنهاء عملية عرض صفحة الويب للضيف بشكل قسري قد يؤثر ذلك في علامات webview متعددة في التطبيق الحالي إذا كانت تشترك في العملية نفسها، ولكنّه لن يؤثر في علامات webview في التطبيقات الأخرى.

الفعاليات

close

chrome.webviewTag.close.addListener(
  callback: function,
)

يتم تشغيله عندما تحاول نافذة الضيف إغلاق نفسها.

ينتقل الرمز البرمجي التالي من webview إلى about:blank عندما يحاول الضيف إغلاق نفسه.

webview.addEventListener('close', function() {
  webview.src = 'about:blank';
});

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    () => void

consolemessage

chrome.webviewTag.consolemessage.addListener(
  callback: function,
)

يتم تشغيله عندما تسجِّل نافذة الضيف رسالة وحدة تحكّم.

يعيد المثال التالي للرمز البرمجي توجيه جميع رسائل السجلّ إلى وحدة تحكّم مُضمِّن المحتوى بدون النظر إلى مستوى السجلّ أو السمات الأخرى.

webview.addEventListener('consolemessage', function(e) {
  console.log('Guest page logged a message: ', e.message);
});

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (level: number, message: string, line: number, sourceId: string) => void

    • المستوى

      الرقم

    • رسالة

      سلسلة

    • سطر

      الرقم

    • sourceId

      سلسلة

contentload

chrome.webviewTag.contentload.addListener(
  callback: function,
)

يتمّ تشغيله عندما تنشئ نافذة الضيف حدث load، أي عند تحميل مستند جديد. ولا يشمل ذلك التنقّل في الصفحة ضمن المستند الحالي أو عمليات تحميل الموارد غير المتزامنة.

يُعدّل مثال الرمز البرمجي التالي حجم الخط التلقائي لعنصر body الخاص بالضيف بعد تحميل الصفحة:

webview.addEventListener('contentload', function() {
  webview.executeScript({ code: 'document.body.style.fontSize = "42px"' });
});

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    () => void

dialog

chrome.webviewTag.dialog.addListener(
  callback: function,
)

يتم تشغيله عندما تحاول نافذة الضيف فتح مربّع حوار مشروط من خلال window.alert أو window.confirm أو window.prompt.

سيؤدي التعامل مع هذا الحدث إلى حظر عملية الضيف إلى أن يعود كل مستمع للحدث أو يصبح كائن dialog غير قابل للوصول إليه (إذا تم استدعاء preventDefault()).

السلوك التلقائي هو إلغاء مربّع الحوار.

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (messageType: "alert" 
      | "confirm" 
      | "prompt" 
     , messageText: string, dialog: DialogController) => void

    • messageType

      "alert"
       | "confirm"
       | "prompt"

    • messageText

      سلسلة

    • الاكتشاف الإلكتروني

      DialogController

exit

chrome.webviewTag.exit.addListener(
  callback: function,
)

يتم تشغيله عند إنهاء عملية عرض محتوى الويب للضيف.

سيعرض مثال الرمز البرمجي التالي رسالة وداع كلما تعطّلت صفحة الضيف:

webview.addEventListener('exit', function(e) {
  if (e.reason === 'crash') {
    webview.src = 'data:text/plain,Goodbye, world!';
  }
});

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (processID: number, reason: "normal" 
      | "abnormal" 
      | "crash" 
      | "kill" 
     ) => void

    • processID

      الرقم

    • السبب

      "normal"
       | "abnormal"
       | "crash"
       | "kill"

findupdate

chrome.webviewTag.findupdate.addListener(
  callback: function,
)

يتم تشغيله عندما تتوفّر نتائج بحث جديدة لطلب بحث نشط. وقد يحدث ذلك عدة مرات لطلب بحث واحد عند العثور على المطابقات.

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (searchText: string, numberOfMatches: number, activeMatchOrdinal: number, selectionRect: SelectionRect, canceled: boolean, finalUpdate: string) => void

    • searchText

      سلسلة

    • numberOfMatches

      الرقم

    • activeMatchOrdinal

      الرقم

    • selectionRect

      SelectionRect

    • مُلغاة

      قيمة منطقية

    • finalUpdate

      سلسلة

loadabort

chrome.webviewTag.loadabort.addListener(
  callback: function,
)

يتم تشغيله عند إلغاء تحميل على مستوى أعلى بدون تأكيده. ستتم طباعة رسالة خطأ في وحدة التحكّم ما لم يتم منع الحدث تلقائيًا.

ملاحظة: عند إلغاء تحميل أحد الموارد، سيتبع حدث loadabort في النهاية حدث loadstop، حتى إذا تم إلغاء جميع عمليات التحميل المُلتزَم بها منذ آخر حدث loadstop (إن وُجد).

ملاحظة: عند إيقاف تحميل عنوان URL عن التطبيق أو عنوان URL لملف JavaScript، سيتم تشغيل loadabort، ثم سيتم توجيه webview إلى about:blank.

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (url: string, isTopLevel: boolean, code: number, reason: "ERR_ABORTED" 
      | "ERR_INVALID_URL" 
      | "ERR_DISALLOWED_URL_SCHEME" 
      | "ERR_BLOCKED_BY_CLIENT" 
      | "ERR_ADDRESS_UNREACHABLE" 
      | "ERR_EMPTY_RESPONSE" 
      | "ERR_FILE_NOT_FOUND" 
      | "ERR_UNKNOWN_URL_SCHEME" 
     ) => void

    • url

      سلسلة

    • isTopLevel

      قيمة منطقية

    • رمز

      الرقم

    • السبب

      "ERR_ABORTED"
       | "ERR_INVALID_URL"
       | "ERR_DISALLOWED_URL_SCHEME"
       | "ERR_BLOCKED_BY_CLIENT"
       | "ERR_ADDRESS_UNREACHABLE"
       | "ERR_EMPTY_RESPONSE"
       | "ERR_FILE_NOT_FOUND"
       | "ERR_UNKNOWN_URL_SCHEME"

loadcommit

chrome.webviewTag.loadcommit.addListener(
  callback: function,
)

يتم تشغيله عند اكتمال عملية التحميل. ويشمل ذلك التنقّل داخل المستند الحالي بالإضافة إلى عمليات التحميل على مستوى المستند الفرعي، ولكن لا يشمل عمليات تحميل الموارد غير المتزامنة.

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (url: string, isTopLevel: boolean) => void

    • url

      سلسلة

    • isTopLevel

      قيمة منطقية

loadredirect

chrome.webviewTag.loadredirect.addListener(
  callback: function,
)

يتم تشغيله عندما تتم إعادة توجيه طلب تحميل على مستوى أعلى إلى عنوان URL مختلف.

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (oldUrl: string, newUrl: string, isTopLevel: boolean) => void

    • oldUrl

      سلسلة

    • newUrl

      سلسلة

    • isTopLevel

      قيمة منطقية

loadstart

chrome.webviewTag.loadstart.addListener(
  callback: function,
)

يتم تشغيله عند بدء عملية تحميل.

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (url: string, isTopLevel: boolean) => void

    • url

      سلسلة

    • isTopLevel

      قيمة منطقية

loadstop

chrome.webviewTag.loadstop.addListener(
  callback: function,
)

يتم تشغيله عند اكتمال جميع عمليات التحميل على مستوى الإطار في صفحة الضيف (بما في ذلك جميع إطاراتها الفرعية). ويشمل ذلك التنقّل داخل المستند الحالي بالإضافة إلى عمليات التحميل على مستوى المستند الفرعي، ولكن لا يشمل عمليات تحميل الموارد غير المتزامنة. يتم تشغيل هذا الحدث في كل مرة ينتقل فيها عدد عمليات التحميل على مستوى المستند من واحد (أو أكثر) إلى صفر. على سبيل المثال، إذا كانت الصفحة قد انتهت من التحميل (أي loadstop تمّ تفعيله مرّة واحدة) ينشئ ملف iframe جديدًا يحمّل صفحة، ثمّ سيتمّ تفعيل loadstop ثانٍ عند اكتمال تحميل صفحة iframe. ويُلاحظ هذا النمط عادةً على الصفحات التي تحمّل الإعلانات.

ملاحظة: عند إلغاء عملية تحميل مُكتملة، سيتبع حدث loadstop في النهاية حدث loadabort، حتى إذا تم إلغاء جميع عمليات التحميل المكتملة منذ آخر حدث loadstop (إن وُجد).

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    () => void

newwindow

chrome.webviewTag.newwindow.addListener(
  callback: function,
)

يتم تشغيله عندما تحاول صفحة الضيف فتح نافذة متصفّح جديدة.

سيؤدي مثال الرمز البرمجي التالي إلى إنشاء webview جديد والتنقّل فيه في أداة التضمين لكل نافذة جديدة مطلوبة:

webview.addEventListener('newwindow', function(e) {
  var newWebview = document.createElement('webview');
  document.body.appendChild(newWebview);
  e.window.attach(newWebview);
});

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (window: NewWindow, targetUrl: string, initialWidth: number, initialHeight: number, name: string, windowOpenDisposition: "ignore" 
      | "save_to_disk" 
      | "current_tab" 
      | "new_background_tab" 
      | "new_foreground_tab" 
      | "new_window" 
      | "new_popup" 
     ) => void

    • نافذة

      NewWindow

    • targetUrl

      سلسلة

    • initialWidth

      الرقم

    • initialHeight

      الرقم

    • الاسم

      سلسلة

    • windowOpenDisposition

      "ignore"
       | "save_to_disk"
       | "current_tab"
       | "new_background_tab"
       | "new_foreground_tab"
       | "new_window"
       | "new_popup"

permissionrequest

chrome.webviewTag.permissionrequest.addListener(
  callback: function,
)

يتم تشغيل هذا الإجراء عندما تحتاج صفحة الضيف إلى طلب إذن خاص من القائم بالضمين.

سيمنح المثال التالي للرمز البرمجي صفحة الضيف إذن الوصول إلى واجهة برمجة التطبيقات webkitGetUserMedia. يُرجى العِلم أنّ التطبيق الذي يستخدم هذا المثال على الرمز البرمجي يجب أن يحدِّد بنفسه أذونات بيان audioCapture و/أو videoCapture:

webview.addEventListener('permissionrequest', function(e) {
  if (e.permission === 'media') {
    e.request.allow();
  }
});

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (permission: "media" 
      | "geolocation" 
      | "pointerLock" 
      | "download" 
      | "loadplugin" 
      | "filesystem" 
      | "fullscreen" 
      | "hid" 
     , request: object) => void

    • الإذن

      "media"
       | "geolocation"
       | "pointerLock"
       | "download"
       | "loadplugin"
       | "filesystem"
       | "fullscreen"
       | "hid"

    • طلب

      عنصر

responsive

chrome.webviewTag.responsive.addListener(
  callback: function,
)

يتم تشغيله عندما تصبح عملية عرض محتوى الويب للضيف سريعة الاستجابة مرة أخرى بعد أن كانت بطيئة.

سيؤدي مثال الرمز البرمجي التالي إلى تمويه عنصر webview أو إظهاره عندما يصبح متجاوبًا أو غير متجاوب:

webview.style.webkitTransition = 'opacity 250ms';
webview.addEventListener('unresponsive', function() {
  webview.style.opacity = '0.5';
});
webview.addEventListener('responsive', function() {
  webview.style.opacity = '1';
});

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (processID: number) => void

    • processID

      الرقم

sizechanged

chrome.webviewTag.sizechanged.addListener(
  callback: function,
)

يتم تشغيله عند تغيير حجم محتوى الويب المضمّن من خلال autosize. لا يتم تشغيلها إلا إذا كان الخيار autosize مفعّلاً.

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void

    • oldWidth

      الرقم

    • oldHeight

      الرقم

    • newWidth

      الرقم

    • newHeight

      الرقم

unresponsive

chrome.webviewTag.unresponsive.addListener(
  callback: function,
)

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

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (processID: number) => void

    • processID

      الرقم

zoomchange

chrome.webviewTag.zoomchange.addListener(
  callback: function,
)

يتم تشغيله عند تغيير مستوى تكبير/تصغير الصفحة.

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (oldZoomFactor: number, newZoomFactor: number) => void

    • oldZoomFactor

      الرقم

    • newZoomFactor

      الرقم