chrome.webviewTag

الوصف

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

الأذونات

webview

الأنواع

ClearDataOptions

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

أماكن إقامة

  • منذ

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

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

ClearDataTypeSet

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

أماكن إقامة

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

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

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

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

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

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

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

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

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

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

  • fileSystems

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

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

  • indexedDB

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

    المواقع الإلكترونية البيانات المفهرَسة لقاعدة البيانات

  • localStorage

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

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

  • persistentCookies

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

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

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

  • sessionCookies

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

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

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

  • webSQL

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

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

ContentScriptDetails

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

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

أماكن إقامة

  • all_frames

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

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

  • css

    InjectionItems اختياري

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

  • exclude_globs

    string[] اختيارية

    يتم تطبيقها بعد المطابقات لاستبعاد عناوين URL التي تتطابق مع هذه الكرة الأرضية. مخصصة لمحاكاة الكلمة الرئيسية @exclusion Greasemonkey.

  • exclude_matches

    string[] اختيارية

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

  • include_globs

    string[] اختيارية

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

  • JavaScript

    InjectionItems اختياري

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

  • match_about_blank

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

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

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

    سلسلة[]

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

  • الاسم

    سلسلة

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

  • run_at

    RunAt اختياري

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

ContentWindow

مؤشر المراسلة إلى نافذة ضيف

أماكن إقامة

  • postMessage

    فراغ

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

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

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

    تبدو دالة postMessage كما يلي: 

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

    • رسالة

      أي واحد

      كائن الرسالة المطلوب إرساله إلى المدعو

    • targetOrigin

      سلسلة

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

ContextMenuCreateProperties

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

أماكن إقامة

  • تم التحديد

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

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

  • السياقات

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

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

  • documentUrlPatterns

    string[] اختيارية

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

  • مفعّلة

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

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

  • id

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

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

  • parentId

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

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

  • targetUrlPatterns

    string[] اختيارية

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

  • title

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

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

  • كتابة

    ItemType اختياري

    نوع عنصر القائمة. القيم التلقائية على "عادية" إذا لم يتم تحديدها.

  • onclick

    null اختياري

    دالة سيتم طلبها مرة أخرى عند النقر على عنصر القائمة.

    تبدو دالة onclick كما يلي: 

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

    • معلومات

      OnClickData

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

ContextMenus

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

أماكن إقامة

  • onShow

    الحدث <functionuffful>

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

    تبدو دالة onShow.addListener كما يلي: 

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

    • رد الاتصال

      دالة

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

      (event: object) => void

      • event

        كائن

        • preventDefault

          فراغ

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

          تبدو دالة preventDefault كما يلي: 

          () => {...}

  • إنشاء

    فراغ

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

    تبدو دالة create كما يلي: 

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

    • createProperties

      كائن

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

    • رد الاتصال

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

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

      () => void

    • returns

      string | الرقم

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

  • إزالة

    فراغ

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

    تبدو دالة remove كما يلي: 

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

    • menuItemId

      string | الرقم

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

    • رد الاتصال

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

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

      () => void

  • إزالة الكل

    فراغ

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

    تبدو دالة removeAll كما يلي: 

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

    • رد الاتصال

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

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

      () => void

  • تحديث

    فراغ

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

    تبدو دالة update كما يلي: 

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

    • id

      string | الرقم

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

    • updateProperties

      كائن

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

    • رد الاتصال

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

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

      () => void

ContextMenuUpdateProperties

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

أماكن إقامة

  • تم التحديد

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

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

  • السياقات

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

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

  • documentUrlPatterns

    string[] اختيارية

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

  • مفعّلة

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

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

  • parentId

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

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

  • targetUrlPatterns

    string[] اختيارية

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

  • title

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

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

  • كتابة

    ItemType اختياري

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

  • onclick

    null اختياري

    دالة سيتم طلبها مرة أخرى عند النقر على عنصر القائمة.

    تبدو دالة onclick كما يلي: 

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

    • معلومات

      OnClickData

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

ContextType

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

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

Enum

"الكل"

"الصفحة"

"الإطار"

"الاختيار"

"الرابط"

"تعديل"

"صورة"

"الفيديو"

"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

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

نوع عنصر 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

  • سماح

    فراغ

    عليك السماح بطلب الإذن.

    تبدو دالة allow كما يلي: 

    () => {...}

  • منع

    فراغ

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

    تبدو دالة deny كما يلي: 

    () => {...}

InjectDetails

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

أماكن إقامة

  • رمز

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

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

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

  • ملف

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

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

InjectionItems

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

نوع عنصر الإدخال: رمز أو مجموعة ملفات

أماكن إقامة

  • رمز

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

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

  • ملفات

    string[] اختيارية

    قائمة ملفات 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

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

واجهة توفّر إمكانية الوصول إلى أحداث 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

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

تحدِّد هذه السياسة كيفية التعامل مع التكبير أو التصغير في webview.

Enum

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

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

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

أماكن إقامة

contentWindow

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

النوع

ContentWindow

contextMenus

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

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

النوع

ContextMenus

request

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

النوع

WebRequestEventInterface

الطُرق

addContentScripts()

الإصدار 44 من Chrome أو الإصدارات الأحدث 
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).

المعلمات

  • رد الاتصال

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

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

    تظهر المَعلمة 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,
)

يلتقط المنطقة المرئية من 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).

المعلمات

  • رد الاتصال

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

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

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

    (success: boolean) => void

    • النجاح

      منطقي

      يشير إلى ما إذا كان التنقّل قد تم بنجاح أم لا.

getAudioState()

الإصدار 62 من Chrome أو الإصدارات الأحدث 
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()

الإصدار 43 من Chrome أو الإصدارات الأحدث 
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()

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

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

المعلمات

  • رد الاتصال

    دالة

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

    (muted: boolean) => void

    • تم كتم الصوت

      منطقي

isSpatialNavigationEnabled()

الإصدار 71 من Chrome أو الإصدارات الأحدث 
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()

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

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

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

webview.removeContentScripts(['myRule']);

يمكنك إزالة جميع القواعد من خلال طلب ما يلي:

webview.removeContentScripts();

المعلمات

  • scriptNameList

    string[] اختيارية

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

setAudioMuted()

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

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

المعلمات

  • كتم الصوت

    منطقي

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

setSpatialNavigationEnabled()

الإصدار 71 من Chrome أو الإصدارات الأحدث 
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()

الإصدار 43 من Chrome أو الإصدارات الأحدث 
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" 
 ,
)

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

المعلمات

  • إجراء

    "محو"
     | "keep"
     | "تفعيل"
     اختياري

    لتحديد الإجراء المطلوب اتخاذه مع المطابقة النشطة بعد انتهاء جلسة البحث. سيمحو 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

      "تنبيه"
       | "تأكيد"
       | "الطلب"

    • 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

      الرقم

    • السبب

      "عادي"
       | "غير طبيعي"
       | "تعطُّل"
       | "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"
       | &quot;ERR_INVALID_URL&quot;
       | &quot;ERR_DISALLOWED_URL_SCHEME&quot;
       | &quot;ERR_BLOCKED_BY_CLIENT&quot;
       | "ERR_ADDRESS_UNREACHABLE"
       | &quot;ERR_EMPTY_RESPONSE&quot;
       | &quot;ERR_FILE_NOT_FOUND&quot;
       | &quot;ERR_UNKNOWN_URL_SCHEME&quot;

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

      "تجاهل"
       | "save_to_disk"
       | "current_tab"
       | &quot;new_background_tab&quot;
       | "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"
       | "الموقع الجغرافي"
       | "pointerLock"
       | "تنزيل"
       | "load وصلت إلى
       | "filesystem"
       | ملء الشاشة
       | "إخفاء"

    • طلب

      كائن

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

      الرقم