تشكّل هذه الصفحة جزءًا من المستندات المتعلّقة بالنظام الأساسي لتطبيقات Chrome الذي تم إيقافه في عام 2020. سيظل هذا الإصدار متاحًا لعملاء Enterprise وEducation على نظام التشغيل ChromeOS حتى كانون الثاني (يناير) 2025 على الأقل. اطّلِع على مزيد من المعلومات عن نقل بيانات تطبيقك.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

chrome.webviewTag

الوصف

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

الأذونات

webview

الأنواع

ClearDataOptions

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

الخصائص

منذ

number اختياري

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

ClearDataTypeSet

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

الخصائص

appcache

boolean اختياري

ملفات appcache الخاصة بالمواقع الإلكترونية
ذاكرة التخزين المؤقت

boolean اختياري

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

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

boolean اختياري

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

boolean اختياري

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

boolean اختياري

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

boolean اختياري

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

boolean اختياري

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

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

boolean اختياري

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

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

boolean اختياري

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

ContentScriptDetails

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

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

الخصائص

all_frames

boolean اختياري

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

‫InjectionItems اختيارية

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

string[] اختياري

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

string[] اختياري

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

string[] اختياري

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

‫InjectionItems اختيارية

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

boolean اختياري

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

string[]

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

سلسلة

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

الخصائص

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

boolean اختياري

الحالة الأولية لمربّع الاختيار أو عنصر زر الاختيار: تكون القيمة صحيحة إذا تم تحديد العنصر، وتكون القيمة خاطئة إذا لم يتم تحديده. يمكن اختيار عنصر راديو واحد فقط في كل مرة في مجموعة معيّنة من عناصر الراديو.
السياقات

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

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

string[] اختياري

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

boolean اختياري

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

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

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

string | number اختياري

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

string[] اختياري

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

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

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

ItemType اختيارية

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

void اختياري

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

تبدو الدالة onclick على النحو التالي:
```
(info: OnClickData) => {...}
```
- معلومات
  
  OnClickData
  
  معلومات حول العنصر الذي تم النقر عليه والسياق الذي حدثت فيه النقرة

ContextMenus

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

الخصائص

onShow

Event<functionvoidvoid>

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

تبدو الدالة onShow.addListener على النحو التالي:
```
(callback: function) => {...}
```
- callback
  
  دالة
  
  تظهر المَعلمة callback على النحو التالي:
```
(event: object) => void
```
  - حدث
    
    عنصر
    
    preventDefault
    
    void
    
    يجب استدعاء هذه الطريقة لمنع عرض قائمة السياقات.
    
    تبدو الدالة preventDefault على النحو التالي:
    () => {...}
إنشاء

void

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

تبدو الدالة create على النحو التالي:
```
(createProperties: object, callback?: function) => {...}
```
- createProperties
  
  عنصر
  
  السمات المستخدَمة لإنشاء العنصر
- callback
  
  الدالة اختيارية
  
  تظهر المَعلمة callback على النحو التالي:
```
() => void
```
- returns
  سلسلة | رقم
  
  معرّف العنصر الذي تم إنشاؤه حديثًا.
إزالة

void

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

تبدو الدالة remove على النحو التالي:
```
(menuItemId: string | number, callback?: function) => {...}
```
- menuItemId
  
  سلسلة | رقم
  
  معرّف عنصر قائمة السياقات المطلوب إزالته.
- callback
  
  الدالة اختيارية
  
  تظهر المَعلمة callback على النحو التالي:
```
() => void
```
removeAll

void

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

تبدو الدالة removeAll على النحو التالي:
```
(callback?: function) => {...}
```
- callback
  
  الدالة اختيارية
  
  تظهر المَعلمة callback على النحو التالي:
```
() => void
```
تحديث

void

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

تبدو الدالة update على النحو التالي:
```
(id: string | number, updateProperties: object, callback?: function) => {...}
```
- id
  
  سلسلة | رقم
  
  معرّف السلعة المطلوب تعديلها.
- updateProperties
  
  عنصر
  
  الخصائص المطلوب تعديلها تقبل هذه السمة القيم نفسها التي تقبلها الدالة create.
- callback
  
  الدالة اختيارية
  
  تظهر المَعلمة callback على النحو التالي:
```
() => void
```

ContextMenuUpdateProperties

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

الخصائص

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

boolean اختياري

حالة مربّع الاختيار أو عنصر زر الاختيار: تكون القيمة صحيحة إذا تم تحديد العنصر، وتكون القيمة خاطئة إذا لم يتم تحديده. يمكن اختيار عنصر راديو واحد فقط في كل مرة في مجموعة معيّنة من عناصر الراديو.
السياقات

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

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

string[] اختياري

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

boolean اختياري

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

string | number اختياري

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

string[] اختياري

تشبه هذه السمة 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.

الخصائص

إلغاء

void

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

تبدو الدالة cancel على النحو التالي:
```
() => {...}
```
حسنًا

void

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

تبدو الدالة ok على النحو التالي:
```
(response?: string) => {...}
```
- رد
  
  سلسلة اختيارية
  
  سلسلة الردّ التي سيتم تقديمها إلى الضيف عند قبول مربّع حوار prompt.

DialogMessageType

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

نوع مربّع الحوار المشروط الذي طلبه الضيف.

Enum

"alert"

"confirm"

"prompt"

DownloadPermissionRequest

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

الخصائص

requestMethod

سلسلة

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

سلسلة

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

void

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

تبدو الدالة allow على النحو التالي:
```
() => {...}
```
رفض

void

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

تبدو الدالة deny على النحو التالي:
```
() => {...}
```

ExitReason

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

سلسلة تشير إلى سبب الخروج.

Enum

"normal"

"abnormal"

"crashed"

"killed"

"oom killed"

"oom"

"تعذّر التشغيل"

"integrity failure"

FileSystemPermissionRequest

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

الخصائص

url

سلسلة

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

void

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

تبدو الدالة allow على النحو التالي:
```
() => {...}
```
رفض

void

ارفض طلب الإذن.

تبدو الدالة deny على النحو التالي:
```
() => {...}
```

FindCallbackResults

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

الخصائص

activeMatchOrdinal

الرقم

الرقم الترتيبي للمباراة الحالية.
مُلغاة

قيمة منطقية

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

الرقم

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

SelectionRect

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

FindOptions

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

الخصائص

السابق

boolean اختياري

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

boolean اختياري

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

FullscreenPermissionRequest

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

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

الخصائص

الأصل

سلسلة

يشير هذا الحقل إلى مصدر الإطار داخل webview الذي بدأ طلب ملء الشاشة.
سماح

void

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

تبدو الدالة allow على النحو التالي:
```
() => {...}
```
رفض

void

ارفض طلب الإذن.

تبدو الدالة deny على النحو التالي:
```
() => {...}
```

GeolocationPermissionRequest

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

الخصائص

url

سلسلة

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

void

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

تبدو الدالة allow على النحو التالي:
```
() => {...}
```
رفض

void

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

تبدو الدالة deny على النحو التالي:
```
() => {...}
```

HidPermissionRequest

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

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

الخصائص

url

سلسلة

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

void

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

تبدو الدالة allow على النحو التالي:
```
() => {...}
```
رفض

void

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

تبدو الدالة deny على النحو التالي:
```
() => {...}
```

InjectDetails

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

الخصائص

رمز

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

رمز JavaScript أو CSS المطلوب إضافته

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

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

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

InjectionItems

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

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

الخصائص

رمز

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

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

string[] اختياري

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

LoadAbortReason

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

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

Enum

"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"

LoadPluginPermissionRequest

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

الخصائص

معرّف

سلسلة

سلسلة المعرّف الخاص بالإضافة
الاسم

سلسلة

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

void

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

تبدو الدالة allow على النحو التالي:
```
() => {...}
```
رفض

void

ارفض طلب الإذن.

تبدو الدالة deny على النحو التالي:
```
() => {...}
```

MediaPermissionRequest

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

الخصائص

url

سلسلة

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

void

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

تبدو الدالة allow على النحو التالي:
```
() => {...}
```
رفض

void

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

تبدو الدالة deny على النحو التالي:
```
() => {...}
```

NewWindow

واجهة مرتبطة بأحداث newwindow DOM.

الخصائص

إرفاق

void

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

تبدو الدالة attach على النحو التالي:
```
(webview: object) => {...}
```
- webview
  
  عنصر
  
  عنصر webview الذي يجب إرفاق الصفحة المستهدَفة به.
تجاهل

void

ألغِ طلب النافذة الجديدة.

تبدو الدالة discard على النحو التالي:
```
() => {...}
```

PermissionType

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

نوع الإذن المطلوب

Enum

"media"

"geolocation"

"pointerLock"

"download"

"loadplugin"

"filesystem"

"fullscreen"

"hid"

PointerLockPermissionRequest

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

الخصائص

lastUnlockedBySelf

قيمة منطقية

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

سلسلة

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

قيمة منطقية

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

void

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

تبدو الدالة allow على النحو التالي:
```
() => {...}
```
رفض

void

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

تبدو الدالة deny على النحو التالي:
```
() => {...}
```

SelectionRect

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

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

الخصائص

الطول

الرقم

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

الرقم

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

الرقم

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

الرقم

عرض المستطيل

StopFindingAction

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

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

Enum

"clear"

"keep"

"تفعيل"

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" على طريقة عرض الويب myWebview:

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

WindowOpenDisposition

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

الوضع المطلوب للنافذة الجديدة.

Enum

"ignore"

"save_to_disk"

"current_tab"

"new_background_tab"

"new_foreground_tab"

"new_window"

"new_popup"

ZoomMode

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

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

Enum

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

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

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

الخصائص

contentWindow

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

النوع

ContentWindow

contextMenus

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

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

النوع

ContextMenus

request

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

النوع

WebRequestEventInterface

الطُرق

addContentScripts()

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

chrome.webviewTag.addContentScripts(
  contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
): void

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

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

المعلمات

contentScriptList

[ContentScriptDetails, ...ContentScriptDetails[]]

تفاصيل نصوص المحتوى البرمجية التي ستتم إضافتها

back()

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

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

المعلمات

callback

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

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

تظهر المَعلمة callback على النحو التالي:
```
(success: boolean) => void
```
- النجاح
  
  قيمة منطقية
  
  تشير إلى ما إذا كان التنقّل ناجحًا.

canGoBack()

chrome.webviewTag.canGoBack(): boolean

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

المرتجعات

قيمة منطقية

canGoForward()

chrome.webviewTag.canGoForward(): boolean

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

المرتجعات

قيمة منطقية

captureVisibleRegion()

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

chrome.webviewTag.captureVisibleRegion(
  options?: ImageDetails,
  callback: function,
): void

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

المعلمات

الخيارات

‫ImageDetails اختيارية
callback

دالة

تظهر المَعلمة callback على النحو التالي:
```
(dataUrl: string) => void
```
- dataUrl
  
  سلسلة
  
  عنوان URL للبيانات يشفّر صورة للمنطقة المرئية من علامة التبويب التي تم التقاطها يمكن تعيينها للسمة "src" الخاصة بعنصر صورة HTML لعرضها.

clearData()

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

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

المعلمات

الخيارات

ClearDataOptions

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

ClearDataTypeSet

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

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

تظهر المَعلمة callback على النحو التالي:
```
() => void
```

executeScript()

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

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

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

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

المعلمات

التفاصيل

InjectDetails

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

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

تظهر المَعلمة callback على النحو التالي:
```
(result?: any[]) => void
```
- نتيجة
  
  any[] اختيارية
  
  نتيجة النص البرمجي في كل إطار تم إدراجه

find()

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

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

المعلمات

searchText

سلسلة

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

FindOptions اختياري

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

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

تظهر المَعلمة callback على النحو التالي:
```
(results?: FindCallbackResults) => void
```
- النتائج
  
  FindCallbackResults اختياري
  
  يحتوي على جميع نتائج طلب البحث. يمكن حذف results إذا لم يتم استخدامه في نص دالة رد الاتصال، مثلاً إذا تم استخدام دالة رد الاتصال فقط لمعرفة وقت اكتمال طلب البحث.

forward()

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

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

المعلمات

callback

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

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

تظهر المَعلمة callback على النحو التالي:
```
(success: boolean) => void
```
- النجاح
  
  قيمة منطقية
  
  تشير إلى ما إذا كان التنقّل ناجحًا.

getAudioState()

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

chrome.webviewTag.getAudioState(
  callback: function,
): void

يطلب هذا الإجراء حالة الصوت.

المعلمات

callback

دالة

تظهر المَعلمة callback على النحو التالي:
```
(audible: boolean) => void
```
- تطبيق audible
  
  قيمة منطقية

getProcessId()

chrome.webviewTag.getProcessId(): number

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

المرتجعات

الرقم

getUserAgent()

chrome.webviewTag.getUserAgent(): string

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

المرتجعات

سلسلة

getZoom()

chrome.webviewTag.getZoom(
  callback: function,
): void

تعرض هذه السمة عامل التكبير أو التصغير الحالي.

المعلمات

callback

دالة

تظهر المَعلمة callback على النحو التالي:
```
(zoomFactor: number) => void
```
- zoomFactor
  
  الرقم
  
  تمثّل هذه السمة عامل التكبير أو التصغير الحالي.

getZoomMode()

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

chrome.webviewTag.getZoomMode(
  callback: function,
): void

تعرض هذه السمة وضع التكبير الحالي.

المعلمات

callback

دالة

تظهر المَعلمة callback على النحو التالي:
```
(ZoomMode: ZoomMode) => void
```
- ZoomMode
  
  ZoomMode
  
  وضع التكبير أو التصغير الحالي webview

go()

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

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

المعلمات

relativeIndex

الرقم

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

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

تظهر المَعلمة callback على النحو التالي:
```
(success: boolean) => void
```
- النجاح
  
  قيمة منطقية
  
  تشير إلى ما إذا كان التنقّل ناجحًا.

insertCSS()

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

يتيح هذا الإذن إدخال صفحات الأنماط المتتالية (CSS) في صفحة الضيف.

المعلمات

التفاصيل

InjectDetails

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

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

تظهر المَعلمة callback على النحو التالي:
```
() => void
```

isAudioMuted()

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

chrome.webviewTag.isAudioMuted(
  callback: function,
): void

طلبات البحث عمّا إذا كان الصوت مكتومًا.

المعلمات

callback

دالة

تظهر المَعلمة callback على النحو التالي:
```
(muted: boolean) => void
```
- تم كتم الصوت
  
  قيمة منطقية

isSpatialNavigationEnabled()

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

chrome.webviewTag.isSpatialNavigationEnabled(
  callback: function,
): void

يستعلم هذا الإعداد عمّا إذا كانت ميزة "التنقّل المكاني" مفعّلة في WebView.

المعلمات

callback

دالة

تظهر المَعلمة callback على النحو التالي:
```
(enabled: boolean) => void
```
- مفعّلة
  
  قيمة منطقية

isUserAgentOverridden()

chrome.webviewTag.isUserAgentOverridden(): void

تشير إلى ما إذا كان قد تم تجاهل سلسلة وكيل المستخدم الخاصة بـ webview من خلال webviewTag.setUserAgentOverride.

loadDataWithBaseUrl()

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

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

المعلمات

dataUrl

سلسلة

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

سلسلة

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

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

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

print()

chrome.webviewTag.print(): void

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

reload()

chrome.webviewTag.reload(): void

تعيد هذه الطريقة تحميل الصفحة الحالية ذات المستوى الأعلى.

removeContentScripts()

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

chrome.webviewTag.removeContentScripts(
  scriptNameList?: string[],
): void

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

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

webview.removeContentScripts(['myRule']);

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

webview.removeContentScripts();

المعلمات

scriptNameList

string[] اختياري

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

setAudioMuted()

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

chrome.webviewTag.setAudioMuted(
  mute: boolean,
): void

تضبط هذه السمة حالة كتم صوت العرض على الويب.

المعلمات

كتم الصوت

قيمة منطقية

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

setSpatialNavigationEnabled()

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

chrome.webviewTag.setSpatialNavigationEnabled(
  enabled: boolean,
): void

تضبط هذه السمة حالة التنقّل المكاني في طريقة عرض الويب.

المعلمات

مفعّلة

قيمة منطقية

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

setUserAgentOverride()

chrome.webviewTag.setUserAgentOverride(
  userAgent: string,
): void

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

المعلمات

userAgent

سلسلة

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

setZoom()

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

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

المعلمات

zoomFactor

الرقم

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

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

تظهر المَعلمة callback على النحو التالي:
```
() => void
```

setZoomMode()

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

chrome.webviewTag.setZoomMode(
  ZoomMode: ZoomMode,
  callback?: function,
): void

تضبط هذه السمة وضع التكبير/التصغير في webview.

المعلمات

ZoomMode

ZoomMode

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

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

تظهر المَعلمة callback على النحو التالي:
```
() => void
```

stop()

chrome.webviewTag.stop(): void

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

stopFinding()

chrome.webviewTag.stopFinding(
  action?: StopFindingAction,
): void

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

المعلمات

إجراء

StopFindingAction اختيارية

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

terminate()

chrome.webviewTag.terminate(): void

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

الفعاليات

close

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

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

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

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

المعلمات

callback

دالة

تظهر المَعلمة callback على النحو التالي:
```
() => void
```

consolemessage

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

يتمّ إطلاق هذا الحدث عندما تسجّل نافذة الضيف رسالة في وحدة التحكّم.

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

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

المعلمات

callback

دالة

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

دالة

تظهر المَعلمة callback على النحو التالي:
```
() => void
```

dialog

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

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

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

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

المعلمات

callback

دالة

تظهر المَعلمة callback على النحو التالي:
```
(messageType: DialogMessageType, messageText: string, dialog: DialogController) => void
```
- messageType
  
  DialogMessageType
- 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

دالة

تظهر المَعلمة callback على النحو التالي:
```
(details: object) => void
```
- التفاصيل
  
  عنصر
  - processID
    
    الرقم
    
    المعرّف الداخلي لعملية Chrome التي تم إيقافها
  - السبب
    
    ExitReason
    
    سلسلة تشير إلى سبب الخروج.

findupdate

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

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

المعلمات

callback

دالة

تظهر المَعلمة 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 من النوع about أو JavaScript، سيتم تشغيل loadabort ثم الانتقال إلى webview إلى about:blank.

المعلمات

callback

دالة

تظهر المَعلمة callback على النحو التالي:
```
(url: string, isTopLevel: boolean, code: number, reason: LoadAbortReason) => void
```
- url
  
  سلسلة
- isTopLevel
  
  قيمة منطقية
- رمز
  
  الرقم
- السبب
  
  LoadAbortReason

loadcommit

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

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

المعلمات

callback

دالة

تظهر المَعلمة callback على النحو التالي:
```
(url: string, isTopLevel: boolean) => void
```
- url
  
  سلسلة
- isTopLevel
  
  قيمة منطقية

loadredirect

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

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

المعلمات

callback

دالة

تظهر المَعلمة callback على النحو التالي:
```
(oldUrl: string, newUrl: string, isTopLevel: boolean) => void
```
- oldUrl
  
  سلسلة
- newUrl
  
  سلسلة
- isTopLevel
  
  قيمة منطقية

loadstart

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

يتم إطلاقه عند بدء عملية تحميل.

المعلمات

callback

دالة

تظهر المَعلمة callback على النحو التالي:
```
(url: string, isTopLevel: boolean) => void
```
- url
  
  سلسلة
- isTopLevel
  
  قيمة منطقية

loadstop

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

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

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

المعلمات

callback

دالة

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

دالة

تظهر المَعلمة callback على النحو التالي:
```
(window: NewWindow, targetUrl: string, initialWidth: number, initialHeight: number, name: string, windowOpenDisposition: WindowOpenDisposition) => void
```
- نافذة
  
  NewWindow
- targetUrl
  
  سلسلة
- initialWidth
  
  الرقم
- initialHeight
  
  الرقم
- الاسم
  
  سلسلة
- windowOpenDisposition
  
  WindowOpenDisposition

permissionrequest

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

يتم تنشيط هذا الحدث عندما تحتاج صفحة الضيف إلى طلب إذن خاص من صفحة التضمين.

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

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

المعلمات

callback

دالة

تظهر المَعلمة callback على النحو التالي:
```
(permission: PermissionType, request: object) => void
```
- الإذن
  
  PermissionType
- طلب
  
  عنصر

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

دالة

تظهر المَعلمة callback على النحو التالي:
```
(processID: number) => void
```
- processID
  
  الرقم

sizechanged

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

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

المعلمات

callback

دالة

تظهر المَعلمة callback على النحو التالي:
```
(oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void
```
- oldWidth
  
  الرقم
- oldHeight
  
  الرقم
- newWidth
  
  الرقم
- newHeight
  
  الرقم

unresponsive

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

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

المعلمات

callback

دالة

تظهر المَعلمة callback على النحو التالي:
```
(processID: number) => void
```
- processID
  
  الرقم

zoomchange

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

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

المعلمات

callback

دالة

تظهر المَعلمة callback على النحو التالي:
```
(oldZoomFactor: number, newZoomFactor: number) => void
```
- oldZoomFactor
  
  الرقم
- newZoomFactor
  
  الرقم

chrome.webviewTag تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الوصف

الأذونات

الأنواع

ClearDataOptions

الخصائص

ClearDataTypeSet

الخصائص

ContentScriptDetails

الخصائص

ContentWindow

الخصائص

ContextMenuCreateProperties

الخصائص

ContextMenus

الخصائص

ContextMenuUpdateProperties

الخصائص

ContextType

Enum

DialogController

الخصائص

DialogMessageType

Enum

DownloadPermissionRequest

الخصائص

ExitReason

Enum

FileSystemPermissionRequest

الخصائص

FindCallbackResults

الخصائص

FindOptions

الخصائص

FullscreenPermissionRequest

الخصائص

GeolocationPermissionRequest

الخصائص

HidPermissionRequest

الخصائص

InjectDetails

الخصائص

InjectionItems

الخصائص

LoadAbortReason

Enum

LoadPluginPermissionRequest

الخصائص

MediaPermissionRequest

الخصائص

NewWindow

الخصائص

PermissionType

Enum

PointerLockPermissionRequest

الخصائص

SelectionRect

الخصائص

StopFindingAction

Enum

WebRequestEventInterface

WindowOpenDisposition

Enum

ZoomMode

Enum

الخصائص

contentWindow

النوع

contextMenus

النوع

request

النوع

الطُرق

addContentScripts()

المعلمات

back()

المعلمات

canGoBack()

المرتجعات

canGoForward()

chrome.webviewTag