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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

chrome.webviewTag

תיאור

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

הרשאות

webview

זמינות

ל-ChromeOS בלבד

סוגים

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

[ContextType, ...ContextType[]] optional

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

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

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

boolean אופציונלי

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

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

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

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

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

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

בדומה ל-documentUrlPatterns, אבל מאפשר לסנן על סמך המאפיין src של תגי img/audio/video ועל סמך המאפיין href של תגי anchor.
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 optional

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

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

[ContextType, ...ContextType[]] optional

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

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

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

boolean אופציונלי

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

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

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

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

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

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

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

‫ItemType אופציונלי

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

‫void optional

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

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

ContextType

‫Chrome 44 ואילך

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

Enum

‫"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+‎

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

Enum

"alert"

‫"confirm"

"prompt"

DownloadPermissionRequest

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

מאפיינים

requestMethod

מחרוזת

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

מחרוזת

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

void

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

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

void

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

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

ExitReason

‫Chrome 141+‎

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

Enum

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

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

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 שמצורף לאירוע 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+‎

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

Enum

‪"media"

‫"geolocation"

‪"pointerLock"

"download"

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

Enum

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

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

המיקום המבוקש של החלון החדש.

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

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

מאפיינים

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

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

סוג

Methods

addContentScripts()

פרמטרים

back()

פרמטרים

canGoBack()

החזרות

chrome.webviewTag