הדף הזה הוא חלק מהתיעוד של פלטפורמת אפליקציות Chrome, שהוצאה משימוש בשנת 2020. היא תמשיך לתמוך בלקוחות Enterprise ו-Education ב-ChromeOS עד ינואר 2025 לפחות. מידע נוסף על העברת האפליקציה

דף זה תורגם על ידי Cloud Translation API.

chrome.webviewTag

תיאור

משתמשים בתג webview כדי לטעון באופן פעיל תוכן בשידור חי מהאינטרנט דרך הרשת ולהטמיע אותו באפליקציית Chrome. האפליקציה יכולה לשלוט במראה של התג webview ולקיים אינטראקציה עם תוכן האינטרנט, להתחיל ניווטים בדף אינטרנט מוטמע, להגיב לאירועי שגיאה שמתרחשים בתוכו ועוד (ראו שימוש).

הרשאות

webview

סוגים

ClearDataOptions

אפשרויות שקובעות אילו נתונים יימחקו על ידי clearData.

מאפיינים

מאז

מספר אופציונלי

מחיקת נתונים שהצטברו בתאריך הזה או אחריו, שמוצגים באלפיות השנייה מאז תקופת האפוק (אפשר לגשת אליהם באמצעות השיטה getTime של אובייקט JavaScript Date). אם לא מציינים ערך, ברירת המחדל היא 0 (שגורמת להסרת כל נתוני הגלישה).

ClearDataTypeSet

קבוצה של סוגי נתונים. מאפיינים חסרים מתפרשים כ-false.

מאפיינים

appcache

‫boolean אופציונלי

מטמון האפליקציות של אתרים.
קובץ שמור

‫boolean אופציונלי

‫Chrome 44 ואילך

מגרסה Chrome 43 ואילך. המטמון של הדפדפן. הערה: כשמסירים נתונים, המטמון כולו מתרוקן, ולא רק הנתונים בטווח שצוין.
קובצי cookie

‫boolean אופציונלי

קובצי ה-Cookie של המחיצה.
fileSystems

‫boolean אופציונלי

מערכות קבצים של אתרים.
indexedDB

‫boolean אופציונלי

נתוני IndexedDB של אתרים.
localStorage

‫boolean אופציונלי

נתונים של אחסון מקומי של אתרים.
persistentCookies

‫boolean אופציונלי

‫Chrome 58 ואילך

קובצי Cookie קבועים של המחיצה.
sessionCookies

‫boolean אופציונלי

‫Chrome 58 ואילך

קובצי ה-Cookie הזמניים של המחיצה.
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 שתואמות ל-glob הזה. התכונה הזו נועדה לחקות את מילת המפתח @exclude של Greasemonkey.
exclude_matches

string[] אופציונלי

הוא מחריג דפים שהסקריפט הזה של התוכן היה מוזרק אליהם.
include_globs

string[] אופציונלי

המסנן מופעל אחרי ההתאמות, כדי לכלול רק את כתובות ה-URL שתואמות גם ל-glob הזה. הכוונה היא לחקות את מילת המפתח @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 באירוע ההודעה שהוא מקבל.

ה-API הזה זהה ל-HTML5 postMessage API לתקשורת בין דפי אינטרנט. הקוד להטמעה יכול להאזין לתשובות על ידי הוספת event listener מסוג message למסגרת שלו.

הפונקציה postMessage נראית כך:
```
(message: any, targetOrigin: string) => {...}
```
- הודעה
  
  כל
  
  אובייקט ההודעה שיישלח לאורח.
- targetOrigin
  
  מחרוזת
  
  מציין מה צריך להיות המקור של חלון האורח כדי שהאירוע יישלח.

ContextMenuCreateProperties

‫Chrome 44 ואילך

מאפיינים

בוצע סימון

‫boolean אופציונלי

הסטטוס הראשוני של תיבת סימון או פריט רדיו: true אם נבחר ו-false אם לא נבחר. אפשר לבחור רק פריט אחד מתוך קבוצת פריטים מסוג לחצן בחירה.
contexts

[ContextType, ...ContextType[]] optional

רשימה של הקשרים שבהם יופיע הפריט הזה בתפריט. אם לא מציינים ערך, ברירת המחדל היא ['page'].
documentUrlPatterns

string[] אופציונלי

ההגדרה הזו מאפשרת להגביל את הפריט כך שיחול רק על מסמכים שכתובת ה-URL שלהם תואמת לאחת מהתבניות שצוינו. (ההגדרה הזו חלה גם על מסגרות). פרטים על הפורמט של תבנית מופיעים במאמר תבניות התאמה.
פעיל

‫boolean אופציונלי

האם פריט החיפוש בתפריט ההקשר מופעל או מושבת. ברירת המחדל היא true.
id [מזהה]

מחרוזת אופציונלי

המזהה הייחודי שמוקצה לפריט הזה. חובה בדפי אירועים. הערך לא יכול להיות זהה למזהה אחר של התוסף הזה.
parentId

string | number optional

המזהה של פריט בתפריט הראשי. כך הפריט הופך לפריט צאצא של פריט שנוסף קודם.
targetUrlPatterns

string[] אופציונלי

בדומה ל-documentUrlPatterns, אבל מאפשר לסנן על סמך המאפיין src של תגי img/audio/video ועל סמך המאפיין src של תגי anchor.href
title

מחרוזת אופציונלי

הטקסט שיוצג בפריט. חובה לציין את הטקסט הזה, אלא אם הערך של type הוא separator (מפריד). אם ההקשר הוא 'בחירה', אפשר להשתמש ב-%s בתוך המחרוזת כדי להציג את הטקסט שנבחר. לדוגמה, אם הערך של הפרמטר הזה הוא Translate '%s' to Pig Latin (תרגום של '%s' ל-Pig Latin) והמשתמש בוחר במילה cool (מגניב), הפריט בתפריט ההקשר לבחירה הוא Translate 'cool' to Pig Latin (תרגום של 'cool' ל-Pig Latin).
סוג

‫ItemType אופציונלי

סוג הפריט בתפריט. אם לא מציינים ערך, ברירת המחדל היא 'normal'.
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 נראית כך:
    () => {...}
create

void

יוצר פריט חדש בתפריט ההקשר. הערה: אם מתרחשת שגיאה במהלך היצירה, יכול להיות שלא תדעו על כך עד שהקריאה החוזרת ליצירה תופעל (הפרטים יופיעו ב-runtime.lastError).

הפונקציה create נראית כך:
```
(createProperties: object, callback?: function) => {...}
```
- createProperties
  
  אובייקט
  
  המאפיינים ששימשו ליצירת הפריט
- callback
  
  פונקציה אופציונלית
  
  הפרמטר callback נראה כך:
```
() => void
```
- החזרות
  מחרוזת | מספר
  
  המזהה של הפריט שנוצר.
remove

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 אופציונלי

המצב של תיבת סימון או פריט מסוג לחצן רדיו: true אם נבחר ו-false אם לא נבחר. אפשר לבחור רק פריט אחד מתוך קבוצת פריטים מסוג לחצן בחירה.
contexts

[ContextType, ...ContextType[]] optional

רשימה של הקשרים שבהם יופיע הפריט הזה בתפריט.
documentUrlPatterns

string[] אופציונלי

ההגדרה הזו מאפשרת להגביל את הפריט כך שיחול רק על מסמכים שכתובת ה-URL שלהם תואמת לאחת מהתבניות שצוינו. (ההגדרה הזו חלה גם על מסגרות). פרטים על הפורמט של תבנית מופיעים במאמר תבניות התאמה.
פעיל

‫boolean אופציונלי

האם פריט החיפוש בתפריט ההקשר מופעל או מושבת.
parentId

string | number optional

המזהה של פריט בתפריט הראשי. כך הפריט הופך לפריט צאצא של פריט שנוסף קודם. הערה: אי אפשר לשנות פריט כך שיהיה צאצא של אחד מהצאצאים שלו.
targetUrlPatterns

string[] אופציונלי

בדומה ל-documentUrlPatterns, אבל מאפשר לסנן על סמך המאפיין src של תגי img/audio/video ועל סמך המאפיין src של תגי anchor.href
title

מחרוזת אופציונלי

הטקסט שיוצג בפריט
סוג

‫ItemType אופציונלי

סוג הפריט בתפריט.
onclick

‫void אופציונלי

פונקציה שתופעל כשלוחצים על פריט בתפריט.

הפונקציה onclick נראית כך:
```
(info: OnClickData) => {...}
```
- מידע
  
  OnClickData
  
  מידע על הפריט שעליו לחצו ועל ההקשר שבו התרחש הקליק.

ContextType

‫Chrome 44 ואילך

ההקשרים השונים שבהם יכול להופיע תפריט. הגדרה של 'all' שווה לשילוב של כל ההקשרים האחרים.

ספירה

‫"all"

‫"page"

‪"frame"

"selection"

"link"

"editable"

"image"

"video"

"audio"

DialogController

ממשק שמצורף לאירועי DOM‏ dialog.

מאפיינים

ביטול

void

לדחות את תיבת הדו-שיח. מקביל ללחיצה על 'ביטול' בתיבת דו-שיח confirm או prompt.

הפונקציה cancel נראית כך:
```
() => {...}
```
אישור

void

מאשרים את תיבת הדו-שיח. מקביל ללחיצה על 'אישור' בתיבת דו-שיח של alert, confirm או prompt.

הפונקציה ok נראית כך:
```
(response?: string) => {...}
```
- תשובה
  
  מחרוזת אופציונלי
  
  מחרוזת התשובה שמוצגת לאורח כשמאשרים את תיבת הדו-שיח prompt.

DialogMessageType

‫Chrome 141+‎

סוג תיבת הדו-שיח המודאלית שהאורח ביקש.

ספירה

"alert"

‫"confirm"

‎"prompt"

DownloadPermissionRequest

סוג האובייקט request שמצורף לאירוע DOM‏ permissionrequest.download

מאפיינים

requestMethod

מחרוזת

סוג בקשת ה-HTTP (למשל, GET) שמשויך לבקשת ההורדה.
כתובת אתר

מחרוזת

כתובת ה-URL של ההורדה המבוקשת.
לאפשר

void

מאשרים את בקשת ההרשאה.

הפונקציה allow נראית כך:
```
() => {...}
```
דחייה

void

לדחות את בקשת ההרשאה. זוהי התנהגות ברירת המחדל אם לא מתבצעת קריאה ל-allow.

הפונקציה deny נראית כך:
```
() => {...}
```

ExitReason

‫Chrome 141+‎

מחרוזת שמציינת את הסיבה ליציאה.

ספירה

"normal"

"abnormal"

"crashed"

"killed"

‫"oom killed"

‫"oom"

"failed to launch"

"integrity failure"

FileSystemPermissionRequest

סוג האובייקט request שמצורף לאירוע DOM‏ permissionrequest.filesystem

מאפיינים

כתובת אתר

מחרוזת

כתובת ה-URL של המסגרת שמבקשת גישה למערכת הקבצים המקומית.
לאפשר

void

מאשרים את בקשת ההרשאה.

הפונקציה allow נראית כך:
```
() => {...}
```
דחייה

void

לדחות את בקשת ההרשאה.

הפונקציה deny נראית כך:
```
() => {...}
```

FindCallbackResults

מכיל את כל התוצאות של בקשת החיפוש.

מאפיינים

activeMatchOrdinal

number

המספר הסידורי של ההתאמה הנוכחית.
בוטלו

בוליאני

מציין אם בקשת החיפוש הזו בוטלה.
numberOfMatches

number

מספר הפעמים שבהן התבצעה התאמה של searchText בדף.
selectionRect

SelectionRect

מתאר מלבן סביב ההתאמה הפעילה בקואורדינטות מסך.

FindOptions

אפשרויות לבקשת החיפוש.

מאפיינים

אחורה

‫boolean אופציונלי

דגל לחיפוש התאמות בסדר הפוך. ערך ברירת המחדל הוא false.
matchCase

‫boolean אופציונלי

סימון להתאמה עם תלות באותיות רישיות. ערך ברירת המחדל הוא false.

FullscreenPermissionRequest

‫Chrome 43 ואילך

סוג האובייקט request שמצורף לאירוע DOM‏ permissionrequest.fullscreen

מאפיינים

origin

מחרוזת

המקור של המסגרת בתוך התג webview שיזם את הבקשה למסך מלא.
לאפשר

void

מאשרים את בקשת ההרשאה.

הפונקציה allow נראית כך:
```
() => {...}
```
דחייה

void

לדחות את בקשת ההרשאה.

הפונקציה deny נראית כך:
```
() => {...}
```

GeolocationPermissionRequest

סוג האובייקט request שמצורף לאירוע DOM‏ permissionrequest.geolocation

מאפיינים

כתובת אתר

מחרוזת

כתובת ה-URL של המסגרת שמבקשת גישה לנתוני מיקום גיאוגרפי.
לאפשר

void

מאשרים את בקשת ההרשאה.

הפונקציה allow נראית כך:
```
() => {...}
```
דחייה

void

לדחות את בקשת ההרשאה. זוהי התנהגות ברירת המחדל אם לא מתבצעת קריאה ל-allow.

הפונקציה deny נראית כך:
```
() => {...}
```

HidPermissionRequest

‫Chrome 125 ואילך

סוג האובייקט request שמצורף לאירוע DOM‏ permissionrequest.hid

מאפיינים

כתובת אתר

מחרוזת

כתובת ה-URL של המסגרת שמבקשת גישה ל-HID API.
לאפשר

void

מאשרים את בקשת ההרשאה.

הפונקציה allow נראית כך:
```
() => {...}
```
דחייה

void

לדחות את בקשת ההרשאה. זוהי התנהגות ברירת המחדל אם לא מתבצעת קריאה ל-allow.

הפונקציה deny נראית כך:
```
() => {...}
```

InjectDetails

פרטים של הסקריפט או ה-CSS להחדרה. צריך להגדיר את מאפיין הקוד או את מאפיין הקובץ, אבל אי אפשר להגדיר את שניהם בו-זמנית.

מאפיינים

קוד

מחרוזת אופציונלי

קוד JavaScript או CSS להחדרה.

אזהרה: חשוב להשתמש בפרמטר code בזהירות. שימוש לא נכון עלול לחשוף את האפליקציה להתקפות XSS‏ (cross-site scripting).
קובץ

מחרוזת אופציונלי

קובץ JavaScript או CSS להזרקה.

InjectionItems

‫Chrome 44 ואילך

סוג הפריט להחדרה: קוד או קבוצת קבצים.

מאפיינים

קוד

מחרוזת אופציונלי

קוד JavaScript או CSS שיוזרק לדפים תואמים.
קבצים

string[] אופציונלי

רשימת קובצי JavaScript או CSS להחדרה לדפים תואמים. הם מוזרקים לפי הסדר שבו הם מופיעים במערך הזה.

LoadAbortReason

‫Chrome 141+‎

מחרוזת שמציינת את סוג הביטול שהתרחש. לא מובטח שהמחרוזת הזו תישאר תואמת לאחור בין גרסאות. אסור לכם לנתח את התוכן של הקובץ ולבצע פעולות על סמך הניתוח. יכול להיות גם שבמקרים מסוימים תדווח שגיאה שלא מופיעה כאן.

ספירה

‫"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 שמצורף לאירוע DOM‏ permissionrequest.loadplugin

מאפיינים

מזהה

מחרוזת

מחרוזת המזהה של הפלאגין.
שם

מחרוזת

השם המוצג של הפלאגין.
לאפשר

void

מאשרים את בקשת ההרשאה. זוהי התנהגות ברירת המחדל אם לא מתבצעת קריאה ל-deny.

הפונקציה allow נראית כך:
```
() => {...}
```
דחייה

void

לדחות את בקשת ההרשאה.

הפונקציה deny נראית כך:
```
() => {...}
```

MediaPermissionRequest

סוג האובייקט request שמצורף לאירוע DOM‏ permissionrequest.media

מאפיינים

כתובת אתר

מחרוזת

כתובת ה-URL של המסגרת שמבקשת גישה למדיה של המשתמש.
לאפשר

void

מאשרים את בקשת ההרשאה.

הפונקציה allow נראית כך:
```
() => {...}
```
דחייה

void

לדחות את בקשת ההרשאה. זוהי התנהגות ברירת המחדל אם לא מתבצעת קריאה ל-allow.

הפונקציה deny נראית כך:
```
() => {...}
```

NewWindow

ממשק שמצורף לאירועי DOM‏ newwindow.

מאפיינים

לחבר

void

מצרפים את דף היעד המבוקש לרכיב webview קיים.

הפונקציה attach נראית כך:
```
(webview: object) => {...}
```
- webview
  
  אובייקט
  
  רכיב webview שאליו צריך לצרף את דף היעד.
מחיקה

void

מבטלים את הבקשה לפתיחת חלון חדש.

הפונקציה discard נראית כך:
```
() => {...}
```

PermissionType

‫Chrome 141+‎

סוג ההרשאה שמתבקשת.

ספירה

‪"media"

‫"geolocation"

‎"pointerLock"

"הורדה"

‎"loadplugin"

‫"filesystem"

‫"fullscreen"

‫"hid"

PointerLockPermissionRequest

סוג האובייקט request שמצורף לאירוע DOM‏ permissionrequest.pointerLock

מאפיינים

lastUnlockedBySelf

בוליאני

מציין אם המסגרת ששלחה את הבקשה הייתה הלקוח האחרון שהחזיק את נעילת המצביע.
כתובת אתר

מחרוזת

כתובת ה-URL של המסגרת שמבקשת נעילה של מצביע העכבר.
userGesture

בוליאני

האם נעשתה בקשה לנעילת הסמן כתוצאה מתנועת קלט של משתמש.
לאפשר

void

מאשרים את בקשת ההרשאה.

הפונקציה allow נראית כך:
```
() => {...}
```
דחייה

void

לדחות את בקשת ההרשאה. זוהי התנהגות ברירת המחדל אם לא מתבצעת קריאה ל-allow.

הפונקציה deny נראית כך:
```
() => {...}
```

SelectionRect

מתאר מלבן בקואורדינטות מסך.

הסמנטיקה של ההכלה היא כמו במערך, כלומר הקואורדינטה (left, top) נחשבת כקואורדינטה שמוכלת במלבן, אבל הקואורדינטה (left + width, top) לא נחשבת כקואורדינטה שמוכלת במלבן.

מאפיינים

גובה

number

גובה המלבן.
שמאלה

number

המרחק מהקצה הימני של המסך לקצה הימני של המלבן.
עליון

number

המרחק מהקצה העליון של המסך לקצה העליון של המלבן.
רוחב

number

רוחב המלבן.

StopFindingAction

‫Chrome 141+‎

קובעת מה לעשות עם ההתאמה הפעילה אחרי שהסתיים סשן החיפוש. ‫clear – יסיר את ההדגשה של ההתאמה הפעילה. ‫keep – ישאיר את ההדגשה של ההתאמה הפעילה. ‫activate – ישאיר את ההדגשה של ההתאמה הפעילה וידמה לחיצה של משתמש על ההתאמה הזו. פעולת ברירת המחדל היא keep.

ספירה

‫"clear"

‎"keep"‎

‫activate

WebRequestEventInterface

‫Chrome 44 ואילך

ממשק שמספק גישה לאירועי webRequest בדף האורח. פרטים על מחזור החיים של webRequest ומושגים קשורים זמינים ב-API של התוספים chrome.webRequest. הערה: אי אפשר להשתמש באירוע chrome.webRequest.onActionIgnored בתצוגות אינטרנט.

כדי להמחיש את ההבדלים בין השימוש ב-API לבין השימוש בתוסף webRequest, אפשר לעיין בדוגמת הקוד הבאה שחוסמת בקשות של אורחים לכתובות URL שתואמות ל-*://www.evil.com/*:

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

בנוסף, הממשק הזה תומך בכללים הצהרתיים של webRequest באמצעות אירועים של onRequest ו-onMessage. פרטים על ה-API מופיעים במאמר declarativeWebRequest.

שימו לב: צריך ליצור מופעים של תנאים ופעולות עבור webRequest של תצוגת 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

‫Chrome 141+‎

ההגדרה המבוקשת של החלון החדש.

ספירה

‫"ignore"

‫"save_to_disk"

‫"current_tab"

‫"new_background_tab"

‎"new_foreground_tab"

"new_window"

‎"new_popup"

ZoomMode

‫Chrome 43 ואילך

ההגדרה קובעת איך מתבצעת ההתקרבות בwebview.

ספירה

‫per-origin
שינויי הזום יישמרו במקור של הדף המוגדל, כלומר כל תצוגות האינטרנט האחרות באותה מחיצה שמובילות לאותו מקור יוגדלו גם כן. בנוסף, per-originשינויים בהתקרבות נשמרים עם המקור, כלומר כשעוברים לדפים אחרים באותו מקור, כולם יוצגו באותה רמת התקרבות.

‫"per-view"
שינויים בזום חלים רק בתצוגת האינטרנט הזו, ושינויים בזום בתצוגות אינטרנט אחרות לא ישפיעו על הזום בתצוגת האינטרנט הזו. בנוסף, per-view שינויים בזום מאופסים כשעוברים בין דפים. כשעוברים בין דפים בתצוגת אינטרנט, הדפים תמיד נטענים עם גורמי הזום שלהם לכל מקור (במסגרת המחיצה).

disabled
האפשרות הזו משביתה את כל ההגדלות ב-WebView. התוכן יחזור לרמת הזום שמוגדרת כברירת מחדל, והמערכת תתעלם מכל ניסיון לשנות את הזום.

מאפיינים

contentWindow

הפניה לאובייקט שאפשר להשתמש בה כדי לפרסם הודעות בדף האורח.

סוג

ContentWindow

contextMenus

‫Chrome 44 ואילך

בדומה ל-ContextMenus API של Chrome, אבל הוא חל על webview במקום על הדפדפן. משתמשים ב-webview.contextMenus API כדי להוסיף פריטים לתפריט ההקשר של webview. אתם יכולים לבחור לאילו סוגים של אובייקטים יחולו התוספות לתפריט ההקשר, כמו תמונות, היפר-קישורים ודפים.

סוג

ContextMenus

request

ממשק שמספק גישה לאירועי webRequest בדף האורח.

סוג

WebRequestEventInterface

Methods

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

צילום האזור הגלוי של WebView.

פרמטרים

options

‫ImageDetails אופציונלי
callback

פונקציה

הפרמטר callback נראה כך:
```
(dataUrl: string) => void
```
- dataUrl
  
  מחרוזת
  
  כתובת URL של נתונים שמקודדת תמונה של האזור הגלוי בכרטיסייה שצולמה. יכול להיות שיוקצה למאפיין src של רכיב תמונה ב-HTML לצורך הצגה.

clearData()

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

מחיקת נתוני הגלישה של מחיצת webview.

פרמטרים

options

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

מחרוזת

המחרוזת לחיפוש בדף.
options

‫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 לתהליך הנוכחי של דף האינטרנט של האורח, ומאפשרת למטמיעים לדעת על כמה אורחים תשפיע הפסקת התהליך. שני אורחים ישתפו תהליך רק אם הם שייכים לאותה אפליקציה ויש להם אותו מזהה מחיצת אחסון. הקריאה היא סינכרונית ומחזירה את המושג המאוחסן במטמון של המטמיע לגבי מזהה התהליך הנוכחי. מזהה התהליך שונה ממזהה התהליך של מערכת ההפעלה.

החזרות

number

getUserAgent()

chrome.webviewTag.getUserAgent(): string

הפונקציה מחזירה את מחרוזת סוכן המשתמש שמשמשת את webview לבקשות של דפי אורחים.

החזרות

מחרוזת

getZoom()

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

מחזירה את גורם הזום הנוכחי.

פרמטרים

callback

פונקציה

הפרמטר callback נראה כך:
```
(zoomFactor: number) => void
```
- zoomFactor
  
  number
  
  גורם הזום הנוכחי.

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

number

אינדקס היסטורי יחסי שאליו צריך לנווט באמצעות התג webview. לדוגמה, ערך של 2 ינווט קדימה 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()

‫Chrome 71 ואילך

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

הגדרת מצב השתקת האודיו של WebView.

פרמטרים

השתקה

בוליאני

ערך השתקת האודיו

setSpatialNavigationEnabled()

‫Chrome 71 ואילך

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

number

גורם הזום החדש.
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
```
- רמה
  
  number
- הודעה
  
  מחרוזת
- שורה
  
  number
- 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.

הטיפול באירוע הזה יחסום את תהליך האורח עד שכל event listener יחזיר ערך או עד שאובייקט 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
    
    number
    
    המזהה הפנימי של Chrome של התהליך שיצא.
  - reason
    
    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
  
  number
- activeMatchOrdinal
  
  number
- 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
```
- כתובת אתר
  
  מחרוזת
- isTopLevel
  
  בוליאני
- קוד
  
  number
- reason
  
  LoadAbortReason

loadcommit

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

מופעל כשמתבצעת טעינה. הנתון הזה כולל ניווט בתוך המסמך הנוכחי וטעינות ברמת המסמך של מסגרות משנה, אבל לא כולל טעינות אסינכרוניות של משאבים.

פרמטרים

callback

פונקציה

הפרמטר callback נראה כך:
```
(url: string, isTopLevel: boolean) => void
```
- כתובת אתר
  
  מחרוזת
- 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
```
- כתובת אתר
  
  מחרוזת
- 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,
)

האירוע מופעל כשדף האורח מנסה לפתוח חלון דפדפן חדש.

קוד הדוגמה הבא ייצור חלון חדש ב-embedder ויעבור אליו לכל חלון חדש שיידרש: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
  
  number
- initialHeight
  
  number
- שם
  
  מחרוזת
- windowOpenDisposition
  
  WindowOpenDisposition

permissionrequest

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

מופעל כשדף האורח צריך לבקש הרשאה מיוחדת מהדף המטמיע.

בדוגמת הקוד הבאה, תוענק לאורח גישה לדף webkitGetUserMedia API. שימו לב שאפליקציה שמשתמשת בקוד לדוגמה הזה צריכה לציין בעצמה את הרשאות המניפסט 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
  
  number

sizechanged

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

האירוע מופעל כשמשנים את הגודל של תוכן אינטרנט מוטמע באמצעות autosize. התג מופעל רק אם האפשרות autosize מופעלת.

פרמטרים

callback

פונקציה

הפרמטר callback נראה כך:
```
(oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void
```
- oldWidth
  
  number
- oldHeight
  
  number
- newWidth
  
  number
- newHeight
  
  number

unresponsive

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

מופעל כשתהליך העיבוד של תוכן האינטרנט לאורחים לא מגיב. האירוע הזה ייווצר פעם אחת עם אירוע תגובה תואם אם האורח יתחיל להגיב שוב.

פרמטרים

callback

פונקציה

הפרמטר callback נראה כך:
```
(processID: number) => void
```
- processID
  
  number

zoomchange

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

האירוע מופעל כשמשנים את רמת הזום של הדף.

פרמטרים

callback

פונקציה

הפרמטר callback נראה כך:
```
(oldZoomFactor: number, newZoomFactor: number) => void
```
- oldZoomFactor
  
  number
- newZoomFactor
  
  number

chrome.webviewTag קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

תיאור

הרשאות

סוגים

ClearDataOptions

מאפיינים

ClearDataTypeSet

מאפיינים

ContentScriptDetails

מאפיינים

ContentWindow

מאפיינים

ContextMenuCreateProperties

מאפיינים

ContextMenus

מאפיינים

ContextMenuUpdateProperties

מאפיינים

ContextType

ספירה

DialogController

מאפיינים

DialogMessageType

ספירה

DownloadPermissionRequest

מאפיינים

ExitReason

ספירה

FileSystemPermissionRequest

מאפיינים

FindCallbackResults

מאפיינים

FindOptions

מאפיינים

FullscreenPermissionRequest

מאפיינים

GeolocationPermissionRequest

מאפיינים

HidPermissionRequest

מאפיינים

InjectDetails

מאפיינים

InjectionItems

מאפיינים

LoadAbortReason

ספירה

LoadPluginPermissionRequest

מאפיינים

MediaPermissionRequest

מאפיינים

NewWindow

מאפיינים

PermissionType

ספירה

PointerLockPermissionRequest

מאפיינים

SelectionRect

מאפיינים

StopFindingAction

ספירה

WebRequestEventInterface

WindowOpenDisposition

ספירה

ZoomMode

ספירה

מאפיינים

contentWindow

סוג

contextMenus

סוג

request

סוג

Methods

addContentScripts()

פרמטרים

back()

פרמטרים

canGoBack()

החזרות

canGoForward()

chrome.webviewTag