chrome.webviewTag

תיאור

צריך להשתמש בתג 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

Chrome 44 ואילך

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

תכונות

  • 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

    מחרוזת

    השם של סקריפט התוכן שיש להחדיר.

  • 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

      מחרוזת

      מציין את המקור של חלון האורח כדי שהאירוע יישלח.

ContextMenuCreateProperties

Chrome 44 ואילך

תכונות

  • בוצע סימון

    בוליאני אופציונלי

    המצב הראשוני של תיבת סימון או פריט רדיו: 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)=> {...}

    • מידע

      OnClickData

      מידע על הפריט שעליו לחץ המשתמש וההקשר שבו התרחש הקליק.

ContextMenus

Chrome 44 ואילך

תכונות

  • 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

    • החזרות

      string|number

      המזהה של הפריט החדש שנוצר.

  • remove

    void

    מסירה אפשרות של תפריט הקשר.

    הפונקציה remove נראית כך: 

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

    • menuItemId

      string|number

      המזהה של האפשרות להסרה בתפריט ההקשר.

    • קריאה חוזרת (callback)

      פונקציה אופציונלי

      הפרמטר callback נראה כך: 

      ()=>void

  • removeAll

    void

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

    הפונקציה removeAll נראית כך: 

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

    • קריאה חוזרת (callback)

      פונקציה אופציונלי

      הפרמטר callback נראה כך: 

      ()=>void

  • update

    void

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

    הפונקציה update נראית כך: 

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

    • id

      string|number

      המזהה של הפריט שצריך לעדכן.

    • updateProperties

      אובייקט

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

    • קריאה חוזרת (callback)

      פונקציה אופציונלי

      הפרמטר callback נראה כך: 

      ()=>void

ContextMenuUpdateProperties

Chrome 44 ואילך

תכונות

  • בוצע סימון

    בוליאני אופציונלי

    המצב של תיבת סימון או פריט רדיו: TRUE לבחירה ו-FALSE אם לא נבחר. ניתן לבחור רק פריט רדיו אחד בכל פעם בקבוצה נתונה של פריטי רדיו.

  • הקשרים

    [ContextType,...ContextType[]] אופציונלי

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

  • documentUrlPatterns

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

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

  • פעיל

    בוליאני אופציונלי

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

  • parentId

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

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

  • targetUrlPatterns

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

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

  • title

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

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

  • סוג

    ItemType אופציונלי

    הסוג של האפשרות בתפריט.

  • onclick

    ביטול אופציונלי

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

    הפונקציה onclick נראית כך: 

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

    • מידע

      OnClickData

      מידע על הפריט שעליו לחץ המשתמש וההקשר שבו התרחש הקליק.

ContextType

Chrome 44 ואילך

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

טיפוסים בני מנייה (enum)

DialogController

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

תכונות

  • ביטול

    void

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

    הפונקציה cancel נראית כך: 

    ()=> {...}

  • אוקיי

    void

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

    הפונקציה ok נראית כך: 

    (response?: string)=> {...}

    • תשובה

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

      מחרוזת התשובה שצריך לספק לאורח כשמאשרים תיבת דו-שיח של prompt.

DownloadPermissionRequest

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

תכונות

  • requestMethod

    מחרוזת

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

  • כתובת אתר

    מחרוזת

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

  • לאפשר

    void

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

    הפונקציה allow נראית כך: 

    ()=> {...}

  • דחייה

    void

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

    הפונקציה deny נראית כך: 

    ()=> {...}

FileSystemPermissionRequest

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

תכונות

  • כתובת אתר

    מחרוזת

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

  • לאפשר

    void

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

    הפונקציה allow נראית כך: 

    ()=> {...}

  • דחייה

    void

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

    הפונקציה deny נראית כך: 

    ()=> {...}

FindCallbackResults

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

תכונות

  • activeMatchOrdinal

    number

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

  • בוטלו

    boolean

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

  • numberOfMatches

    number

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

  • selectionRect

    SelectionRect

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

FindOptions

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

תכונות

  • לאחור

    בוליאני אופציונלי

    מסמנים כדי למצוא התאמות בסדר הפוך. ערך ברירת המחדל הוא false.

  • matchCase

    בוליאני אופציונלי

    סימון להתאמה עם חשיבות לאותיות רישיות (case-sensitivity). ערך ברירת המחדל הוא false.

FullscreenPermissionRequest

Chrome מגרסה 43 ואילך

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

תכונות

  • מקור

    מחרוזת

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

  • לאפשר

    void

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

    הפונקציה allow נראית כך: 

    ()=> {...}

  • דחייה

    void

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

    הפונקציה deny נראית כך: 

    ()=> {...}

GeolocationPermissionRequest

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

תכונות

  • כתובת אתר

    מחרוזת

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

  • לאפשר

    void

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

    הפונקציה allow נראית כך: 

    ()=> {...}

  • דחייה

    void

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

    הפונקציה deny נראית כך: 

    ()=> {...}

HidPermissionRequest

בהמתנה

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

תכונות

  • כתובת אתר

    מחרוזת

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

  • לאפשר

    void

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

    הפונקציה allow נראית כך: 

    ()=> {...}

  • דחייה

    void

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

    הפונקציה deny נראית כך: 

    ()=> {...}

InjectDetails

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

תכונות

  • קוד

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

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

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

  • קובץ

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

    JavaScript או קובץ CSS שיש להחדיר.

InjectionItems

Chrome 44 ואילך

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

תכונות

  • קוד

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

    קוד JavaScript או CSS שיש להחדיר לדפים תואמים.

  • קבצים

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

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

LoadPluginPermissionRequest

סוג האובייקט request שמתלווה לאירוע DOM של loadplugin permissionrequest.

תכונות

  • מזהה

    מחרוזת

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

  • name

    מחרוזת

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

  • לאפשר

    void

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

    הפונקציה allow נראית כך: 

    ()=> {...}

  • דחייה

    void

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

    הפונקציה deny נראית כך: 

    ()=> {...}

MediaPermissionRequest

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

תכונות

  • כתובת אתר

    מחרוזת

    כתובת ה-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

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

  • כתובת אתר

    מחרוזת

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

  • userGesture

    boolean

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

  • לאפשר

    void

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

    הפונקציה allow נראית כך: 

    ()=> {...}

  • דחייה

    void

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

    הפונקציה deny נראית כך: 

    ()=> {...}

SelectionRect

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

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

תכונות

  • גובה

    number

    גובה המלבן.

  • שמאלה

    number

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

  • ראשונה

    number

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

  • רוחב

    number

    רוחב המלבן.

WebRequestEventInterface

Chrome 44 ואילך

ממשק שמספק גישה לאירועי 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

Chrome מגרסה 43 ואילך

הגדרת אופן הטיפול בשינוי מרחק התצוגה ב-webview.

טיפוסים בני מנייה (enum)

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

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

"disabled"
השבתת כל שינוי מרחק התצוגה ב-WebView. התוכן יחזור לרמת ברירת המחדל של מרחק התצוגה והמערכת תתעלם מכל ניסיון לשינוי מרחק התצוגה.

תכונות

contentWindow

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

סוג

ContentWindow

contextMenus

Chrome 44 ואילך

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

סוג

ContextMenus

request

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

סוג

WebRequestEventInterface

שיטות

addContentScripts()

Chrome 44 ואילך 
chrome.webviewTag.addContentScripts(
  contentScriptList: [ContentScriptDetails,...ContentScriptDetails[]],
)

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

בדוגמה הבאה מוסיפים שני כללים למאפיין webview: 'myRule' ו-'anotherRule'.

webview.addContentScripts([
  {
    name: 'myRule',
    matches: ['http://www.foo.com/*'],
    css: { files: ['mystyles.css'] },
    js: { files: ['jquery.js', 'myscript.js'] },
    run_at: 'document_start'
  },
  {
    name: 'anotherRule',
    matches: ['http://www.bar.com/*'],
    js: { code: "document.body.style.backgroundColor = 'red';" },
    run_at: 'document_end'
  }]);
 ...

// Navigates webview.
webview.src = 'http://www.foo.com';

ניתן לדחות את הקריאה ל-addContentScripts עד שיהיה צורך להחדיר סקריפטים.

הדוגמה הבאה מראה איך להחליף כלל קיים.

webview.addContentScripts([{
    name: 'rule',
    matches: ['http://www.foo.com/*'],
    js: { files: ['scriptA.js'] },
    run_at: 'document_start'}]);

// Do something.
webview.src = 'http://www.foo.com/*';
 ...
// Overwrite 'rule' defined before.
webview.addContentScripts([{
    name: 'rule',
    matches: ['http://www.bar.com/*'],
    js: { files: ['scriptB.js'] },
    run_at: 'document_end'}]);

אם webview נווט אל המקור (לדוגמה, foo.com) וקורא ל-webview.addContentScripts כדי להוסיף את 'myRule', עליך להמתין לניווט הבא כדי לאפשר את הוספת הסקריפטים. אם ברצונך לקבל הזרקה מיידית, executeScript יעשה את הפעולה הנכונה.

הכללים נשמרים גם אם תהליך האורח קורס או נהרג, או גם אם קיימת הורה חדש ל-webview.

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

פרמטרים

back()

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

מנווט אחורה ברשומת היסטוריה אחת אם אפשר. שווה ערך ל-go(-1).

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה אופציונלי

    Chrome 44 ואילך

    הפרמטר callback נראה כך: 

    (success: boolean)=>void

    • הצלחה

      boolean

      מציין אם הניווט בוצע בהצלחה.

canGoBack()

chrome.webviewTag.canGoBack()

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

החזרות

  • boolean

canGoForward()

chrome.webviewTag.canGoForward()

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

החזרות

  • boolean

captureVisibleRegion()

Chrome מגרסה 50 ואילך 
chrome.webviewTag.captureVisibleRegion(
  options?: ImageDetails,
  callback: function,
)

לוכד את האזור הגלוי של ה-WebView.

פרמטרים

  • אפשרויות

    ImageDetails אופציונלי

  • קריאה חוזרת (callback)

    פונקציה

    הפרמטר callback נראה כך: 

    (dataUrl: string)=>void

    • dataUrl

      מחרוזת

      כתובת URL של נתונים שמקודדת תמונה של האזור הגלוי בכרטיסייה שצולמה. להיות מוקצה למאפיין 'src' של רכיב HTML של תמונה לתצוגה.

clearData()

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

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

פרמטרים

  • אפשרויות

    ClearDataOptions

    אפשרויות שקובעות אילו נתונים לנקות.

  • סוגים

    ClearDataTypeSet

    סוגי הנתונים שיש לנקות.

  • קריאה חוזרת (callback)

    פונקציה אופציונלי

    הפרמטר callback נראה כך: 

    ()=>void

executeScript()

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

מחדיר קוד JavaScript לדף האורח.

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

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

פרמטרים

  • פרטים

    InjectDetails

    פרטי הסקריפט שצריך להריץ.

  • קריאה חוזרת (callback)

    פונקציה אופציונלי

    הפרמטר callback נראה כך: 

    (result?: any[])=>void

    • תוצאה אחת

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

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

find()

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

מפעיל בקשת 'חיפוש בדף'.

פרמטרים

  • searchText

    מחרוזת

    המחרוזת שיש למצוא בדף.

  • אפשרויות

    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 62 ומעלה 
chrome.webviewTag.getAudioState(
  callback: function,
)

מצב אודיו של שאילתה.

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה

    הפרמטר callback נראה כך: 

    (audible: boolean)=>void

    • audible, אודיבל

      boolean

getProcessId()

chrome.webviewTag.getProcessId()

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

החזרות

  • number

getUserAgent()

chrome.webviewTag.getUserAgent()

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

החזרות

  • מחרוזת

getZoom()

chrome.webviewTag.getZoom(
  callback: function,
)

הפונקציה מקבלת את גורם הזום הנוכחי.

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה

    הפרמטר callback נראה כך: 

    (zoomFactor: number)=>void

    • zoomFactor

      number

      גורם הזום הנוכחי.

getZoomMode()

Chrome מגרסה 43 ואילך 
chrome.webviewTag.getZoomMode(
  callback: function,
)

מקבלת את מצב הזום הנוכחי.

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה

    הפרמטר callback נראה כך: 

    (ZoomMode: ZoomMode)=>void

    • ZoomMode

      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 לדף האורח.

פרמטרים

  • פרטים

    InjectDetails

    פרטים לגבי שירות ה-CSS להוספה.

  • קריאה חוזרת (callback)

    פונקציה אופציונלי

    הפרמטר callback נראה כך: 

    ()=>void

isAudioMuted()

Chrome 62 ומעלה 
chrome.webviewTag.isAudioMuted(
  callback: function,
)

שאילתות לגבי אודיו מושתק.

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה

    הפרמטר callback נראה כך: 

    (muted: boolean)=>void

    • מושתק

      boolean

isSpatialNavigationEnabled()

Chrome 71 ומעלה 
chrome.webviewTag.isSpatialNavigationEnabled(
  callback: function,
)

שאילתות לגבי הפעלת ניווט מרחבי ב-WebView.

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה

    הפרמטר 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

    מחרוזת

    כתובת ה-URL של הנתונים לטעינה.

  • baseUrl

    מחרוזת

    כתובת ה-URL הבסיסית שתשמש לקישורים יחסיים.

  • virtualUrl

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

    כתובת ה-URL שתוצג למשתמש (בסרגל הכתובות).

print()

chrome.webviewTag.print()

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

reload()

chrome.webviewTag.reload()

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

removeContentScripts()

Chrome 44 ואילך 
chrome.webviewTag.removeContentScripts(
  scriptNameList?: string[],
)

מסיר סקריפטים של תוכן מ-webview.

הדוגמה הבאה מסירה את "myRule" שנוסף לפני כן.

webview.removeContentScripts(['myRule']);

כדי להסיר את כל הכללים, צריך לבצע את הפעולות הבאות:

webview.removeContentScripts();

פרמטרים

  • scriptNameList

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

    רשימת השמות של סקריפטים של תוכן שיוסרו. אם הרשימה ריקה, כל הסקריפטים של התוכן שנוספו אל webview יוסרו.

setAudioMuted()

Chrome 62 ומעלה 
chrome.webviewTag.setAudioMuted(
  mute: boolean,
)

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

פרמטרים

  • השתקה

    boolean

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

setSpatialNavigationEnabled()

Chrome 71 ומעלה 
chrome.webviewTag.setSpatialNavigationEnabled(
  enabled: boolean,
)

מגדיר את מצב הניווט המרחבי של ה-WebView.

פרמטרים

  • פעיל

    boolean

    ערך של מצב ניווט מרחבי.

setUserAgentOverride()

chrome.webviewTag.setUserAgentOverride(
  userAgent: string,
)

שינוי מחרוזת סוכן המשתמש שמשמשת את webview עבור בקשות לדפים של אורחים. שינוי כזה יגרום לערכי הכותרת של רמז הלקוח של סוכן המשתמש ולערכים שהוחזרו על ידי navigator.userAgentData יהיו ריקים בבקשות של דף אורח ששינוי זה יחול עליהן.

פרמטרים

  • userAgent

    מחרוזת

    מחרוזת סוכן המשתמש לשימוש.

setZoom()

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

שינוי גורם הזום של הדף. ההיקף וההתמדה של השינוי הזה נקבעים לפי מצב המרחק הנוכחי של ה-WebView (מידע נוסף זמין בכתובת webviewTag.ZoomMode).

פרמטרים

  • zoomFactor

    number

    גורם הזום החדש.

  • קריאה חוזרת (callback)

    פונקציה אופציונלי

    הפרמטר callback נראה כך: 

    ()=>void

setZoomMode()

Chrome מגרסה 43 ואילך 
chrome.webviewTag.setZoomMode(
  ZoomMode: ZoomMode,
  callback?: function,
)

הגדרת מצב הזום של webview.

פרמטרים

  • ZoomMode

    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

    • הודעה

      מחרוזת

    • שורה

      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: "alert" 
     |"confirm" 
     |"prompt" 
     ,messageText: string,dialog: DialogController)=>void

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

      מחרוזת

    • numberOfMatches

      number

    • activeMatchOrdinal

      number

    • selectionRect

      SelectionRect

    • בוטלו

      boolean

    • finalUpdate

      מחרוזת

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

    • כתובת אתר

      מחרוזת

    • isTopLevel

      boolean

    • קוד

      number

    • סיבה

      "ERR_ABORTED"
      |"ERR_INVALID_URL"
      |"ERR_DISALLOWED_URL_SCHEME"
      |"ERR_BLOCKED_BY_CLIENT"
      |"ERR_ADDRESS_UNREACHABLE"
      |"ERR_EMPTY_Response"
      |"KERR_FILE"_REMOVE_URL
      |"KERR_FILE_"_Comment

loadcommit

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

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

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה

    הפרמטר callback נראה כך: 

    (url: string,isTopLevel: boolean)=>void

    • כתובת אתר

      מחרוזת

    • isTopLevel

      boolean

loadredirect

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

מופעל כשבקשת טעינה ברמה העליונה הפנתה לכתובת URL אחרת.

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה

    הפרמטר callback נראה כך: 

    (oldUrl: string,newUrl: string,isTopLevel: boolean)=>void

    • oldUrl

      מחרוזת

    • newUrl

      מחרוזת

    • isTopLevel

      boolean

loadstart

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

מופעל כשהטעינה מתחילה.

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה

    הפרמטר callback נראה כך: 

    (url: string,isTopLevel: boolean)=>void

    • כתובת אתר

      מחרוזת

    • 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

    • חלון

      NewWindow

    • targetUrl

      מחרוזת

    • initialWidth

      number

    • initialHeight

      number

    • name

      מחרוזת

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