chrome.webviewTag

Beschreibung

Mit dem webview-Tag können Sie Live-Inhalte aus dem Web über das Netzwerk laden und in Ihre Chrome-App einbetten. Ihre App kann das Aussehen des webview-Tags steuern und mit den Web-Inhalten interagieren, Navigationen auf einer eingebetteten Webseite initiieren und auf Fehlerereignisse reagieren, die darin auftreten. Weitere Informationen finden Sie unter Verwendung.

Berechtigungen

webview

Typen

ClearDataOptions

Optionen, mit denen festgelegt wird, welche Daten von clearData gelöscht werden sollen.

Attribute

  • seit

    number optional

    Löschen Sie Daten, die an oder nach diesem Datum erfasst wurden. Das Datum wird in Millisekunden seit der Epochzeit angegeben und ist über die Methode „getTime“ des JavaScript-Objekts Date zugänglich. Wenn nicht angegeben, wird standardmäßig 0 verwendet (wodurch alle Browserdaten entfernt werden).

ClearDataTypeSet

Eine Reihe von Datentypen. Fehlende Attribute werden als false interpretiert.

Attribute

  • appcache

    boolean optional

    App-Caches von Websites.

  • Cache

    boolean optional

    Chrome 44 und höher

    Seit Chrome 43. Der Cache des Browsers. Hinweis: Wenn Sie Daten entfernen, wird der gesamte Cache geleert. Das ist nicht auf den von Ihnen angegebenen Bereich beschränkt.

  • Cookies

    boolean optional

    Die Cookies der Partition.

  • fileSystems

    boolean optional

    Dateisysteme von Websites.

  • indexedDB

    boolean optional

    IndexedDB-Daten von Websites.

  • localStorage

    boolean optional

    Daten im lokalen Speicher von Websites.

  • persistentCookies

    boolean optional

    Chrome 58 und höher

    Die persistenten Cookies der Partition.

  • sessionCookies

    boolean optional

    Chrome 58 und höher

    Die Sitzungscookies der Partition.

  • webSQL

    boolean optional

    WebSQL-Daten von Websites.

ContentScriptDetails

Chrome 44 und höher

Details zum einzufügenden Inhaltsskript. Weitere Informationen finden Sie in der Dokumentation zu Inhaltsskripts.

Attribute

  • all_frames

    boolean optional

    Wenn all_frames gleich true ist, bedeutet das, dass das JavaScript oder CSS in alle Frames der aktuellen Seite eingefügt werden soll. Standardmäßig ist all_frames auf false festgelegt und das JavaScript oder CSS wird nur in den obersten Frame eingefügt.

  • css

    InjectionItems optional

    Der CSS-Code oder eine Liste von CSS-Dateien, die in übereinstimmende Seiten eingefügt werden sollen. Sie werden in der Reihenfolge eingefügt, in der sie angezeigt werden, bevor ein DOM für die Seite erstellt oder angezeigt wird.

  • exclude_globs

    string[] optional

    Wird nach Übereinstimmungen angewendet, um URLs auszuschließen, die mit diesem Glob übereinstimmen. Soll das Greasemonkey-Keyword „@exclude“ emulieren.

  • exclude_matches

    string[] optional

    Schließt Seiten aus, in die dieses Inhaltsscript ansonsten eingefügt würde.

  • include_globs

    string[] optional

    Wird nach Übereinstimmungen angewendet, um nur die URLs einzuschließen, die auch mit diesem Glob übereinstimmen. Soll das Greasemonkey-Schlüsselwort „@include“ emulieren.

  • js

    InjectionItems optional

    Der JavaScript-Code oder eine Liste von JavaScript-Dateien, die in übereinstimmende Seiten eingefügt werden sollen. Sie werden in der Reihenfolge eingefügt, in der sie angezeigt werden.

  • match_about_blank

    boolean optional

    Gibt an, ob das Content-Script in „about:blank“ und „about:srcdoc“ eingefügt werden soll. Content-Scripts werden nur auf Seiten eingefügt, deren übergeordnete URL mit einem der deklarierten Muster im Feld „matches“ übereinstimmt. Die Inherit-URL ist die URL des Dokuments, in dem der Frame oder das Fenster erstellt wurde. Content-Scripts können nicht in Sandboxed-Frames eingefügt werden.

  • stimmt überein mit

    String[]

    Gibt an, auf welchen Seiten dieses Inhaltsscript eingefügt wird.

  • name

    String

    Der Name des einzufügenden Content-Scripts.

  • run_at

    RunAt optional

    Der frühestmögliche Zeitpunkt, zu dem das JavaScript oder CSS in den Tab eingefügt wird. Der Standardwert ist „document_idle“.

ContentWindow

Messaging-Handle für ein Gastfenster.

Attribute

  • postMessage

    void

    Sendet eine Nachricht an die eingebetteten Webinhalte, sofern die eingebetteten Inhalte eine Seite aus dem Zielursprung anzeigen. Diese Methode ist verfügbar, sobald die Seite vollständig geladen wurde. Warten Sie auf das Ereignis contentload und rufen Sie dann die Methode auf.

    Der Gast kann dem Einbettenden antworten, indem er eine Nachricht an event.source im empfangenen Nachrichtenereignis sendet.

    Diese API ist mit der HTML5-postMessage-API für die Kommunikation zwischen Webseiten identisch. Der Einbettungscode kann auf Antworten warten, indem er seinem eigenen Frame einen message-Event-Listener hinzufügt.

    Die postMessage-Funktion sieht so aus: 

    (message: any, targetOrigin: string) => {...}

    • Nachricht

      beliebig

      Nachrichtenobjekt, das an den Gast gesendet werden soll.

    • targetOrigin

      String

      Gibt an, woher das Gastfenster stammen muss, damit das Ereignis gesendet wird.

ContextMenuCreateProperties

Chrome 44 und höher

Attribute

  • ausgewählt

    boolean optional

    Der Anfangsstatus eines Kontrollkästchens oder Optionsfelds: „true“ für ausgewählt und „false“ für nicht ausgewählt. In einer Gruppe von Optionsfeldern kann jeweils nur ein Optionsfeld ausgewählt werden.

  • contexts

    [ContextType, ...ContextType[]] optional

    Liste der Kontexte, in denen dieses Menüelement angezeigt wird. Wenn keine Angabe erfolgt, wird standardmäßig ['page'] verwendet.

  • documentUrlPatterns

    string[] optional

    Damit können Sie das Element auf Dokumente beschränken, deren URL mit einem der angegebenen Muster übereinstimmt. Das gilt auch für Frames. Weitere Informationen zum Format eines Musters finden Sie unter Übereinstimmungsmuster.

  • aktiviert

    boolean optional

    Gibt an, ob dieses Kontextmenüelement aktiviert oder deaktiviert ist. Die Standardeinstellung ist true.

  • id

    String optional

    Die eindeutige ID, die diesem Artikel zugewiesen werden soll. Für Veranstaltungsseiten erforderlich. Darf nicht mit einer anderen ID für diese Erweiterung übereinstimmen.

  • parentId

    String | Zahl optional

    Die ID eines übergeordneten Menüpunkts. Dadurch wird das Element zu einem untergeordneten Element eines zuvor hinzugefügten Elements.

  • targetUrlPatterns

    string[] optional

    Ähnlich wie „documentUrlPatterns“, aber Sie können nach dem src-Attribut von img-/audio-/video-Tags und dem href von Anker-Tags filtern.

  • Titel

    String optional

    Der im Element anzuzeigende Text. Dieser Parameter ist erforderlich, sofern type nicht „separator“ ist. Wenn der Kontext „selection“ ist, können Sie %s im String verwenden, um den ausgewählten Text anzuzeigen. Wenn der Wert dieses Parameters beispielsweise „Übersetze ‚%s‘ ins Lateinische“ lautet und der Nutzer das Wort „cool“ auswählt, lautet der Kontextmenüpunkt für die Auswahl „Übersetze ‚cool‘ ins Lateinische“.

  • Typ

    ItemType optional

    Der Typ des Menüpunkts. Wenn keine Angabe erfolgt, wird der Standardwert „normal“ verwendet.

  • onclick

    void optional

    Eine Funktion, die aufgerufen wird, wenn auf das Menüelement geklickt wird.

    Die onclick-Funktion sieht so aus: 

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

    • Informationen zum angeklickten Element und zum Kontext, in dem der Klick erfolgt ist.

ContextMenus

Chrome 44 und höher

Attribute

  • onShow

    Event<functionvoidvoid>

    Wird ausgelöst, bevor ein Kontextmenü für diese webview angezeigt wird. Kann verwendet werden, um dieses Kontextmenü durch Aufrufen von event.preventDefault() zu deaktivieren.

    Die onShow.addListener-Funktion sieht so aus: 

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

    • callback

      Funktion

      Der Parameter callback sieht so aus: 

      (event: object) => void

      • event

        Objekt

        • preventDefault

          void

          Rufen Sie diese Funktion auf, um das Anzeigen des Kontextmenüs zu verhindern.

          Die preventDefault-Funktion sieht so aus: 

          () => {...}

  • create

    void

    Erstellt ein neues Kontextmenüelement. Wenn bei der Erstellung ein Fehler auftritt, erfahren Sie das möglicherweise erst, wenn der Erstellungs-Callback ausgelöst wird. Die Details finden Sie in runtime.lastError.

    Die create-Funktion sieht so aus: 

    (createProperties: object, callback?: function) => {...}

    • createProperties

      Objekt

      Die zum Erstellen des Artikels verwendeten Attribute

    • callback

      Funktion optional

      Der Parameter callback sieht so aus: 

      () => void

    • Gibt zurück

      String | Zahl

      Die ID des neu erstellten Elements.

  • Entfernen

    void

    Entfernt ein Kontextmenüelement.

    Die remove-Funktion sieht so aus: 

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

    • menuItemId

      String | Zahl

      Die ID des zu entfernenden Kontextmenüelements.

    • callback

      Funktion optional

      Der Parameter callback sieht so aus: 

      () => void

  • removeAll

    void

    Entfernt alle Kontextmenüelemente, die diesem webview hinzugefügt wurden.

    Die removeAll-Funktion sieht so aus: 

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

    • callback

      Funktion optional

      Der Parameter callback sieht so aus: 

      () => void

  • update

    void

    Aktualisiert ein zuvor erstelltes Kontextmenüelement.

    Die update-Funktion sieht so aus: 

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

    • id

      String | Zahl

      Die ID des zu aktualisierenden Artikels.

    • updateProperties

      Objekt

      Die zu aktualisierenden Attribute. Akzeptiert dieselben Werte wie die Funktion „create“.

    • callback

      Funktion optional

      Der Parameter callback sieht so aus: 

      () => void

ContextMenuUpdateProperties

Chrome 44 und höher

Attribute

  • ausgewählt

    boolean optional

    Der Status eines Kontrollkästchens oder Optionsfelds: „true“ für ausgewählt und „false“ für nicht ausgewählt. In einer Gruppe von Optionsfeldern kann jeweils nur ein Optionsfeld ausgewählt werden.

  • contexts

    [ContextType, ...ContextType[]] optional

    Liste der Kontexte, in denen dieses Menüelement angezeigt wird.

  • documentUrlPatterns

    string[] optional

    Damit können Sie das Element auf Dokumente beschränken, deren URL mit einem der angegebenen Muster übereinstimmt. Das gilt auch für Frames. Weitere Informationen zum Format eines Musters finden Sie unter Übereinstimmungsmuster.

  • aktiviert

    boolean optional

    Gibt an, ob dieses Kontextmenüelement aktiviert oder deaktiviert ist.

  • parentId

    String | Zahl optional

    Die ID eines übergeordneten Menüpunkts. Dadurch wird das Element zu einem untergeordneten Element eines zuvor hinzugefügten Elements. Hinweis:Sie können ein Element nicht zu einem untergeordneten Element eines seiner eigenen untergeordneten Elemente machen.

  • targetUrlPatterns

    string[] optional

    Ähnlich wie „documentUrlPatterns“, aber Sie können nach dem src-Attribut von img-/audio-/video-Tags und dem href von Anker-Tags filtern.

  • Titel

    String optional

    Der im Element anzuzeigende Text

  • Typ

    ItemType optional

    Der Typ des Menüpunkts.

  • onclick

    void optional

    Eine Funktion, die aufgerufen wird, wenn auf das Menüelement geklickt wird.

    Die onclick-Funktion sieht so aus: 

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

    • Informationen zum angeklickten Element und zum Kontext, in dem der Klick erfolgt ist.

ContextType

Chrome 44 und höher

Die verschiedenen Kontexte, in denen ein Menü angezeigt werden kann. Die Angabe von „all“ entspricht der Kombination aller anderen Kontexte.

Enum

"all"

"page"

"frame"

"selection"

"link"

"editable"

"image"

"video"

"audio"

DialogController

Schnittstelle, die an dialog-DOM-Ereignisse angehängt ist.

Attribute

  • Abbrechen

    void

    Lehnen Sie das Dialogfeld ab. Entspricht dem Klicken auf „Abbrechen“ in einem confirm- oder prompt-Dialogfeld.

    Die cancel-Funktion sieht so aus: 

    () => {...}

  • Ok

    void

    Bestätigen Sie den Dialog. Entspricht dem Klicken auf „OK“ in einem Dialogfeld vom Typ alert, confirm oder prompt.

    Die ok-Funktion sieht so aus: 

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

    • Antwort

      String optional

      Der Antwortstring, der dem Gast bei Annahme eines prompt-Dialogfelds zur Verfügung gestellt werden soll.

DialogMessageType

Ausstehend

Der vom Gast angeforderte Typ des Modalfensters.

Enum

"alert"

„confirm“

"prompt"

DownloadPermissionRequest

Der Typ des request-Objekts, das ein download-DOM-Ereignis vom Typ permissionrequest begleitet.

Attribute

  • requestMethod

    String

    Der HTTP-Anfragetyp (z.B. GET), der der Downloadanfrage zugeordnet ist.

  • URL

    String

    Die angeforderte Download-URL.

  • allow

    void

    Erlauben Sie die Berechtigungsanfrage.

    Die allow-Funktion sieht so aus: 

    () => {...}

  • deny

    void

    Lehnen Sie die Berechtigungsanfrage ab. Das ist das Standardverhalten, wenn allow nicht aufgerufen wird.

    Die deny-Funktion sieht so aus: 

    () => {...}

ExitReason

Ausstehend

String, der den Grund für das Beenden angibt.

Enum

"normal"

„abnormal“

„crashed“

"killed"

„oom killed“

"oom"

„Fehler beim Starten“

„Integritätsfehler“

FileSystemPermissionRequest

Der Typ des request-Objekts, das ein filesystem-DOM-Ereignis vom Typ permissionrequest begleitet.

Attribute

  • URL

    String

    Die URL des Frames, der Zugriff auf das lokale Dateisystem anfordert.

  • allow

    void

    Erlauben Sie die Berechtigungsanfrage.

    Die allow-Funktion sieht so aus: 

    () => {...}

  • deny

    void

    Lehnen Sie die Berechtigungsanfrage ab.

    Die deny-Funktion sieht so aus: 

    () => {...}

FindCallbackResults

Enthält alle Ergebnisse der Suchanfrage.

Attribute

  • activeMatchOrdinal

    Zahl

    Die Ordnungszahl des aktuellen Spiels.

  • abgebrochen

    boolean

    Gibt an, ob diese Suchanfrage abgebrochen wurde.

  • numberOfMatches

    Zahl

    Die Anzahl der Übereinstimmungen von searchText auf der Seite.

  • selectionRect

    SelectionRect

    Beschreibt ein Rechteck um die aktive Übereinstimmung in Bildschirmkoordinaten.

FindOptions

Optionen für die Suchanfrage.

Attribute

  • rückwärts

    boolean optional

    Flagge, um Übereinstimmungen in umgekehrter Reihenfolge zu finden. Der Standardwert ist false.

  • matchCase

    boolean optional

    Flagge für den Abgleich unter Berücksichtigung der Groß-/Kleinschreibung. Der Standardwert ist false.

FullscreenPermissionRequest

Chrome 43 und höher

Der Typ des request-Objekts, das ein fullscreen-DOM-Ereignis vom Typ permissionrequest begleitet.

Attribute

  • origin

    String

    Der Ursprung des Frames innerhalb des webview, der die Vollbildanfrage ausgelöst hat.

  • allow

    void

    Erlauben Sie die Berechtigungsanfrage.

    Die allow-Funktion sieht so aus: 

    () => {...}

  • deny

    void

    Lehnen Sie die Berechtigungsanfrage ab.

    Die deny-Funktion sieht so aus: 

    () => {...}

GeolocationPermissionRequest

Der Typ des request-Objekts, das ein geolocation-DOM-Ereignis vom Typ permissionrequest begleitet.

Attribute

  • URL

    String

    Die URL des Frames, der Zugriff auf Standortdaten anfordert.

  • allow

    void

    Erlauben Sie die Berechtigungsanfrage.

    Die allow-Funktion sieht so aus: 

    () => {...}

  • deny

    void

    Lehnen Sie die Berechtigungsanfrage ab. Das ist das Standardverhalten, wenn allow nicht aufgerufen wird.

    Die deny-Funktion sieht so aus: 

    () => {...}

HidPermissionRequest

Chrome 125 und höher

Der Typ des request-Objekts, das ein hid-DOM-Ereignis vom Typ permissionrequest begleitet.

Attribute

  • URL

    String

    Die URL des Frames, der Zugriff auf die HID API anfordert.

  • allow

    void

    Erlauben Sie die Berechtigungsanfrage.

    Die allow-Funktion sieht so aus: 

    () => {...}

  • deny

    void

    Lehnen Sie die Berechtigungsanfrage ab. Das ist das Standardverhalten, wenn allow nicht aufgerufen wird.

    Die deny-Funktion sieht so aus: 

    () => {...}

InjectDetails

Details zum einzufügenden Skript oder CSS. Entweder muss der Code oder die Dateieigenschaft festgelegt werden, aber nicht beides gleichzeitig.

Attribute

  • Code

    String optional

    JavaScript- oder CSS-Code, der eingefügt werden soll.

    Warnung:Verwenden Sie den Parameter code mit Bedacht. Eine falsche Verwendung kann Ihre App für Cross-Site-Scripting-Angriffe anfällig machen.

  • Datei

    String optional

    JavaScript- oder CSS-Datei, die eingefügt werden soll.

InjectionItems

Chrome 44 und höher

Der Typ des einzufügenden Elements: Code oder eine Gruppe von Dateien.

Attribute

  • Code

    String optional

    JavaScript-Code oder CSS, der in übereinstimmende Seiten eingefügt werden soll.

  • Dateien

    string[] optional

    Die Liste der JavaScript- oder CSS-Dateien, die in übereinstimmende Seiten eingefügt werden sollen. Sie werden in der Reihenfolge eingefügt, in der sie in diesem Array aufgeführt sind.

LoadAbortReason

Ausstehend

String, der angibt, welche Art von Abbruch aufgetreten ist. Es wird nicht garantiert, dass dieser String zwischen den Releases abwärtskompatibel bleibt. Sie dürfen den Inhalt nicht parsen und darauf basierende Aktionen ausführen. Es ist auch möglich, dass in einigen Fällen ein hier nicht aufgeführter Fehler gemeldet wird.

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

Der Typ des request-Objekts, das ein loadplugin-DOM-Ereignis vom Typ permissionrequest begleitet.

Attribute

  • identifier

    String

    Der Kennzeichnungsstring des Plug‑ins.

  • name

    String

    Der Anzeigename des Plug‑ins.

  • allow

    void

    Erlauben Sie die Berechtigungsanfrage. Dies ist das Standardverhalten, wenn deny nicht aufgerufen wird.

    Die allow-Funktion sieht so aus: 

    () => {...}

  • deny

    void

    Lehnen Sie die Berechtigungsanfrage ab.

    Die deny-Funktion sieht so aus: 

    () => {...}

MediaPermissionRequest

Der Typ des request-Objekts, das ein media-DOM-Ereignis vom Typ permissionrequest begleitet.

Attribute

  • URL

    String

    Die URL des Frames, der Zugriff auf Nutzermedien anfordert.

  • allow

    void

    Erlauben Sie die Berechtigungsanfrage.

    Die allow-Funktion sieht so aus: 

    () => {...}

  • deny

    void

    Lehnen Sie die Berechtigungsanfrage ab. Das ist das Standardverhalten, wenn allow nicht aufgerufen wird.

    Die deny-Funktion sieht so aus: 

    () => {...}

NewWindow

Schnittstelle, die an newwindow-DOM-Ereignisse angehängt ist.

Attribute

  • anhängen

    void

    Hängen Sie die angeforderte Zielseite an ein vorhandenes webview-Element an.

    Die attach-Funktion sieht so aus: 

    (webview: object) => {...}

    • webview

      Objekt

      Das webview-Element, an das die Zielseite angehängt werden soll.

  • Verwerfen

    void

    Brechen Sie die Anfrage für das neue Fenster ab.

    Die discard-Funktion sieht so aus: 

    () => {...}

PermissionType

Ausstehend

Die Art der angeforderten Berechtigung.

Enum

"media"

"geolocation"

"pointerLock"

"download"

"loadplugin"

"filesystem"

"fullscreen"

"hid"

PointerLockPermissionRequest

Der Typ des request-Objekts, das ein pointerLock-DOM-Ereignis vom Typ permissionrequest begleitet.

Attribute

  • lastUnlockedBySelf

    boolean

    Gibt an, ob der anfragende Frame der letzte Client war, der die Zeigerfixierung hatte.

  • URL

    String

    Die URL des Frames, der die Zeigerfixierung anfordert.

  • userGesture

    boolean

    Gibt an, ob die Zeigerfixierung aufgrund einer Nutzereingabe angefordert wurde.

  • allow

    void

    Erlauben Sie die Berechtigungsanfrage.

    Die allow-Funktion sieht so aus: 

    () => {...}

  • deny

    void

    Lehnen Sie die Berechtigungsanfrage ab. Das ist das Standardverhalten, wenn allow nicht aufgerufen wird.

    Die deny-Funktion sieht so aus: 

    () => {...}

SelectionRect

Beschreibt ein Rechteck in Bildschirmkoordinaten.

Die Containment-Semantik ist arrayähnlich. Das bedeutet, dass die Koordinate (left, top) als im Rechteck enthalten betrachtet wird, die Koordinate (left + width, top) jedoch nicht.

Attribute

  • Höhe

    Zahl

    Höhe des Rechtecks.

  • links

    Zahl

    Abstand vom linken Bildschirmrand zum linken Rand des Rechtecks.

  • oben

    Zahl

    Abstand vom oberen Bildschirmrand zum oberen Rand des Rechtecks.

  • Breite

    Zahl

    Breite des Rechtecks.

StopFindingAction

Ausstehend

Bestimmt, was mit dem aktiven Spiel nach dem Ende der Suchsitzung geschehen soll. clear entfernt die Hervorhebung der aktiven Übereinstimmung, keep behält die Hervorhebung der aktiven Übereinstimmung bei und activate behält die Hervorhebung der aktiven Übereinstimmung bei und simuliert einen Nutzerklick auf diese Übereinstimmung. Die Standardaktion ist keep.

Enum

„clear“

"keep"

„activate“

WebRequestEventInterface

Chrome 44 und höher

Schnittstelle, die Zugriff auf webRequest-Ereignisse auf der Gastseite bietet. Weitere Informationen zum Lebenszyklus von webRequest und zugehörigen Konzepten finden Sie in der chrome.webRequest-Erweiterungs-API. Hinweis: Das Ereignis chrome.webRequest.onActionIgnored wird für Webviews nicht unterstützt.

Das folgende Beispiel zeigt, wie sich die Nutzung von der webRequest API für Erweiterungen unterscheidet. Der Beispielcode blockiert alle Gastanfragen für URLs, die mit *://www.evil.com/* übereinstimmen:

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

Außerdem werden über die Ereignisse onRequest und onMessage deklarative webRequest-Regeln unterstützt. Weitere Informationen zur API finden Sie unter declarativeWebRequest.

Bedingungen und Aktionen für deklarative webview-webRequests müssen von ihren chrome.webViewRequest.*-Entsprechungen instanziiert werden. Im folgenden Beispielcode werden alle Anfragen an "example.com" in der WebView myWebview deklarativ blockiert:

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

WindowOpenDisposition

Ausstehend

Die angeforderte Position des neuen Fensters.

Enum

"ignore"

"save_to_disk"

"current_tab"

"new_background_tab"

"new_foreground_tab"

"new_window"

"new_popup"

ZoomMode

Chrome 43 und höher

Definiert, wie das Zoomen in der webview gehandhabt wird.

Enum

„per-origin“
Zoomänderungen bleiben im Ursprung der gezoomten Seite erhalten. Das bedeutet, dass alle anderen Webviews in derselben Partition, die zu diesem Ursprung navigieren, ebenfalls gezoomt werden. Außerdem werden per-origin-Zoomänderungen mit der Quelle gespeichert. Wenn Sie also zu anderen Seiten in derselben Quelle wechseln, wird für alle Seiten derselbe Zoomfaktor verwendet.

„per-view“
Zoomänderungen werden nur in dieser WebView übernommen. Zoomänderungen in anderen WebViews haben keine Auswirkungen auf das Zoomen in dieser WebView. Außerdem werden per-view-Zoomänderungen bei der Navigation zurückgesetzt. Beim Navigieren in einer Webview werden Seiten immer mit ihren ursprungsbezogenen Zoomfaktoren (im Rahmen der Partition) geladen.

disabled
Deaktiviert das Zoomen in der Webansicht. Der Inhalt wird auf die Standardzoomstufe zurückgesetzt und alle versuchten Zoomänderungen werden ignoriert.

Attribute

contentWindow

Objektreferenz, die zum Posten von Nachrichten auf der Gastseite verwendet werden kann.

Typ

ContentWindow

contextMenus

Chrome 44 und höher

Ähnlich wie die ContextMenus API von Chrome, gilt aber für webview anstelle des Browsers. Mit der webview.contextMenus API können Sie dem Kontextmenü von webview Elemente hinzufügen. Sie können auswählen, auf welche Arten von Objekten sich Ihre Kontextmenü-Ergänzungen beziehen, z. B. Bilder, Hyperlinks und Seiten.

Typ

ContextMenus

request

Schnittstelle, die Zugriff auf webRequest-Ereignisse auf der Gastseite bietet.

Typ

WebRequestEventInterface

Methoden

addContentScripts()

Chrome 44 und höher 
chrome.webviewTag.addContentScripts(
  contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
): void

Fügt dem webview Regeln für das Einfügen von Inhaltskripten hinzu. Wenn der webview eine Seite aufruft, die mit einer oder mehreren Regeln übereinstimmt, werden die zugehörigen Skripts eingefügt. Sie können Regeln programmatisch hinzufügen oder vorhandene Regeln aktualisieren.

Im folgenden Beispiel werden dem webview zwei Regeln hinzugefügt: „myRule“ und „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';

Sie können den addContentScripts-Aufruf aufschieben, bis Sie Skripts einfügen müssen.

Im folgenden Beispiel wird gezeigt, wie eine vorhandene Regel überschrieben wird.

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'}]);

Wenn webview zum Ursprung (z.B. foo.com) navigiert wurde und webview.addContentScripts aufgerufen wird, um „myRule“ hinzuzufügen, müssen Sie auf die nächste Navigation warten, bis die Skripts eingefügt werden. Wenn Sie die sofortige Einfügung wünschen, wird executeScript das Richtige tun.

Regeln bleiben erhalten, auch wenn der Gastprozess abstürzt oder beendet wird oder wenn webview neu übergeordnet wird.

Weitere Informationen finden Sie in der Dokumentation zu Inhaltsskripts.

Parameter

back()

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

Navigiert, sofern möglich, einen Verlaufseintrag zurück. Gleichbedeutend mit go(-1).

Parameter

  • callback

    Funktion optional

    Chrome 44 und höher

    Der Parameter callback sieht so aus: 

    (success: boolean) => void

    • Erfolg

      boolean

      Gibt an, ob die Navigation erfolgreich war.

canGoBack()

chrome.webviewTag.canGoBack(): boolean

Gibt an, ob es möglich ist, im Verlauf zurückzugehen. Der Status dieser Funktion wird im Cache gespeichert und vor jedem loadcommit aktualisiert. Daher ist es am besten, sie in loadcommit aufzurufen.

Ausgabe

  • boolean

canGoForward()

chrome.webviewTag.canGoForward(): boolean

Gibt an, ob es möglich ist, in der Chronik vorwärts zu navigieren. Der Status dieser Funktion wird im Cache gespeichert und vor jedem loadcommit aktualisiert. Daher ist es am besten, sie in loadcommit aufzurufen.

Ausgabe

  • boolean

captureVisibleRegion()

Chrome 50 und höher 
chrome.webviewTag.captureVisibleRegion(
  options?: ImageDetails,
  callback: function,
): void

Erfasst den sichtbaren Bereich der WebView.

Parameter

  • Optionen

    ImageDetails optional

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (dataUrl: string) => void

    • dataUrl

      String

      Eine Daten-URL, die ein Bild des sichtbaren Bereichs des erfassten Tabs codiert. Kann der „src“-Property eines HTML-Bildelements zur Anzeige zugewiesen werden.

clearData()

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

Löscht die Browserdaten für die webview-Partition.

Parameter

  • Optionen

    ClearDataOptions

    Optionen, mit denen festgelegt wird, welche Daten gelöscht werden sollen.

  • Die Arten von Daten, die gelöscht werden sollen.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

executeScript()

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

Fügt JavaScript-Code in die Gastseite ein.

Im folgenden Beispielcode wird die Hintergrundfarbe der Gastseite mithilfe von Script-Injection auf Rot gesetzt:

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

Parameter

  • Details

    InjectDetails

    Details zum auszuführenden Skript.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result?: any[]) => void

    • Ergebnis

      any[] optional

      Das Ergebnis des Skripts in jedem eingefügten Frame.

find()

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

Leitet eine Suche auf der Seite ein.

Parameter

  • searchText

    String

    Der String, nach dem auf der Seite gesucht werden soll.

  • Optionen

    FindOptions optional

    Optionen für die Suchanfrage.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (results?: FindCallbackResults) => void

    • Ergebnisse

      FindCallbackResults optional

      Enthält alle Ergebnisse der Suchanfrage. results kann weggelassen werden, wenn es nicht im Callback-Funktionskörper verwendet wird, z. B. wenn der Callback nur dazu dient, festzustellen, wann die Suchanfrage abgeschlossen ist.

forward()

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

Ruft den nächsten Eintrag im Verlauf auf, sofern vorhanden. Gleichbedeutend mit go(1).

Parameter

  • callback

    Funktion optional

    Chrome 44 und höher

    Der Parameter callback sieht so aus: 

    (success: boolean) => void

    • Erfolg

      boolean

      Gibt an, ob die Navigation erfolgreich war.

getAudioState()

Chrome 62 und höher 
chrome.webviewTag.getAudioState(
  callback: function,
): void

Fragt den Audiostatus ab.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (audible: boolean) => void

    • audible

      boolean

getProcessId()

chrome.webviewTag.getProcessId(): number

Gibt die interne Prozess-ID von Chrome für den aktuellen Prozess der Gastwebseite zurück. So können Einbettungen ermitteln, wie viele Gäste von der Beendigung des Prozesses betroffen wären. Zwei Gäste teilen sich einen Prozess nur, wenn sie zur selben App gehören und dieselbe Speicherpartitions-ID haben. Der Aufruf ist synchron und gibt die im Embedder zwischengespeicherte Vorstellung der aktuellen Prozess-ID zurück. Die Prozess-ID ist nicht mit der Prozess-ID des Betriebssystems identisch.

Ausgabe

  • Zahl

getUserAgent()

chrome.webviewTag.getUserAgent(): string

Gibt den User-Agent-String zurück, der von webview für Gastseitenanfragen verwendet wird.

Ausgabe

  • String

getZoom()

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

Ruft den aktuellen Zoomfaktor ab.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (zoomFactor: number) => void

    • zoomFactor

      Zahl

      Der aktuelle Zoomfaktor.

getZoomMode()

Chrome 43 und höher 
chrome.webviewTag.getZoomMode(
  callback: function,
): void

Ruft den aktuellen Zoommodus ab.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (ZoomMode: ZoomMode) => void

    • ZoomMode

      ZoomMode

      Der aktuelle Zoommodus von webview.

go()

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

Ruft einen Verlaufseintrag über einen Verlaufsindex relativ zur aktuellen Navigation auf. Wenn die angeforderte Navigation nicht möglich ist, hat diese Methode keine Auswirkungen.

Parameter

  • relativeIndex

    Zahl

    Relativer Verlaufindex, zu dem webview navigiert werden soll. Ein Wert von 2 ruft beispielsweise, sofern möglich, die zwei vorherigen Einträge auf, ein Wert von -3 die drei vorherigen.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (success: boolean) => void

    • Erfolg

      boolean

      Gibt an, ob die Navigation erfolgreich war.

insertCSS()

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

Fügt CSS in die Gastseite ein.

Parameter

  • Details

    InjectDetails

    Details zum einzufügenden CSS.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

isAudioMuted()

Chrome 62 und höher 
chrome.webviewTag.isAudioMuted(
  callback: function,
): void

Fragt ab, ob das Audio stummgeschaltet ist.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (muted: boolean) => void

    • stummgeschaltet

      boolean

isSpatialNavigationEnabled()

Chrome 71 und höher 
chrome.webviewTag.isSpatialNavigationEnabled(
  callback: function,
): void

Fragt ab, ob die räumliche Navigation für die Webview aktiviert ist.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (enabled: boolean) => void

    • aktiviert

      boolean

isUserAgentOverridden()

chrome.webviewTag.isUserAgentOverridden(): void

Gibt an, ob der User-Agent-String von webview durch webviewTag.setUserAgentOverride überschrieben wurde.

loadDataWithBaseUrl()

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

Lädt eine Daten-URL mit einer angegebenen Basis-URL, die für relative Links verwendet wird. Optional kann eine virtuelle URL angegeben werden, die dem Nutzer anstelle der Daten-URL angezeigt wird.

Parameter

  • dataUrl

    String

    Die Daten-URL, die geladen werden soll.

  • baseUrl

    String

    Die Basis-URL, die für relative Links verwendet wird.

  • virtualUrl

    String optional

    Die URL, die dem Nutzer (in der Adressleiste) angezeigt wird.

print()

chrome.webviewTag.print(): void

Gibt den Inhalt von webview aus. Das entspricht dem Aufrufen der skriptbasierten Druckfunktion über webview.

reload()

chrome.webviewTag.reload(): void

Lädt die aktuelle Seite der obersten Ebene neu.

removeContentScripts()

Chrome 44 und höher 
chrome.webviewTag.removeContentScripts(
  scriptNameList?: string[],
): void

Entfernt Content-Scripts aus einem webview.

Im folgenden Beispiel wird die zuvor hinzugefügte Regel „myRule“ entfernt.

webview.removeContentScripts(['myRule']);

Sie können alle Regeln mit dem folgenden Aufruf entfernen:

webview.removeContentScripts();

Parameter

  • scriptNameList

    string[] optional

    Eine Liste mit Namen von Content-Skripts, die entfernt werden. Wenn die Liste leer ist, werden alle Inhaltsskripts, die webview hinzugefügt wurden, entfernt.

setAudioMuted()

Chrome 62 und höher 
chrome.webviewTag.setAudioMuted(
  mute: boolean,
): void

Legt den Stummschaltungsstatus des Audioinhalts der WebView fest.

Parameter

  • Stummschalten

    boolean

    Wert für „Ton aus“

setSpatialNavigationEnabled()

Chrome 71 und höher 
chrome.webviewTag.setSpatialNavigationEnabled(
  enabled: boolean,
): void

Legt den Status der räumlichen Navigation der WebView fest.

Parameter

  • aktiviert

    boolean

    Statuswert für die räumliche Navigation.

setUserAgentOverride()

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

Überschreiben Sie den User-Agent-String, der von webview für Gastseitenanfragen verwendet wird. Durch das Überschreiben werden die Werte des User-Agent Client Hint-Headers und die von navigator.userAgentData zurückgegebenen Werte für Gastseitenanfragen, auf die diese Überschreibung angewendet wird, leer.

Parameter

  • userAgent

    String

    Der zu verwendende User-Agent-String.

setZoom()

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

Ändert den Zoomfaktor der Seite. Umfang und Dauer dieser Änderung hängen vom aktuellen Zoommodus der Webview ab (siehe webviewTag.ZoomMode).

Parameter

  • zoomFactor

    Zahl

    Der neue Zoomfaktor.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

setZoomMode()

Chrome 43 und höher 
chrome.webviewTag.setZoomMode(
  ZoomMode: ZoomMode,
  callback?: function,
): void

Legt den Zoommodus von webview fest.

Parameter

  • ZoomMode

    ZoomMode

    Definiert, wie das Zoomen in der webview gehandhabt wird.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

stop()

chrome.webviewTag.stop(): void

Das Laden der aktuellen webview-Navigation wird beendet, falls es gerade läuft.

stopFinding()

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

Beendet die aktuelle Suchsitzung (alle Markierungen werden entfernt) und bricht alle laufenden Suchanfragen ab.

Parameter

  • Aktion

    StopFindingAction optional

    Bestimmt, was mit dem aktiven Spiel nach dem Ende der Suchsitzung geschehen soll. clear entfernt die Hervorhebung der aktiven Übereinstimmung, keep behält die Hervorhebung der aktiven Übereinstimmung bei und activate behält die Hervorhebung der aktiven Übereinstimmung bei und simuliert einen Nutzerklick auf diese Übereinstimmung. Die Standardaktion ist keep.

terminate()

chrome.webviewTag.terminate(): void

Beendet den Renderingprozess der Gastwebseite. Dies kann sich auf mehrere webview-Tags in der aktuellen App auswirken, wenn sie denselben Prozess verwenden, aber nicht auf webview-Tags in anderen Apps.

Ereignisse

close

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

Wird ausgelöst, wenn das Gastfenster versucht, sich selbst zu schließen.

Im folgenden Beispielcode wird webview zu about:blank weitergeleitet, wenn der Gast versucht, sich selbst zu schließen.

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

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    () => void

consolemessage

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

Wird ausgelöst, wenn im Gastfenster eine Konsolennachricht protokolliert wird.

Im folgenden Beispielcode werden alle Log-Meldungen unabhängig von der Log-Ebene oder anderen Eigenschaften an die Konsole des Einbettungsprogramms weitergeleitet.

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

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (level: number, message: string, line: number, sourceId: string) => void

    • Level

      Zahl

    • Nachricht

      String

    • Linie

      Zahl

    • sourceId

      String

contentload

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

Wird ausgelöst, wenn im Gastfenster ein load-Ereignis ausgelöst wird, d.h., wenn ein neues Dokument geladen wird. Dazu gehören nicht die Seitennavigation im aktuellen Dokument oder asynchrone Ressourcenladevorgänge.

Im folgenden Beispielcode wird die Standard-Schriftgröße des body-Elements des Gastes nach dem Laden der Seite geändert:

webview.addEventListener('contentload', function() {
  webview.executeScript({ code: 'document.body.style.fontSize = "42px"' });
});

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    () => void

dialog

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

Wird ausgelöst, wenn das Gastfenster versucht, ein modales Dialogfeld über window.alert, window.confirm oder window.prompt zu öffnen.

Die Verarbeitung dieses Ereignisses blockiert den Gastprozess, bis jeder Ereignis-Listener zurückgegeben wird oder das dialog-Objekt nicht mehr erreichbar ist (wenn preventDefault() aufgerufen wurde).

Standardmäßig wird der Dialog geschlossen.

Parameter

exit

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

Wird ausgelöst, wenn der Prozess, der die Web-Inhalte des Gastes rendert, beendet wurde.

Der folgende Beispielcode zeigt eine Abschiedsnachricht an, wenn die Gastseite abstürzt:

webview.addEventListener('exit', function(e) {
  if (e.reason === 'crash') {
    webview.src = 'data:text/plain,Goodbye, world!';
  }
});

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (details: object) => void

    • Details

      Objekt

      • processID

        Zahl

        Die interne Chrome-ID des beendeten Prozesses.

      • reason

        ExitReason

        String, der den Grund für das Beenden angibt.

findupdate

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

Wird ausgelöst, wenn neue Suchergebnisse für eine aktive Suchanfrage verfügbar sind. Das kann bei einer einzelnen Suchanfrage mehrmals passieren, wenn Übereinstimmungen gefunden werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (searchText: string, numberOfMatches: number, activeMatchOrdinal: number, selectionRect: SelectionRect, canceled: boolean, finalUpdate: string) => void

    • searchText

      String

    • numberOfMatches

      Zahl

    • activeMatchOrdinal

      Zahl

    • selectionRect

      SelectionRect

    • abgebrochen

      boolean

    • finalUpdate

      String

loadabort

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

Wird ausgelöst, wenn ein Ladevorgang auf oberster Ebene ohne Commit abgebrochen wurde. Eine Fehlermeldung wird in der Konsole ausgegeben, sofern das Ereignis nicht durch „default-prevented“ verhindert wird.

Hinweis:Wenn ein Ressourcenladevorgang abgebrochen wird, folgt auf ein loadabort-Ereignis schließlich ein loadstop-Ereignis, auch wenn alle seit dem letzten loadstop-Ereignis (falls vorhanden) ausgeführten Ladevorgänge abgebrochen wurden.

Hinweis:Wenn das Laden einer „about“-URL oder einer JavaScript-URL abgebrochen wird, wird loadabort ausgelöst und dann wird zu webview navigiert, die „about:blank“ enthält.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (url: string, isTopLevel: boolean, code: number, reason: LoadAbortReason) => void

loadcommit

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

Wird ausgelöst, wenn ein Ladevorgang abgeschlossen wurde. Dazu gehören die Navigation im aktuellen Dokument sowie das Laden von Dokumenten auf Subframe-Ebene, nicht jedoch asynchrone Ressourcenladevorgänge.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

    • URL

      String

    • isTopLevel

      boolean

loadredirect

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

Wird ausgelöst, wenn eine Ladeanfrage auf oberster Ebene an eine andere URL weitergeleitet wurde.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

    • oldUrl

      String

    • newUrl

      String

    • isTopLevel

      boolean

loadstart

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

Wird ausgelöst, wenn ein Ladevorgang begonnen hat.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

    • URL

      String

    • isTopLevel

      boolean

loadstop

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

Wird ausgelöst, wenn alle Ladevorgänge auf Frame-Ebene auf einer Gastseite (einschließlich aller untergeordneten Frames) abgeschlossen sind. Dazu gehören die Navigation im aktuellen Dokument sowie das Laden von Dokumenten auf Subframe-Ebene, nicht jedoch asynchrone Ressourcenladevorgänge. Dieses Ereignis wird jedes Mal ausgelöst, wenn die Anzahl der Ladevorgänge auf Dokumentebene von einem oder mehreren auf null wechselt. Wenn beispielsweise eine Seite, die bereits vollständig geladen wurde (d.h. loadstop wurde bereits einmal ausgelöst) wird ein neuer iFrame erstellt, in den eine Seite geladen wird. Ein zweites loadstop wird ausgelöst, wenn das Laden der iFrame-Seite abgeschlossen ist. Dieses Muster ist häufig auf Seiten zu beobachten, auf denen Anzeigen geladen werden.

Hinweis:Wenn ein Commit für einen Ladevorgang abgebrochen wird, folgt auf ein loadabort-Ereignis schließlich ein loadstop-Ereignis, auch wenn alle seit dem letzten loadstop-Ereignis (falls vorhanden) committeten Ladevorgänge abgebrochen wurden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    () => void

newwindow

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

Wird ausgelöst, wenn die Gastseite versucht, ein neues Browserfenster zu öffnen.

Mit dem folgenden Beispielcode wird für jedes angeforderte neue Fenster ein neues webview im Einbettungsprogramm erstellt und geöffnet:

webview.addEventListener('newwindow', function(e) {
  var newWebview = document.createElement('webview');
  document.body.appendChild(newWebview);
  e.window.attach(newWebview);
});

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (window: NewWindow, targetUrl: string, initialWidth: number, initialHeight: number, name: string, windowOpenDisposition: WindowOpenDisposition) => void

permissionrequest

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

Wird ausgelöst, wenn die Gastseite eine spezielle Berechtigung vom Einbettungsprogramm anfordern muss.

Mit dem folgenden Beispielcode wird der Gastseite Zugriff auf die webkitGetUserMedia API gewährt. Für eine App, die diesen Beispielcode verwendet, müssen die Manifestberechtigungen audioCapture und/oder videoCapture angegeben werden:

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

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (permission: PermissionType, request: object) => void

responsive

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

Wird ausgelöst, wenn der Prozess, der die Web-Inhalte des Gastes rendert, nach einer Zeit der Inaktivität wieder reagiert.

Im folgenden Beispielcode wird das webview-Element ein- oder ausgeblendet, je nachdem, ob es reagiert oder nicht:

webview.style.webkitTransition = 'opacity 250ms';
webview.addEventListener('unresponsive', function() {
  webview.style.opacity = '0.5';
});
webview.addEventListener('responsive', function() {
  webview.style.opacity = '1';
});

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (processID: number) => void

    • processID

      Zahl

sizechanged

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

Wird ausgelöst, wenn die Größe der eingebetteten Webinhalte über autosize geändert wurde. Wird nur ausgelöst, wenn autosize aktiviert ist.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void

    • oldWidth

      Zahl

    • oldHeight

      Zahl

    • newWidth

      Zahl

    • newHeight

      Zahl

unresponsive

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

Wird ausgelöst, wenn der Prozess, der die Web-Inhalte des Gastes rendert, nicht mehr reagiert. Dieses Ereignis wird einmal mit einem entsprechenden responsiven Ereignis generiert, wenn der Gast wieder reagiert.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (processID: number) => void

    • processID

      Zahl

zoomchange

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

Wird ausgelöst, wenn sich der Zoom der Seite ändert.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (oldZoomFactor: number, newZoomFactor: number) => void

    • oldZoomFactor

      Zahl

    • newZoomFactor

      Zahl