תיאור
צריך להשתמש בתג webview
כדי לטעון באופן פעיל תוכן בשידור חי מהאינטרנט באמצעות הרשת ולהטמיע אותו באפליקציית Chrome. האפליקציה יכולה לשלוט במראה של webview
ולבצע אינטראקציה עם התוכן מהאינטרנט, להתחיל ניווטים בדף אינטרנט מוטמע, להגיב לאירועי שגיאה שמתרחשים בו ועוד (מידע נוסף זמין בקטע שימוש).
הרשאות
webview
סוגים
ClearDataOptions
אפשרויות שקובעות אילו נתונים צריך לנקות עד clearData
.
תכונות
-
מאז
מספר אופציונלי
ניקוי נתונים שהצטברו בתאריך זה או אחריו, המיוצגים באלפיות שנייה מאז תחילת התהליך (נגיש באמצעות שיטת getTime של האובייקט
Date
של JavaScript). אם השדה חסר, ברירת המחדל היא0
(פעולה זו תסיר את כל נתוני הגלישה).
ClearDataTypeSet
קבוצה של סוגי נתונים. מאפיינים חסרים מפוענחים כ-false
.
תכונות
-
מטמון האפליקציה
בוליאני אופציונלי
קובצי מטמון של אתרים.
-
קובץ שמור
בוליאני אופציונלי
Chrome 44 ואילךהחל מגרסה 43 של Chrome. במטמון הדפדפן. הערה: כשמסירים נתונים, הפעולה הזו מנקה את כל המטמון, ולא מוגבל לטווח שציינת.
-
קובצי cookie
בוליאני אופציונלי
קובצי ה-cookie של המחיצה.
-
fileSystems
בוליאני אופציונלי
מערכות הקבצים של אתרים.
-
indexedDB
בוליאני אופציונלי
נתוני IndexedDB של אתרים.
-
localStorage
בוליאני אופציונלי
נתוני האחסון המקומי של אתרים.
-
persistentCookies
בוליאני אופציונלי
Chrome בגרסה 58 ומעלהקובצי ה-Cookie הקבועים של המחיצה.
-
sessionCookies
בוליאני אופציונלי
Chrome בגרסה 58 ומעלהקובצי ה-cookie של הפעלת המחיצה.
-
webSQL
בוליאני אופציונלי
נתוני WebSQL של אתרים.
ContentScriptDetails
פרטים על סקריפט התוכן שיש להחדיר. אפשר לקרוא פרטים נוספים בתיעוד של סקריפטים של תוכן.
תכונות
-
all_frames
בוליאני אופציונלי
אם
all_frames
הואtrue
, המשמעות היא שיש להחדיר את ה-JavaScript או ה-CSS לכל המסגרות של הדף הנוכחי. כברירת מחדל, הערךall_frames
הואfalse
וה-JavaScript או ה-CSS מוחדר רק למסגרת העליונה. -
css
InjectionItems אופציונלי
קוד ה-CSS או רשימה של קובצי CSS שיש להכניס לדפים תואמים. הכללים האלה מוחדרים לפי הסדר שבו הם מופיעים, לפני ש-DOM כלשהו נבנה או מוצג עבור הדף.
-
exclude_globs
string[] אופציונלי
המערכת מחילה את ההגדרה הזו אחרי התאמות כדי להחריג כתובות URL שתואמות לדומיין הזה. נועד לחקות את מילת המפתח @exclusion של Gareasemonkey.
-
exclude_matches
string[] אופציונלי
לא כולל דפים שסקריפט התוכן הזה היה מוחדר אליהם בדרך אחרת.
-
include_globs
string[] אופציונלי
המערכת מחילה את ההגדרה אחרי התאמות כדי לכלול רק את כתובות ה-URL שתואמות גם הן ל-glob הזה. נועד לחקות את מילת המפתח @include Graeasemonkey.
-
js
InjectionItems אופציונלי
קוד ה-JavaScript או רשימה של קובצי JavaScript שיוחדרו לדפים תואמים. התוויות מוחדרות לפי הסדר שבו הן מופיעות.
-
match_about_blank
בוליאני אופציונלי
האם להוסיף את סקריפט התוכן ב-about:blank וב-about:srcdoc. סקריפטים של תוכן יוכנסו לדפים רק כאשר לכתובת ה-URL העוברת בירושה תהיה התאמה לאחת מהתבניות המוצהרות בשדה ההתאמות. כתובת ה-URL בירושה היא כתובת ה-URL של המסמך שיצר את המסגרת או החלון. לא ניתן להוסיף סקריפטים של תוכן במסגרות ארגז חול.
-
תואם את:
מחרוזת[]
מציין לאילו דפים יוחדר סקריפט התוכן הזה.
-
name
string
השם של סקריפט התוכן שיש להחדיר.
-
run_at
RunAt אופציונלי
בהקדם האפשרי שבו ה-JavaScript או ה-CSS יוכנסו לכרטיסייה. ברירת המחדל היא "document_idle".
ContentWindow
מזהה העברת הודעות לחלון אורח.
תכונות
-
postMessage
void
שולח הודעה לתוכן האינטרנט המוטמע, כל עוד התוכן המוטמע מציג דף ממקור היעד. השיטה הזו זמינה אחרי שמסתיימת טעינת הדף. מאזינים לאירוע
contentload
ואז מבצעים קריאה ל-method.האורח יוכל לשלוח תשובות למטמיע על ידי פרסום הודעה אל
event.source
באירוע של ההודעה שהוא יקבל.ה-API הזה זהה ל-HTML5 postMessage API לתקשורת בין דפי אינטרנט. כלי ההטמעה יכול להאזין לתשובות על ידי הוספת האזנה לאירוע
message
למסגרת משלו.הפונקציה
postMessage
נראית כך:(message: any, targetOrigin: string) => {...}
-
הודעה
הכול
אובייקט ההודעה שיש לשלוח לאורח.
-
targetOrigin
string
מציין את המקור של חלון האורח כדי שהאירוע יישלח.
-
ContextMenuCreateProperties
תכונות
-
בוצע סימון
בוליאני אופציונלי
המצב הראשוני של תיבת סימון או פריט רדיו: TRUE לבחירה ו-FALSE אם לא נבחר. ניתן לבחור רק פריט רדיו אחד בכל פעם בקבוצה נתונה של פריטי רדיו.
-
הקשרים
[ContextType, ...ContextType[]] אופציונלי
רשימת ההקשרים שבהם האפשרות הזו תופיע בתפריט. אם לא מגדירים ערך לפרמטר הזה, ערך ברירת המחדל שלו הוא ['page'].
-
documentUrlPatterns
string[] אופציונלי
מאפשר לך להגביל את הפריט כך שיחול רק על מסמכים שכתובת האתר שלהם תואמת לאחת מהתבניות הנתונות. (הדרישה הזו רלוונטית גם למסגרות). מידע נוסף על הפורמט של תבנית זמין במאמר תבניות התאמה.
-
פעיל
בוליאני אופציונלי
האם האפשרות הזו בתפריט ההקשר מופעלת או מושבתת. ברירת המחדל היא
true
. -
id
מחרוזת אופציונלי
המזהה הייחודי שיש להקצות לפריט הזה. חובה לדפי אירועים. לא יכול להיות זהה למזהה אחר של תוסף זה.
-
parentId
מחרוזת | מספר אופציונלי
המזהה של אפשרות ההורה בתפריט. זה הופך את הפריט לפריט צאצא של פריט שכבר הוספת.
-
targetUrlPatterns
string[] אופציונלי
דומה ל-documentUrlPatterns, אבל ניתן לסנן לפי המאפיין
src
של תגי img/audio/video וה-href
של תגי עוגן. -
title
מחרוזת אופציונלי
הטקסט שיוצג בפריט. זהו חובה, אלא אם הערך
type
הוא 'מפריד'. כשההקשר הוא 'בחירה', אפשר להשתמש בערך%s
בתוך המחרוזת כדי להציג את הטקסט שנבחר. לדוגמה, אם הערך של הפרמטר הזה הוא "תרגום של '%s' ל-Pig Latin" והמשתמש בוחר את המילה "cool", האפשרות בתפריט ההקשר היא "תרגום של 'cool' ל-Pig Latin". -
סוג
ItemType אופציונלי
הסוג של האפשרות בתפריט. אם לא מגדירים ערך לפרמטר הזה, ערך ברירת המחדל שלו הוא 'רגיל'.
-
onclick
ביטול אופציונלי
פונקציה שתתבצע קריאה חוזרת לאחר לחיצה על האפשרות בתפריט.
הפונקציה
onclick
נראית כך:(info: OnClickData) => {...}
-
מידע
מידע על הפריט שעליו לחץ המשתמש וההקשר שבו התרחש הקליק.
-
ContextMenus
תכונות
-
onShow
אירוע<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) => {...}
-
מחרוזת | מספר
המזהה של האפשרות להסרה בתפריט ההקשר.
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:() => void
-
-
removeAll
void
מתבצעת הסרה של כל האפשרויות בתפריט ההקשר שנוספו אל
webview
.הפונקציה
removeAll
נראית כך:(callback?: function) => {...}
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:() => void
-
-
update
void
מעדכן פריט של תפריט הקשר שנוצר קודם לכן.
הפונקציה
update
נראית כך:(id: string | number, updateProperties: object, callback?: function) => {...}
-
id
מחרוזת | מספר
המזהה של הפריט שצריך לעדכן.
-
updateProperties
אובייקט
המאפיינים שצריך לעדכן. מקבלת את אותם ערכים כמו הפונקציה create.
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:() => void
-
ContextMenuUpdateProperties
תכונות
-
בוצע סימון
בוליאני אופציונלי
המצב של תיבת סימון או פריט רדיו: TRUE לבחירה ו-FALSE אם לא נבחר. ניתן לבחור רק פריט רדיו אחד בכל פעם בקבוצה נתונה של פריטי רדיו.
-
הקשרים
[ContextType, ...ContextType[]] אופציונלי
רשימת ההקשרים שבהם האפשרות הזו תופיע בתפריט.
-
documentUrlPatterns
string[] אופציונלי
מאפשר לך להגביל את הפריט כך שיחול רק על מסמכים שכתובת האתר שלהם תואמת לאחת מהתבניות הנתונות. (הדרישה הזו רלוונטית גם למסגרות). מידע נוסף על הפורמט של תבנית זמין במאמר תבניות התאמה.
-
פעיל
בוליאני אופציונלי
האם האפשרות הזו בתפריט ההקשר מופעלת או מושבתת.
-
parentId
מחרוזת | מספר אופציונלי
המזהה של אפשרות ההורה בתפריט. זה הופך את הפריט לפריט צאצא של פריט שכבר הוספת. הערה: אי אפשר להגדיר פריט כצאצא של אחד מהצאצאים שלו.
-
targetUrlPatterns
string[] אופציונלי
דומה ל-documentUrlPatterns, אבל ניתן לסנן לפי המאפיין
src
של תגי img/audio/video וה-href
של תגי עוגן. -
title
מחרוזת אופציונלי
הטקסט שיוצג בפריט
-
סוג
ItemType אופציונלי
הסוג של האפשרות בתפריט.
-
onclick
ביטול אופציונלי
פונקציה שתתבצע קריאה חוזרת לאחר לחיצה על האפשרות בתפריט.
הפונקציה
onclick
נראית כך:(info: OnClickData) => {...}
-
מידע
מידע על הפריט שעליו לחץ המשתמש וההקשר שבו התרחש הקליק.
-
ContextType
ההקשרים השונים שבהם התפריט יכול להופיע. ציון 'הכול' מקביל לשילוב של כל שאר ההקשרים.
טיפוסים בני מנייה (enum)
DialogController
הממשק מצורף לאירועי DOM של dialog
.
תכונות
-
ביטול
void
דוחים את תיבת הדו-שיח. זהה ללחיצה על 'ביטול' בתיבת דו-שיח
confirm
אוprompt
.הפונקציה
cancel
נראית כך:() => {...}
-
אוקיי
void
מאשרים את תיבת הדו-שיח. זהה ללחיצה על 'אישור' בתיבת הדו-שיח
alert
,confirm
אוprompt
.הפונקציה
ok
נראית כך:(response?: string) => {...}
-
תשובה
מחרוזת אופציונלי
מחרוזת התשובה שצריך לספק לאורח כשמאשרים תיבת דו-שיח של
prompt
.
-
DownloadPermissionRequest
סוג האובייקט request
שמתלווה לאירוע DOM של download
permissionrequest
.
תכונות
-
requestMethod
string
סוג בקשת ה-HTTP (למשל
GET
) המשויך לבקשת ההורדה. -
כתובת אתר
string
כתובת ה-URL להורדה שהתבקשה.
-
לאפשר
void
מאשרים את בקשת ההרשאה.
הפונקציה
allow
נראית כך:() => {...}
-
דחייה
void
לדחות את בקשת ההרשאה. זוהי התנהגות ברירת המחדל אם לא קוראים לפונקציה
allow
.הפונקציה
deny
נראית כך:() => {...}
FileSystemPermissionRequest
סוג האובייקט request
שמתלווה לאירוע DOM של filesystem
permissionrequest
.
תכונות
-
כתובת אתר
string
כתובת ה-URL של המסגרת שמבקשת גישה למערכת הקבצים המקומית.
-
לאפשר
void
מאשרים את בקשת ההרשאה.
הפונקציה
allow
נראית כך:() => {...}
-
דחייה
void
לדחות את בקשת ההרשאה.
הפונקציה
deny
נראית כך:() => {...}
FindCallbackResults
מכילה את כל התוצאות של בקשת החיפוש.
תכונות
-
activeMatchOrdinal
number
המספר הסידורי של ההתאמה הנוכחית.
-
בוטלו
boolean
שדה זה מציין אם בקשת החיפוש בוטלה.
-
numberOfMatches
number
מספר הפעמים שבהן נמצאה התאמה ל-
searchText
בדף. -
selectionRect
מתאר מלבן מסביב להתאמה הפעילה בקואורדינטות של המסך.
FindOptions
אפשרויות לבקשת החיפוש.
תכונות
-
לאחור
בוליאני אופציונלי
מסמנים כדי למצוא התאמות בסדר הפוך. ערך ברירת המחדל הוא
false
. -
matchCase
בוליאני אופציונלי
סימון להתאמה עם חשיבות לאותיות רישיות (case-sensitivity). ערך ברירת המחדל הוא
false
.
FullscreenPermissionRequest
סוג האובייקט request
שמתלווה לאירוע DOM של fullscreen
permissionrequest
.
תכונות
-
מקור
string
מקור המסגרת בתוך
webview
שיזם את הבקשה למסך מלא. -
לאפשר
void
מאשרים את בקשת ההרשאה.
הפונקציה
allow
נראית כך:() => {...}
-
דחייה
void
לדחות את בקשת ההרשאה.
הפונקציה
deny
נראית כך:() => {...}
GeolocationPermissionRequest
סוג האובייקט request
שמתלווה לאירוע DOM של geolocation
permissionrequest
.
תכונות
-
כתובת אתר
string
כתובת ה-URL של המסגרת שמבקשת גישה לנתוני מיקום גיאוגרפי.
-
לאפשר
void
מאשרים את בקשת ההרשאה.
הפונקציה
allow
נראית כך:() => {...}
-
דחייה
void
לדחות את בקשת ההרשאה. זוהי התנהגות ברירת המחדל אם לא קוראים לפונקציה
allow
.הפונקציה
deny
נראית כך:() => {...}
HidPermissionRequest
סוג האובייקט request
שמתלווה לאירוע DOM של hid
permissionrequest
.
תכונות
-
כתובת אתר
string
כתובת ה-URL של המסגרת שמבקשת גישה ל-HID API.
-
לאפשר
void
מאשרים את בקשת ההרשאה.
הפונקציה
allow
נראית כך:() => {...}
-
דחייה
void
לדחות את בקשת ההרשאה. זוהי התנהגות ברירת המחדל אם לא קוראים לפונקציה
allow
.הפונקציה
deny
נראית כך:() => {...}
InjectDetails
פרטים על הסקריפט או על ה-CSS שיש להחדיר. יש להגדיר את הקוד או את מאפיין הקובץ, אבל אי אפשר להגדיר את שניהם בו-זמנית.
תכונות
-
קוד
מחרוזת אופציונלי
קוד JavaScript או קוד CSS שיש להחדיר.
אזהרה: כדאי להיזהר כשמשתמשים בפרמטר
code
. שימוש שגוי בו עלול לחשוף את האפליקציה שלך למתקפות של סקריפטים חוצי אתרים. -
קובץ
מחרוזת אופציונלי
JavaScript או קובץ CSS שיש להחדיר.
InjectionItems
סוג פריט ההחדרה: קוד או קבוצת קבצים.
תכונות
-
קוד
מחרוזת אופציונלי
קוד JavaScript או CSS שיש להחדיר לדפים תואמים.
-
קבצים
string[] אופציונלי
הרשימה של קובצי JavaScript או CSS שיש להחדיר לדפים תואמים. הערכים מוחדרים לפי הסדר שבו הם מופיעים במערך הזה.
LoadPluginPermissionRequest
סוג האובייקט request
שמתלווה לאירוע DOM של loadplugin
permissionrequest
.
תכונות
-
מזהה
string
מחרוזת המזהה של הפלאגין.
-
name
string
שם התצוגה של הפלאגין.
-
לאפשר
void
מאשרים את בקשת ההרשאה. זוהי התנהגות ברירת המחדל אם לא קוראים לפונקציה
deny
.הפונקציה
allow
נראית כך:() => {...}
-
דחייה
void
לדחות את בקשת ההרשאה.
הפונקציה
deny
נראית כך:() => {...}
MediaPermissionRequest
סוג האובייקט request
שמתלווה לאירוע DOM של media
permissionrequest
.
תכונות
-
כתובת אתר
string
כתובת ה-URL של המסגרת שמבקשת גישה למדיה של המשתמש.
-
לאפשר
void
מאשרים את בקשת ההרשאה.
הפונקציה
allow
נראית כך:() => {...}
-
דחייה
void
לדחות את בקשת ההרשאה. זוהי התנהגות ברירת המחדל אם לא קוראים לפונקציה
allow
.הפונקציה
deny
נראית כך:() => {...}
NewWindow
הממשק מצורף לאירועי DOM של newwindow
.
תכונות
-
לחבר
void
עליך לצרף את דף היעד המבוקש לרכיב
webview
קיים.הפונקציה
attach
נראית כך:(webview: object) => {...}
-
webview
אובייקט
הרכיב
webview
שאליו צריך לצרף את דף היעד.
-
-
מחיקה
void
מבטלים את הבקשה של החלון החדש.
הפונקציה
discard
נראית כך:() => {...}
PointerLockPermissionRequest
סוג האובייקט request
שמתלווה לאירוע DOM של pointerLock
permissionrequest
.
תכונות
-
lastUnlockedBySelf
boolean
האם המסגרת המבקשת הייתה הלקוח האחרון שהחזיק בנעילת המצביע.
-
כתובת אתר
string
כתובת ה-URL של המסגרת שמבקשת נעילת מצביע.
-
userGesture
boolean
האם נשלחה בקשה לנעילת מצביע כתוצאה מתנועת קלט של משתמש.
-
לאפשר
void
מאשרים את בקשת ההרשאה.
הפונקציה
allow
נראית כך:() => {...}
-
דחייה
void
לדחות את בקשת ההרשאה. זוהי התנהגות ברירת המחדל אם לא קוראים לפונקציה
allow
.הפונקציה
deny
נראית כך:() => {...}
SelectionRect
מתאר מלבן בקואורדינטות של מסך.
הסמנטיקה של הבלימה היא דמוית מערך. כלומר, הקואורדינטה (left, top)
נחשבת כחלק מהמלבן, אבל הקואורדינטה (left + width, top)
לא מובנת.
תכונות
-
גובה
number
גובה המלבן.
-
שמאלה
number
המרחק מהקצה השמאלי של המסך אל הקצה השמאלי של המלבן.
-
ראשונה
number
המרחק מהקצה העליון של המסך אל הקצה העליון של המלבן.
-
רוחב
number
רוחב המלבן.
WebRequestEventInterface
ממשק שמספק גישה לאירועי webRequest בדף האורח. פרטים על מחזור החיים של webRequest ועל מושגים קשורים זמינים ב-chrome.webRequest תוספים API. הערה: האירוע chrome.webRequest.onActionIgnored לא נתמך ברכיבי WebView.
כדי להמחיש את ההבדלים בין השימוש ב-webRequest API לתוספים, אפשר לעיין בקוד לדוגמה הבא שחוסם בקשות של אורחים עבור כתובות URL שתואמות ל-*://www.evil.com/*
:
webview.request.onBeforeRequest.addListener(
function(details) { return {cancel: true}; },
{urls: ["*://www.evil.com/*"]},
["blocking"]);
בנוסף, הממשק הזה תומך בכללי webRequest מוצהרים באמצעות אירועים של onRequest
ו-onMessage
. פרטים על ה-API זמינים בכתובת declarativeWebRequest
.
הערה: התנאים והפעולות של בקשות WebRequest הצהרתיות צריכים להיות נוצרים מגרסאות מקבילות ב-chrome.webViewRequest.*
. הקוד לדוגמה הבא חוסם באופן מוצהר את כל הבקשות אל "example.com"
ב-WebView myWebview
:
var rule = {
conditions: [
new chrome.webViewRequest.RequestMatcher({ url: { hostSuffix: 'example.com' } })
],
actions: [ new chrome.webViewRequest.CancelRequest() ]
};
myWebview.request.onRequest.addRules([rule]);
ZoomMode
הגדרת אופן הטיפול בשינוי מרחק התצוגה ב-webview
.
טיפוסים בני מנייה (enum)
'לכל מקור'
שינויי מרחק התצוגה יישמרו במקור של הדף עם הגדלת התצוגה. כלומר, גם כל רכיבי ה-WebView האחרים באותה מחיצה שמנווטים לאותו מקור יוגדלו. בנוסף, שינויים של מרחק התצוגה ב-per-origin
נשמרים עם המקור, כלומר כשמנווטים לדפים אחרים באותו מקור, כל השינויים מוגדלים לאותו גורם זום.
"לכל צפייה"
שינויי מרחק התצוגה נכנסים לתוקף רק ב-WebView הזה, ושינויים במרחק התצוגה ברכיבי WebView אחרים לא ישפיעו על שינוי מרחק התצוגה של ה-WebView הזה. בנוסף, השינויים של per-view
לשינוי מרחק התצוגה יאופסו בניווט. ניווט ב-WebView תמיד יטען דפים עם הגורמים לשינוי מרחק התצוגה לכל מקור (במסגרת המחיצה).
"disabled"
השבתת כל שינוי מרחק התצוגה ב-WebView. התוכן יחזור לרמת ברירת המחדל של מרחק התצוגה והמערכת תתעלם מכל ניסיון לשינוי מרחק התצוגה.
תכונות
contentWindow
הפניה לאובייקט שניתן להשתמש בה כדי לפרסם הודעות בדף האורח.
סוג
contextMenus
דומה ל-Contextmenus API של chrome, אך חל על webview
במקום על הדפדפן. יש להשתמש ב-API של webview.contextMenus
כדי להוסיף פריטים לתפריט ההקשר של webview
. אתם יכולים לבחור את סוגי האובייקטים שעליהם יחולו התוספות לתפריט ההקשר, כמו תמונות, היפר-קישורים ודפים.
סוג
request
ממשק שמספק גישה לאירועי webRequest בדף האורח.
שיטות
addContentScripts()
chrome.webviewTag.addContentScripts(
contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
)
הוספת כללים להחדרת סקריפט תוכן אל webview
. כאשר webview
עובר לדף שתואם לכלל אחד או יותר, הסקריפטים המשויכים יוחדרו. אפשר להוסיף כללים באופן פרוגרמטי או לעדכן כללים קיימים.
בדוגמה הבאה מוסיפים שני כללים למאפיין webview
: 'myRule' ו-'anotherRule'.
webview.addContentScripts([
{
name: 'myRule',
matches: ['http://www.foo.com/*'],
css: { files: ['mystyles.css'] },
js: { files: ['jquery.js', 'myscript.js'] },
run_at: 'document_start'
},
{
name: 'anotherRule',
matches: ['http://www.bar.com/*'],
js: { code: "document.body.style.backgroundColor = 'red';" },
run_at: 'document_end'
}]);
...
// Navigates webview.
webview.src = 'http://www.foo.com';
ניתן לדחות את הקריאה ל-addContentScripts עד שיהיה צורך להחדיר סקריפטים.
הדוגמה הבאה מראה איך להחליף כלל קיים.
webview.addContentScripts([{
name: 'rule',
matches: ['http://www.foo.com/*'],
js: { files: ['scriptA.js'] },
run_at: 'document_start'}]);
// Do something.
webview.src = 'http://www.foo.com/*';
...
// Overwrite 'rule' defined before.
webview.addContentScripts([{
name: 'rule',
matches: ['http://www.bar.com/*'],
js: { files: ['scriptB.js'] },
run_at: 'document_end'}]);
אם webview
נווט אל המקור (לדוגמה, foo.com) וקורא ל-webview.addContentScripts
כדי להוסיף את 'myRule', עליך להמתין לניווט הבא כדי לאפשר את הוספת הסקריפטים. אם ברצונך לקבל הזרקה מיידית, executeScript
יעשה את הפעולה הנכונה.
הכללים נשמרים גם אם תהליך האורח קורס או נהרג, או גם אם קיימת הורה חדש ל-webview
.
אפשר לקרוא פרטים נוספים בתיעוד של סקריפטים של תוכן.
פרמטרים
-
contentScriptList
פרטים על סקריפטים של תוכן להוספה.
back()
chrome.webviewTag.back(
callback?: function,
)
מנווט אחורה ברשומת היסטוריה אחת אם אפשר. שווה ערך ל-go(-1)
.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה אופציונלי
Chrome 44 ואילךהפרמטר
callback
נראה כך:(success: boolean) => void
-
הצלחה
boolean
מציין אם הניווט בוצע בהצלחה.
-
canGoBack()
chrome.webviewTag.canGoBack()
מציין אם ניתן לנווט אחורה בהיסטוריה או לא. המצב של הפונקציה הזו נשמר במטמון ומתעדכן לפני כל loadcommit
, לכן מומלץ לקרוא לה ב-loadcommit
.
החזרות
-
boolean
canGoForward()
chrome.webviewTag.canGoForward()
מציין אם ניתן לנווט קדימה דרך ההיסטוריה או לא. המצב של הפונקציה הזו נשמר במטמון ומתעדכן לפני כל loadcommit
, לכן מומלץ לקרוא לה ב-loadcommit
.
החזרות
-
boolean
captureVisibleRegion()
chrome.webviewTag.captureVisibleRegion(
options?: ImageDetails,
callback: function,
)
לוכד את האזור הגלוי של ה-WebView.
פרמטרים
-
אפשרויות
ImageDetails אופציונלי
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:(dataUrl: string) => void
-
dataUrl
string
כתובת URL של נתונים שמקודדת תמונה של האזור הגלוי בכרטיסייה שצולמה. להיות מוקצה למאפיין 'src' של רכיב HTML של תמונה לתצוגה.
-
clearData()
chrome.webviewTag.clearData(
options: ClearDataOptions,
types: ClearDataTypeSet,
callback?: function,
)
ניקוי נתוני הגלישה של המחיצה webview
.
פרמטרים
-
אפשרויות
אפשרויות שקובעות אילו נתונים לנקות.
-
סוגים
סוגי הנתונים שיש לנקות.
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:() => void
executeScript()
chrome.webviewTag.executeScript(
details: InjectDetails,
callback?: function,
)
מחדיר קוד JavaScript לדף האורח.
הקוד לדוגמה הבא משתמש בהחדרת סקריפט כדי להגדיר את צבע הרקע של דף האורח לאדום:
webview.executeScript({ code: "document.body.style.backgroundColor = 'red'" });
פרמטרים
-
פרטים
פרטי הסקריפט שצריך להריץ.
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:(result?: any[]) => void
-
תוצאה אחת
כל[] אופציונלי
התוצאה של הסקריפט בכל פריים שהוחדר.
-
find()
chrome.webviewTag.find(
searchText: string,
options?: FindOptions,
callback?: function,
)
מפעיל בקשת 'חיפוש בדף'.
פרמטרים
-
searchText
string
המחרוזת שיש למצוא בדף.
-
אפשרויות
FindOptions אופציונלי
אפשרויות לבקשת החיפוש.
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:(results?: FindCallbackResults) => void
-
תוצאות
FindCallbackResults אופציונלי
מכילה את כל התוצאות של בקשת החיפוש. אפשר להשמיט את הפונקציה
results
אם לא נעשה בה שימוש בגוף פונקציית הקריאה החוזרת (callback). לדוגמה, אם הקריאה החוזרת משמשת רק כדי להבין מתי בקשת החיפוש הושלמה.
-
forward()
chrome.webviewTag.forward(
callback?: function,
)
מנווט קדימה רשומה אחת בהיסטוריה, אם אפשר. שווה ערך ל-go(1)
.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה אופציונלי
Chrome 44 ואילךהפרמטר
callback
נראה כך:(success: boolean) => void
-
הצלחה
boolean
מציין אם הניווט בוצע בהצלחה.
-
getAudioState()
chrome.webviewTag.getAudioState(
callback: function,
)
מצב אודיו של שאילתה.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:(audible: boolean) => void
-
audible, אודיבל
boolean
-
getProcessId()
chrome.webviewTag.getProcessId()
מחזיר את מזהה התהליך הפנימי של Chrome עבור התהליך הנוכחי של דף האינטרנט של האורח, ומאפשר למי שמוטמע בו לדעת כמה אורחים יושפעו מסיום התהליך. שני אורחים יחלקו תהליך רק אם הם שייכים לאותה אפליקציה ומוגדרים להם אותו מזהה מחיצת אחסון. הקריאה היא סנכרונית ומחזירה את מושג המטמון של מטמיעים לגבי מזהה התהליך הנוכחי. מזהה התהליך שונה ממזהה התהליך של מערכת ההפעלה.
החזרות
-
number
getUserAgent()
chrome.webviewTag.getUserAgent()
מחזירה את מחרוזת סוכן המשתמש שבה נעשה שימוש ב-webview
עבור בקשות לדפים של אורחים.
החזרות
-
string
getZoom()
chrome.webviewTag.getZoom(
callback: function,
)
הפונקציה מקבלת את גורם הזום הנוכחי.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:(zoomFactor: number) => void
-
zoomFactor
number
גורם הזום הנוכחי.
-
getZoomMode()
chrome.webviewTag.getZoomMode(
callback: function,
)
מקבלת את מצב הזום הנוכחי.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:(ZoomMode: ZoomMode) => void
-
ZoomMode
מצב הזום הנוכחי במכשיר
webview
.
-
go()
chrome.webviewTag.go(
relativeIndex: number,
callback?: function,
)
ניווט לרשומת היסטוריה באמצעות אינדקס היסטוריה ביחס לניווט הנוכחי. אם הניווט המבוקש בלתי אפשרי, לשיטה הזו אין השפעה.
פרמטרים
-
relativeIndex
number
אינדקס היסטוריה יחסי שאליו יש לעבור אל
webview
. לדוגמה, אם אפשר, הערך2
ינווט קדימה ל-2 רשומות היסטוריה. אם אפשר, הערך-3
ינווט בין 3 הרשומות לאחור. -
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:(success: boolean) => void
-
הצלחה
boolean
מציין אם הניווט בוצע בהצלחה.
-
insertCSS()
chrome.webviewTag.insertCSS(
details: InjectDetails,
callback?: function,
)
מחדיר CSS לדף האורח.
פרמטרים
-
פרטים
פרטים לגבי שירות ה-CSS להוספה.
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:() => void
isAudioMuted()
chrome.webviewTag.isAudioMuted(
callback: function,
)
שאילתות לגבי אודיו מושתק.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:(muted: boolean) => void
-
הושתק
boolean
-
isSpatialNavigationEnabled()
chrome.webviewTag.isSpatialNavigationEnabled(
callback: function,
)
שאילתות לגבי הפעלת ניווט מרחבי ב-WebView.
פרמטרים
-
פונקציה
הפרמטר
callback
נראה כך:(enabled: boolean) => void
-
boolean
-
isUserAgentOverridden()
chrome.webviewTag.isUserAgentOverridden()
הערך מציין אם מחרוזת סוכן המשתמש של webview
בוטלה על ידי webviewTag.setUserAgentOverride
.
loadDataWithBaseUrl()
chrome.webviewTag.loadDataWithBaseUrl(
dataUrl: string,
baseUrl: string,
virtualUrl?: string,
)
טוען כתובת URL של נתונים עם כתובת URL בסיסית שצוינה, המשמשת לקישורים יחסיים. לחלופין, אפשר לספק כתובת URL וירטואלית שתוצג למשתמש במקום כתובת URL של נתונים.
פרמטרים
-
dataUrl
string
כתובת ה-URL של הנתונים לטעינה.
-
baseUrl
string
כתובת ה-URL הבסיסית שתשמש לקישורים יחסיים.
-
virtualUrl
מחרוזת אופציונלי
כתובת ה-URL שתוצג למשתמש (בסרגל הכתובות).
print()
chrome.webviewTag.print()
מדפיס את התוכן של webview
. הדבר מקביל לקריאה לפונקציית הדפסה מבוססת-סקריפט מה-webview
עצמו.
reload()
chrome.webviewTag.reload()
טוען מחדש את הדף הנוכחי ברמה העליונה.
removeContentScripts()
chrome.webviewTag.removeContentScripts(
scriptNameList?: string[],
)
מסיר סקריפטים של תוכן מ-webview
.
הדוגמה הבאה מסירה את "myRule" שנוסף לפני כן.
webview.removeContentScripts(['myRule']);
כדי להסיר את כל הכללים, צריך לבצע את הפעולות הבאות:
webview.removeContentScripts();
פרמטרים
-
scriptNameList
string[] אופציונלי
רשימת השמות של סקריפטים של תוכן שיוסרו. אם הרשימה ריקה, כל הסקריפטים של התוכן שנוספו אל
webview
יוסרו.
setAudioMuted()
chrome.webviewTag.setAudioMuted(
mute: boolean,
)
הגדרה של מצב השתקת האודיו ב-WebView.
פרמטרים
-
השתקה
boolean
השתקת ערך האודיו
setSpatialNavigationEnabled()
chrome.webviewTag.setSpatialNavigationEnabled(
enabled: boolean,
)
מגדיר את מצב הניווט המרחבי של ה-WebView.
פרמטרים
-
boolean
ערך של מצב ניווט מרחבי.
setUserAgentOverride()
chrome.webviewTag.setUserAgentOverride(
userAgent: string,
)
שינוי מחרוזת סוכן המשתמש שמשמשת את webview
עבור בקשות לדפים של אורחים. שינוי כזה יגרום לערכי הכותרת של רמז הלקוח של סוכן המשתמש ולערכים שהוחזרו על ידי navigator.userAgentData
יהיו ריקים בבקשות של דף אורח ששינוי זה יחול עליהן.
פרמטרים
-
userAgent
string
מחרוזת סוכן המשתמש לשימוש.
setZoom()
chrome.webviewTag.setZoom(
zoomFactor: number,
callback?: function,
)
שינוי גורם הזום של הדף. ההיקף וההתמדה של השינוי הזה נקבעים לפי מצב המרחק הנוכחי של ה-WebView (מידע נוסף זמין בכתובת webviewTag.ZoomMode
).
פרמטרים
-
zoomFactor
number
גורם הזום החדש.
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:() => void
setZoomMode()
chrome.webviewTag.setZoomMode(
ZoomMode: ZoomMode,
callback?: function,
)
הגדרת מצב הזום של webview
.
פרמטרים
-
ZoomMode
הגדרת אופן הטיפול בשינוי מרחק התצוגה ב-
webview
. -
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:() => void
stop()
chrome.webviewTag.stop()
אם התהליך יימשך, המערכת תעצור את הטעינה של ניווט webview
הנוכחי.
stopFinding()
chrome.webviewTag.stopFinding(
action?: "clear"
| "keep"
| "activate"
,
)
מסיים את פעילות החיפוש הנוכחית (ניקוי כל ההדגשות) ומבטל את כל בקשות החיפוש שנמצאות בתהליך.
פרמטרים
-
פעולה
אופציונלי
הגדרה זו קובעת מה לעשות עם ההתאמה הפעילה לאחר סיום סשן החיפוש.
clear
ינקה את ההדגשה של ההתאמה הפעילה;keep
ידגיש את ההתאמה הפעילה;activate
ידגיש את ההתאמה הפעילה וידמה לחיצה של משתמש על ההתאמה הזו. פעולת ברירת המחדל היאkeep
.
terminate()
chrome.webviewTag.terminate()
סוגר בכוח את תהליך הרינדור של דף האינטרנט של האורח. זה עשוי להשפיע על כמה תגי webview
באפליקציה הנוכחית אם הם חולקים את אותו תהליך, אבל הוא לא ישפיע על תגי webview
באפליקציות אחרות.
אירועים
close
chrome.webviewTag.close.addListener(
callback: function,
)
מופעל כשחלון האורח מנסה לסגור את עצמו.
הקוד לדוגמה הבא מנווט את webview
אל about:blank
כשהאורח מנסה לסגור את עצמו.
webview.addEventListener('close', function() {
webview.src = 'about:blank';
});
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
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
-
הודעה
string
-
שורה
number
-
sourceId
string
-
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: "alert"
| "confirm"
| "prompt"
, messageText: string, dialog: DialogController) => void-
messageType
-
messageText
string
-
תיבת דו-שיח
-
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
נראה כך:(processID: number, reason: "normal"
| "abnormal"
| "crash"
| "kill"
) => void-
processID
number
-
סיבה
-
findupdate
chrome.webviewTag.findupdate.addListener(
callback: function,
)
מופעל כשיש תוצאות חיפוש חדשות עבור בקשת חיפוש פעילה. זה עשוי לקרות מספר פעמים עבור בקשת חיפוש אחת כאשר נמצאו התאמות.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:(searchText: string, numberOfMatches: number, activeMatchOrdinal: number, selectionRect: SelectionRect, canceled: boolean, finalUpdate: string) => void
-
searchText
string
-
numberOfMatches
number
-
activeMatchOrdinal
number
-
selectionRect
-
בוטלו
boolean
-
finalUpdate
string
-
loadabort
chrome.webviewTag.loadabort.addListener(
callback: function,
)
מופעל כשעומס ברמה העליונה בוטל בלי להתחייב. הודעת שגיאה תודפס במסוף, אלא אם האירוע נמנע כברירת מחדל.
הערה: כשטעינת משאב מבוטלת, בסופו של דבר אירוע loadabort
יבוא אחריו אירוע loadstop
, גם אם כל הטעינות שבוצעו מאז שהאירוע האחרון ב-loadstop
(אם היה כזה) בוטל.
הערה: כאשר טעינה של כתובת URL מסוג about:blank או של כתובת URL של JavaScript מבוטלת, הפונקציה loadabort
מופעלת ואז webview
יעבור אל 'about:blank'.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:(url: string, isTopLevel: boolean, code: number, reason: "ERR_ABORTED"
| "ERR_INVALID_URL"
| "ERR_DISALLOWED_URL_SCHEME"
| "ERR_BLOCKED_BY_CLIENT"
| "ERR_ADDRESS_UNREACHABLE"
| "ERR_EMPTY_RESPONSE"
| "ERR_FILE_NOT_FOUND"
| "ERR_UNKNOWN_URL_SCHEME"
) => void-
כתובת אתר
string
-
isTopLevel
boolean
-
קוד
number
-
סיבה
"ERR_ABORTED"
| "ERR_INVALID_URL"
| "ERR_DISALLOWED_URL_SCHEME"
| "ERR_BLOCKED_BY_CLIENT"
| "ERR_ADDRESS_UNREACHABLE"
| "ERR_EMPTY_BROWSER"
"
-
loadcommit
chrome.webviewTag.loadcommit.addListener(
callback: function,
)
מופעל כשמתבצעת טעינה. זה כולל ניווט בתוך המסמך הנוכחי וטעינות ברמת המסמך המשני, אבל לא כולל טעינות של משאבים אסינכרוניים.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:(url: string, isTopLevel: boolean) => void
-
כתובת אתר
string
-
isTopLevel
boolean
-
loadredirect
chrome.webviewTag.loadredirect.addListener(
callback: function,
)
מופעל כשבקשת טעינה ברמה העליונה הפנתה לכתובת URL אחרת.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:(oldUrl: string, newUrl: string, isTopLevel: boolean) => void
-
oldUrl
string
-
newUrl
string
-
isTopLevel
boolean
-
loadstart
chrome.webviewTag.loadstart.addListener(
callback: function,
)
מופעל כשהטעינה מתחילה.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:(url: string, isTopLevel: boolean) => void
-
כתובת אתר
string
-
isTopLevel
boolean
-
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: "ignore"
| "save_to_disk"
| "current_tab"
| "new_background_tab"
| "new_foreground_tab"
| "new_window"
| "new_popup"
) => void-
חלון
-
targetUrl
string
-
initialWidth
number
-
initialHeight
number
-
name
string
-
windowOpenDisposition
"ignore"
| "Save_to_disk"
| "current_tab"
| "new_background_tab"
| "new_foreground_tab"
| "new_window"
| "new_popup"
-
permissionrequest
chrome.webviewTag.permissionrequest.addListener(
callback: function,
)
מופעל כשדף האורח צריך לבקש הרשאה מיוחדת מהמטמיע.
הקוד לדוגמה הבא יעניק לדף האורח גישה לממשק ה-API של webkitGetUserMedia
. שים לב שאפליקציה שמשתמשת בקוד לדוגמה הזה חייבת לציין בעצמה הרשאות audioCapture
ו/או videoCapture
:
webview.addEventListener('permissionrequest', function(e) {
if (e.permission === 'media') {
e.request.allow();
}
});
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:(permission: "media"
| "geolocation"
| "pointerLock"
| "download"
| "loadplugin"
| "filesystem"
| "fullscreen"
| "hid"
, request: object) => void-
הרשאה
"media"
| "geolocation"
| "pointerLock"
| "download"
| "loadloadin"
| "filesystem"
| "מסך מלא"
| "hid"
-
בקשה
אובייקט
-
responsive
chrome.webviewTag.responsive.addListener(
callback: function,
)
מופעל כשהתהליך של עיבוד תוכן האינטרנט של האורח מגיב שוב לאחר שלא מגיב.
הקוד לדוגמה הבא יחליש את הרכיב webview
פנימה או ישתנה כשהוא מגיב או מגיב:
webview.style.webkitTransition = 'opacity 250ms';
webview.addEventListener('unresponsive', function() {
webview.style.opacity = '0.5';
});
webview.addEventListener('responsive', function() {
webview.style.opacity = '1';
});
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
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
-