chrome.webviewTag

الوصف

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

الأذونات

webview

الأنواع

ClearDataOptions

خيارات تحدّد البيانات التي يجب محوها بحلول clearData.

أماكن إقامة

  • منذ

    الرقم اختياري

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

ClearDataTypeSet

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

أماكن إقامة

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

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

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

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

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

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

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

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

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

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

  • fileSystems

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

    أنظمة ملفات مواقع الويب.

  • indexedDB

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

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

  • localStorage

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

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

  • persistentCookies

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

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

    هي ملفات تعريف الارتباط الدائمة للقسم.

  • sessionCookies

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

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

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

  • 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 التي تتطابق مع هذه الكلمة الرئيسية. مخصصة لمحاكاة الكلمة الرئيسية @DELETE Greaseاصطحاب.

  • exclude_matches

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

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

  • include_globs

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

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

  • js

    InjectionItems اختيارية

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

  • match_about_blank

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

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

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

    سلسلة[]

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

  • اسم

    سلسلة

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

  • run_at

    RunAt اختيارية

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

ContentWindow

مقبض المراسلة إلى نافذة ضيف.

أماكن إقامة

  • postMessage

    void

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

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

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

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

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

    • رسالة

      أي فلتر

      سيتم إرسال عنصر الرسالة إلى المدعو.

    • targetOrigin

      سلسلة

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

ContextMenuCreateProperties

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

أماكن إقامة

  • تم وضع علامة في المربّع

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

    الحالة الأولية لمربّع اختيار أو عنصر اختيار: يكون صحيح للخيار "محدد" و"خطأ" مع العناصر غير المحددة. يمكن اختيار عنصر راديو واحد فقط في كل مرة ضمن مجموعة معيّنة من عناصر الاختيار.

  • السياقات

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

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

  • documentUrlPatterns

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

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

  • مفعّلة

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

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

  • id

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

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

  • parentId

    string|number اختياري

    معرّف عنصر القائمة الرئيسي، ويؤدي هذا إلى جعل العنصر ثانويًا لعنصر تمت إضافته سابقًا.

  • targetUrlPatterns

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

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

  • title

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

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

  • كتابة

    ItemType اختيارية

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

  • onclick

    باطل اختياري

    يشير ذلك المصطلح إلى دالة يتم استدعاءها عند النقر على عنصر في القائمة.

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

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

    • معلومات

      OnClickData

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

ContextMenus

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

أماكن إقامة

  • onShow

    الحدث<functionvitvit>

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

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

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

    • معاودة الاتصال

      الوظيفة

      تبدو معلَمة callback على النحو التالي: 

      (event: object)=>void

      • حدث

        عنصر

        • preventDefault

          void

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

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

          ()=> {...}

  • إنشاء

    void

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

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

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

    • createProperties

      عنصر

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

    • معاودة الاتصال

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

      تبدو معلَمة callback على النحو التالي: 

      ()=>void

    • returns

      string|number

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

  • إزالة

    void

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

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

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

    • menuItemId

      string|number

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

    • معاودة الاتصال

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

      تبدو معلَمة callback على النحو التالي: 

      ()=>void

  • removeAll

    void

    يؤدي هذا الإجراء إلى إزالة كل عناصر قائمة السياق التي تمّت إضافتها إلى بطاقة "webview".

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

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

    • معاودة الاتصال

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

      تبدو معلَمة callback على النحو التالي: 

      ()=>void

  • تحديث

    void

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

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

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

    • id

      string|number

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

    • updateProperties

      عنصر

      السمات المطلوب تعديلها تقبل القيم نفسها مثل دالة الإنشاء.

    • معاودة الاتصال

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

      تبدو معلَمة callback على النحو التالي: 

      ()=>void

ContextMenuUpdateProperties

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

أماكن إقامة

  • تم وضع علامة في المربّع

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

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

  • السياقات

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

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

  • documentUrlPatterns

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

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

  • مفعّلة

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

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

  • parentId

    string|number اختياري

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

  • targetUrlPatterns

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

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

  • title

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

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

  • كتابة

    ItemType اختيارية

    نوع صنف في القائمة

  • onclick

    باطل اختياري

    يشير ذلك المصطلح إلى دالة يتم استدعاءها عند النقر على عنصر في القائمة.

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

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

    • معلومات

      OnClickData

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

ContextType

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

السياقات المختلفة التي يمكن أن تظهر فيها القائمة. ويكون تحديد "الكل" مساويًا لتركيبة كل السياقات الأخرى.

التعداد

"audio"

DialogController

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

أماكن إقامة

  • إلغاء

    void

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

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

    ()=> {...}

  • حسنًا

    void

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

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

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

    • رد

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

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

DownloadPermissionRequest

تمثّل هذه السمة نوع عنصر request الذي يصاحب حدث DOM download permissionrequest.

أماكن إقامة

  • requestMethod

    سلسلة

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

  • url

    سلسلة

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

  • سماح

    void

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

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

    ()=> {...}

  • رفض

    void

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

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

    ()=> {...}

FileSystemPermissionRequest

تمثّل هذه السمة نوع عنصر request الذي يصاحب حدث DOM filesystem permissionrequest.

أماكن إقامة

  • url

    سلسلة

    تمثّل هذه السمة عنوان URL للإطار الذي يطلب الوصول إلى نظام الملفات المحلي.

  • سماح

    void

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

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

    ()=> {...}

  • رفض

    void

    رفض طلب الإذن

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

    ()=> {...}

FindCallbackResults

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

أماكن إقامة

  • activeMatchOrdinal

    الرقم

    تمثّل هذه السمة العدد الترتيبي للمطابقة الحالية.

  • مُلغاة

    boolean

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

  • numberOfMatches

    الرقم

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

  • selectionRect

    SelectionRect

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

FindOptions

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

أماكن إقامة

  • إلى الخلف

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

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

  • matchCase

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

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

FullscreenPermissionRequest

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

تمثّل هذه السمة نوع عنصر request الذي يصاحب حدث DOM fullscreen permissionrequest.

أماكن إقامة

  • الأصل

    سلسلة

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

  • سماح

    void

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

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

    ()=> {...}

  • رفض

    void

    رفض طلب الإذن

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

    ()=> {...}

GeolocationPermissionRequest

تمثّل هذه السمة نوع عنصر request الذي يصاحب حدث DOM geolocation permissionrequest.

أماكن إقامة

  • url

    سلسلة

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

  • سماح

    void

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

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

    ()=> {...}

  • رفض

    void

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

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

    ()=> {...}

HidPermissionRequest

في انتظار المراجعة

تمثّل هذه السمة نوع عنصر request الذي يصاحب حدث DOM hid permissionrequest.

أماكن إقامة

  • url

    سلسلة

    تمثّل هذه السمة عنوان URL للإطار الذي يطلب الوصول إلى واجهة برمجة تطبيقات HID.

  • سماح

    void

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

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

    ()=> {...}

  • رفض

    void

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

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

    ()=> {...}

InjectDetails

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

أماكن إقامة

  • رمز

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

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

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

  • ملف

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

    ملف JavaScript أو CSS المطلوب إدخاله.

InjectionItems

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

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

أماكن إقامة

  • رمز

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

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

  • ملف

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

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

LoadPluginPermissionRequest

تمثّل هذه السمة نوع عنصر request الذي يصاحب حدث DOM loadplugin permissionrequest.

أماكن إقامة

  • معرّف

    سلسلة

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

  • اسم

    سلسلة

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

  • سماح

    void

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

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

    ()=> {...}

  • رفض

    void

    رفض طلب الإذن

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

    ()=> {...}

MediaPermissionRequest

تمثّل هذه السمة نوع عنصر request الذي يصاحب حدث DOM media permissionrequest.

أماكن إقامة

  • url

    سلسلة

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

  • سماح

    void

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

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

    ()=> {...}

  • رفض

    void

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

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

    ()=> {...}

NewWindow

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

أماكن إقامة

  • إرفاق

    void

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

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

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

    • webview

      عنصر

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

  • تجاهل

    void

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

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

    ()=> {...}

PointerLockPermissionRequest

تمثّل هذه السمة نوع عنصر request الذي يصاحب حدث DOM pointerLock permissionrequest.

أماكن إقامة

  • lastUnlockedBySelf

    boolean

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

  • url

    سلسلة

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

  • userGesture

    boolean

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

  • سماح

    void

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

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

    ()=> {...}

  • رفض

    void

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

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

    ()=> {...}

SelectionRect

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

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

أماكن إقامة

  • الطول

    الرقم

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

  • لليسار

    الرقم

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

  • النصف العلوي

    الرقم

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

  • العرض

    الرقم

    عرض المستطيل

WebRequestEventInterface

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

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

لتوضيح مدى اختلاف الاستخدام عن واجهة برمجة التطبيقات 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.

التعداد

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

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

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

أماكن إقامة

contentWindow

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

النوع

ContentWindow

contextMenus

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

هذه الواجهة تشبه واجهة برمجة التطبيقات ContextLists في 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

    • النجاح

      boolean

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

canGoBack()

chrome.webviewTag.canGoBack()

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

المرتجعات

  • boolean

canGoForward()

chrome.webviewTag.canGoForward()

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

المرتجعات

  • boolean

captureVisibleRegion()

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

لتسجيل المنطقة المرئية من WebView.

المَعلمات

  • الخيارات

    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

    • النجاح

      boolean

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

getAudioState()

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

حالة الصوت لطلبات البحث

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

    (audible: boolean)=>void

    • تطبيق audible

      boolean

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

    • النجاح

      boolean

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

insertCSS()

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

إدخال CSS في صفحة الضيف

المَعلمات

  • التفاصيل

    InjectDetails

    تفاصيل خدمة مقارنة الأسعار (CSS) المطلوب إدراجها.

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

isAudioMuted()

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

الاستعلام عمّا إذا كان الصوت مكتومًا أم لا

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

    (muted: boolean)=>void

    • تم كتم الصوت

      boolean

isSpatialNavigationEnabled()

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

طلبات البحث عن تفعيل التنقّل المكاني في WebView

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

    (enabled: boolean)=>void

    • مفعّلة

      boolean

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()

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

لضبط حالة كتم الصوت في WebView.

المَعلمات

  • كتم الصوت

    boolean

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

setSpatialNavigationEnabled()

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

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

المَعلمات

  • مفعّلة

    boolean

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

setUserAgentOverride()

chrome.webviewTag.setUserAgentOverride(
  userAgent: string,
)

تجاهُل سلسلة وكيل المستخدم المستخدمة في webview لطلبات صفحات الضيوف. وسيؤدي الإلغاء إلى جعل قيم عنوان "تلميح عميل وكيل المستخدم" والقيم التي يعرضها 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 على تمييز المطابقة النشطة وسيحاكي نقرة المستخدم على هذه المطابقة. الإجراء التلقائي هو 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

    • مُلغاة

      boolean

    • 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

      boolean

    • رمز

      الرقم

    • السبب

      "ERR_ABORTED"
      | "ERR_PROGRESS_URL"
      |"ERR_DISALLOWED_URL_SCHEME"
      |"ERR_BLOCKED_BY_CLIENT"
      |"ERR_ADDRESS_UNREACHABLE"
      |"ERR_EMPTY_RESPONSE"
      |"ERR_EMPTY_RESPONSE"
      ""

loadcommit

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

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

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

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

    • url

      سلسلة

    • isTopLevel

      boolean

loadredirect

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

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

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

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

    • oldUrl

      سلسلة

    • newUrl

      سلسلة

    • isTopLevel

      boolean

loadstart

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

يتم تنشيطها عند بدء التحميل.

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

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

    • url

      سلسلة

    • isTopLevel

      boolean

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

    • permission

      "media"
      |"geolocation"
      |"pointerLock"
      |"download"
      |"loadextension"
      |"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

      الرقم