chrome.webviewTag

Wichtig: Diese API funktioniert nur unter ChromeOS.

Beschreibung

Mit dem Tag webview können Sie Live-Inhalte aus dem Web über das Netzwerk laden und in Ihre Chrome-App einbetten. Ihre App kann das Erscheinungsbild des webview steuern und mit den Webinhalten interagieren, Navigationen auf einer eingebetteten Webseite initiieren, auf Fehlerereignisse reagieren, die darin auftreten, und mehr (siehe Verwendung).

Berechtigungen

webview

Verfügbarkeit

Nur ChromeOS

Typen

ClearDataOptions

Optionen, die festlegen, welche Daten von clearData gelöscht werden sollen.

Attribute

• seit

  number optional

  Löscht Daten, die am oder nach diesem Datum erfasst wurden, dargestellt in Millisekunden seit der Epoche (zugänglich über die getTime-Methode des JavaScript-Objekts Date). Wenn keine Angabe gemacht wird, wird standardmäßig 0 verwendet, wodurch alle Browserdaten entfernt werden.

ClearDataTypeSet

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

Attribute

• appcache

  Boolesch optional

  Appcaches von Websites.

• Cache

  Boolesch optional

  Chrome 44 oder höher

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

• Cookies

  Boolesch optional

  Die Cookies der Partition.

• fileSystems

  Boolesch optional

  Dateisysteme von Websites

• indexedDB

  Boolesch optional

  IndexedDB-Daten von Websites.

• localStorage

  Boolesch optional

  Daten im lokalen Speicher von Websites.

• persistentCookies

  Boolesch optional

  Chrome 58 oder höher

  Die nichtflüchtigen Cookies der Partition.

• sessionCookies

  Boolesch optional

  Chrome 58 oder höher

  Die Sitzungscookies der Partition.

• webSQL

  Boolesch optional

  WebSQL-Daten von Websites.

ContentScriptDetails

Chrome 44 oder höher

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

Attribute

• all_frames

  Boolesch optional

  Wenn all_frames den Wert true hat, 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 Inhaltsskript sonst eingefügt werden 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-Keyword @include emulieren.

• js

  InjectionItems optional

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

• match_about_blank

  Boolesch optional

  Gibt an, ob das Inhaltsskript in „about:blank“ und „about:srcdoc“ eingefügt werden soll. Inhaltsskripts werden nur auf Seiten eingefügt, wenn ihre übernommene URL mit einem der deklarierten Muster im Feld „matches“ übereinstimmt. Die übernommene URL ist die URL des Dokuments, mit dem der Frame oder das Fenster erstellt wurde. Inhaltsskripts können nicht in Sandbox-Frames eingefügt werden.

• stimmt überein mit

  String[]

  Gibt an, in welche Seiten dieses Inhaltsskript eingefügt wird.

• name

  String

  Der Name des einzufügenden Inhaltsskripts.

• run_at

  RunAt optional

  Der früheste 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

  Postet eine Nachricht an den eingebetteten Webinhalt, solange der eingebettete Inhalt eine Seite vom Zielursprung anzeigt. 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 Antworten an den Einbettenden senden, indem er eine Nachricht an event.source im empfangenen Nachrichtenereignis postet.

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

  Die Funktion postMessage sieht so aus:

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

  • Nachricht

    beliebig

    Nachrichtenobjekt, das an den Gast gesendet werden soll.

  • targetOrigin

    String

    Gibt an, welchen Ursprung das Gastfenster haben muss, damit das Ereignis gesendet wird.

ContextMenuCreateProperties

Chrome 44 oder höher

Attribute

• ausgewählt

  Boolesch optional

  Der Anfangszustand eines Kä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 dieser Menüpunkt angezeigt wird. Wenn keine Angabe gemacht wird, wird standardmäßig ['page'] verwendet.

• documentUrlPatterns

  string[] optional

  Damit können Sie das Element so einschränken, dass es nur auf Dokumente angewendet wird, deren URL mit einem der angegebenen Muster übereinstimmt. (Dies gilt auch für Frames.) Weitere Informationen zum Format eines Musters finden Sie unter Übereinstimmungsmuster.

• aktiviert

  Boolesch optional

  Gibt an, ob dieser Kontextmenüpunkt aktiviert oder deaktiviert ist. Die Standardeinstellung ist true.

• id

  String optional

  Die eindeutige ID, die diesem Element zugewiesen werden soll. Erforderlich für Veranstaltungsseiten. Darf nicht mit einer anderen ID für diese Erweiterung identisch sein.

• parentId

  String | Zahl optional

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

• targetUrlPatterns

  string[] optional

  Ähnlich wie documentUrlPatterns, ermöglicht aber das Filtern nach dem src-Attribut von img/audio/video-Tags und dem href-Attribut von anchor-Tags.

• Titel

  String optional

  Der Text, der im Element angezeigt werden soll. Dies ist erforderlich, es sei denn, type ist „separator“. Wenn der Kontext „selection“ ist, können Sie %s im String verwenden, um den ausgewählten Text anzuzeigen. Wenn der Wert dieses Parameters beispielsweise „Translate ‚%s‘ to Pig Latin“ lautet und der Nutzer das Wort „cool“ auswählt, lautet der Kontextmenüeintrag für die Auswahl „Translate ‚cool‘ to Pig Latin“.

• 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 den Menüpunkt geklickt wird.

  Die Funktion onclick sieht so aus:

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

  • Info

    OnClickData

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

ContextMenus

Chrome 44 oder höher

Attribute

• onShow

  Event<functionvoidvoid>

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

  Die Funktion onShow.addListener sieht so aus:

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

  • callback

    Funktion

    Der Parameter callback sieht so aus:

    (event: object) => void

    • event

      Objekt

      • preventDefault

        void

        Rufen Sie diese Methode auf, um das Kontextmenü nicht anzuzeigen.

        Die Funktion preventDefault sieht so aus:

        () => {...}

• create

  void

  Erstellt einen neuen Kontextmenüeintrag. Wenn während der Erstellung ein Fehler auftritt, werden Sie möglicherweise erst benachrichtigt, wenn der Erstellungs-Callback ausgelöst wird. Die Details finden Sie in runtime.lastError.

  Die Funktion create sieht so aus:

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

  • createProperties

    Objekt

    Die Attribute, die zum Erstellen des Elements verwendet wurden

  • callback

    function optional

    Der Parameter callback sieht so aus:

    () => void

  • Gibt zurück

    string | number

    Die ID des neu erstellten Elements.

• Entfernen

  void

  Entfernt ein Kontextmenüelement.

  Die Funktion remove sieht so aus:

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

  • menuItemId

    string | number

    Die ID des zu entfernenden Kontextmenüelements.

  • callback

    function optional

    Der Parameter callback sieht so aus:

    () => void

• removeAll

  void

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

  Die Funktion removeAll sieht so aus:

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

  • callback

    function optional

    Der Parameter callback sieht so aus:

    () => void

• update

  void

  Aktualisiert einen zuvor erstellten Kontextmenüeintrag.

  Die Funktion update sieht so aus:

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

  • id

    string | number

    Die ID des zu aktualisierenden Elements.

  • updateProperties

    Objekt

    Die zu aktualisierenden Attribute. Akzeptiert dieselben Werte wie die Erstellungsfunktion.

  • callback

    function optional

    Der Parameter callback sieht so aus:

    () => void

ContextMenuUpdateProperties

Chrome 44 oder höher

Attribute

• ausgewählt

  Boolesch optional

  Der Status eines Kä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 dieser Menüpunkt angezeigt wird.

• documentUrlPatterns

  string[] optional

  Damit können Sie das Element so einschränken, dass es nur auf Dokumente angewendet wird, deren URL mit einem der angegebenen Muster übereinstimmt. (Dies gilt auch für Frames.) Weitere Informationen zum Format eines Musters finden Sie unter Übereinstimmungsmuster.

• aktiviert

  Boolesch optional

  Gibt an, ob dieser Kontextmenüpunkt aktiviert oder deaktiviert ist.

• parentId

  String | Zahl optional

  Die ID eines übergeordneten Menüpunkts. Dadurch wird der Menüpunkt zu einem untergeordneten Element eines zuvor hinzugefügten Menüpunkts. Hinweis: Sie können ein Element nicht in ein untergeordnetes Element eines seiner eigenen untergeordneten Elemente ändern.

• targetUrlPatterns

  string[] optional

  Ähnlich wie documentUrlPatterns, ermöglicht aber das Filtern nach dem src-Attribut von img/audio/video-Tags und dem href-Attribut von anchor-Tags.

• Titel

  String optional

  Der Text, der im Element angezeigt werden soll

• Typ

  ItemType optional

  Der Typ des Menüpunkts.

• onclick

  void optional

  Eine Funktion, die aufgerufen wird, wenn auf den Menüpunkt geklickt wird.

  Die Funktion onclick sieht so aus:

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

  • Info

    OnClickData

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

ContextType

Chrome 44 oder 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 Funktion cancel sieht so aus:

  () => {...}

• Ok

  void

  Bestätigen Sie das Dialogfeld. Entspricht dem Klicken auf „OK“ in einem alert-, confirm- oder prompt-Dialogfeld.

  Die Funktion ok sieht so aus:

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

  • Antwort

    String optional

    Der Antwortstring, der dem Gast beim Akzeptieren eines prompt-Dialogs bereitgestellt werden soll.

DialogMessageType

Chrome 141 oder höher

Der Typ des modalen Dialogfelds, das vom Gast angefordert wurde.

Enum

"alert"

"confirm"

"prompt"

DownloadPermissionRequest

Der Typ des request-Objekts, das mit einem download-permissionrequest-DOM-Ereignis einhergeht.

Attribute

• requestMethod

  String

  Der HTTP-Anfragetyp (z.B. GET), der mit der Downloadanfrage verknüpft ist.

• URL

  String

  Die angeforderte Download-URL.

• allow

  void

  Erlaube die Berechtigungsanfrage.

  Die Funktion allow sieht so aus:

  () => {...}

• deny

  void

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

  Die Funktion deny sieht so aus:

  () => {...}

ExitReason

Chrome 141 oder höher

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

Enum

"normal"

„abnormal“

"crashed"

"killed"

"oom killed"

"oom"

„failed to launch“

„Integritätsfehler“

FileSystemPermissionRequest

Der Typ des request-Objekts, das mit einem filesystem-permissionrequest-DOM-Ereignis einhergeht.

Attribute

• URL

  String

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

• allow

  void

  Erlaube die Berechtigungsanfrage.

  Die Funktion allow sieht so aus:

  () => {...}

• deny

  void

  Lehnen Sie die Berechtigungsanfrage ab.

  Die Funktion deny sieht so aus:

  () => {...}

FindCallbackResults

Enthält alle Ergebnisse der Suchanfrage.

Attribute

• activeMatchOrdinal

  Zahl

  Die Ordnungszahl der aktuellen Übereinstimmung.

• abgebrochen

  boolean

  Gibt an, ob diese Suchanfrage abgebrochen wurde.

• numberOfMatches

  Zahl

  Die Häufigkeit, mit der searchText auf der Seite gefunden wurde.

• selectionRect

  SelectionRect

  Beschreibt ein Rechteck um die aktive Übereinstimmung in Bildschirmkoordinaten.

FindOptions

Optionen für die Suchanfrage.

Attribute

• rückwärts

  Boolesch optional

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

• matchCase

  Boolesch optional

  Flag für die Berücksichtigung der Groß-/Kleinschreibung. Der Standardwert ist false.

FullscreenPermissionRequest

Chrome 43 oder höher

Der Typ des request-Objekts, das mit einem fullscreen-permissionrequest-DOM-Ereignis einhergeht.

Attribute

• origin

  String

  Der Ursprung des Frames innerhalb des webview, der die Vollbildanfrage initiiert hat.

• allow

  void

  Erlaube die Berechtigungsanfrage.

  Die Funktion allow sieht so aus:

  () => {...}

• deny

  void

  Lehnen Sie die Berechtigungsanfrage ab.

  Die Funktion deny sieht so aus:

  () => {...}

GeolocationPermissionRequest

Der Typ des request-Objekts, das mit einem geolocation-permissionrequest-DOM-Ereignis einhergeht.

Attribute

• URL

  String

  Die URL des Frames, der Zugriff auf Standortdaten anfordert.

• allow

  void

  Erlaube die Berechtigungsanfrage.

  Die Funktion allow sieht so aus:

  () => {...}

• deny

  void

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

  Die Funktion deny sieht so aus:

  () => {...}

HidPermissionRequest

Chrome 125 oder höher

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

Attribute

• URL

  String

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

• allow

  void

  Erlaube die Berechtigungsanfrage.

  Die Funktion allow sieht so aus:

  () => {...}

• deny

  void

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

  Die Funktion deny sieht so aus:

  () => {...}

InjectDetails

Details des einzufügenden Scripts oder CSS. Entweder muss der Code oder die Dateieigenschaft festgelegt werden, aber nicht beide gleichzeitig.

Attribute

• Code

  String optional

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

  Warnung: Seien Sie vorsichtig, wenn Sie den Parameter code verwenden. Eine falsche Verwendung kann Ihre App anfällig für Cross-Site-Scripting-Angriffe machen.

• Datei

  String optional

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

InjectionItems

Chrome 44 oder höher

Der Typ des Injection-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. Diese werden in der Reihenfolge eingefügt, in der sie in diesem Array angezeigt werden.

LoadAbortReason

Chrome 141 oder höher

String, der angibt, welche Art von Abbruch aufgetreten ist. Es kann nicht garantiert werden, dass dieser String zwischen den Releases abwärtskompatibel bleibt. Sie dürfen den Inhalt nicht parsen und keine Maßnahmen auf Grundlage des Inhalts ergreifen. In einigen Fällen kann auch ein Fehler gemeldet werden, der hier nicht aufgeführt ist.

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 mit einem loadplugin-permissionrequest-DOM-Ereignis einhergeht.

Attribute

• identifier

  String

  Der Identifikationsstring des Plug-ins.

• name

  String

  Der Anzeigename des Plug-ins.

• allow

  void

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

  Die Funktion allow sieht so aus:

  () => {...}

• deny

  void

  Lehnen Sie die Berechtigungsanfrage ab.

  Die Funktion deny sieht so aus:

  () => {...}

MediaPermissionRequest

Der Typ des request-Objekts, das mit einem media-permissionrequest-DOM-Ereignis einhergeht.

Attribute

• URL

  String

  Die URL des Frames, der Zugriff auf Nutzermedien anfordert.

• allow

  void

  Erlaube die Berechtigungsanfrage.

  Die Funktion allow sieht so aus:

  () => {...}

• deny

  void

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

  Die Funktion deny 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 Funktion attach 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 ein neues Fenster ab.

  Die Funktion discard sieht so aus:

  () => {...}

PermissionType

Chrome 141 oder höher

Die Art der angeforderten Berechtigung.

Enum

"media"

"geolocation"

"pointerLock"

"download"

"loadplugin"

"filesystem"

"fullscreen"

"hid"

PointerLockPermissionRequest

Der Typ des request-Objekts, das mit einem pointerLock-permissionrequest-DOM-Ereignis einhergeht.

Attribute

• lastUnlockedBySelf

  boolean

  Ob der anfragende Frame der letzte Client war, der die Zeigersperre hatte.

• URL

  String

  Die URL des Frames, der die Zeigersperre anfordert.

• userGesture

  boolean

  Gibt an, ob die Zeigersperre aufgrund einer Nutzereingabegeste angefordert wurde.

• allow

  void

  Erlaube die Berechtigungsanfrage.

  Die Funktion allow sieht so aus:

  () => {...}

• deny

  void

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

  Die Funktion deny sieht so aus:

  () => {...}

SelectionRect

Beschreibt ein Rechteck in Bildschirmkoordinaten.

Die Semantik der Eingrenzung ist arrayähnlich, d. h., die Koordinate (left, top) wird als im Rechteck enthalten betrachtet, 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 Rand des Bildschirms zum oberen Rand des Rechtecks.

• Breite

  Zahl

  Breite des Rechtecks.

StopFindingAction

Chrome 141 oder höher

Bestimmt, was mit der aktiven Übereinstimmung nach dem Ende der Suchsitzung geschehen soll. clear löscht die Hervorhebung des aktiven Treffers; keep behält die Hervorhebung des aktiven Treffers bei; activate behält die Hervorhebung des aktiven Treffers bei und simuliert einen Nutzerklick auf diesen Treffer. Die Standardaktion ist keep.

Enum

„Löschen“

"keep"

"activate"

WebRequestEventInterface

Chrome 44 oder höher

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

Um zu veranschaulichen, wie sich die Verwendung von der webRequest API für Erweiterungen unterscheidet, sehen Sie sich den folgenden Beispielcode an, der alle Gastanfragen für URLs blockiert, die mit *://www.evil.com/* übereinstimmen:

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

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

Beachten Sie, dass Bedingungen und Aktionen für deklarative webview-webRequests von ihren chrome.webViewRequest.*-Entsprechungen instanziiert werden sollten. Im folgenden Beispielcode werden alle Anfragen an "example.com" in der Webansicht 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

Chrome 141 oder höher

Die gewünschte Anordnung des neuen Fensters.

Enum

"ignore"

"save_to_disk"

"current_tab"

"new_background_tab"

"new_foreground_tab"

"new_window"

"new_popup"

ZoomMode

Chrome 43 oder höher

Definiert, wie das Zoomen im 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 weitergeleitet werden, ebenfalls gezoomt werden. Außerdem werden Zoomänderungen für per-origin mit dem Ursprung gespeichert. Das bedeutet, dass beim Aufrufen anderer Seiten im selben Ursprung alle mit demselben Zoomfaktor gezoomt werden.

„per-view“
Zoomänderungen werden nur in dieser Webansicht wirksam und Zoomänderungen in anderen Webansichten haben keine Auswirkungen auf den Zoom dieser Webansicht. Außerdem werden per-view-Zoomänderungen beim Navigieren zurückgesetzt. Beim Navigieren in einer Webansicht werden Seiten immer mit ihren Zoomfaktoren pro Ursprung (innerhalb des Bereichs 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 oder höher

Ähnlich wie die ContextMenus API von Chrome, gilt aber für webview statt für den Browser. Verwenden Sie die webview.contextMenus API, um dem Kontextmenü von webview Elemente hinzuzufügen. Sie können auswählen, für welche Arten von Objekten Ihre Kontextmenü-Ergänzungen gelten sollen, 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 oder höher

chrome.webviewTag.addContentScripts(
  contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
): void

Fügt der webview Regeln für die Einschleusung von Inhaltsskripts hinzu. Wenn der webview eine Seite aufruft, die einer oder mehreren Regeln entspricht, werden die zugehörigen Skripts eingefügt. Sie können Regeln programmatisch hinzufügen oder vorhandene Regeln aktualisieren.

Im folgenden Beispiel werden der 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 Aufruf von „addContentScripts“ verschieben, 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 aufruft, um „myRule“ hinzuzufügen, müssen Sie bis zur nächsten Navigation warten, damit die Skripts eingefügt werden. Wenn Sie eine sofortige Injektion wünschen, ist executeScript die richtige Wahl.

Regeln bleiben auch dann erhalten, wenn der Gastprozess abstürzt oder beendet wird oder wenn der webview einem anderen übergeordneten Prozess zugewiesen wird.

Weitere Informationen finden Sie in der Dokumentation zu Inhaltsskripts.

Parameter

• contentScriptList

  [ContentScriptDetails, ...ContentScriptDetails[]]

  Details zu den hinzuzufügenden Inhaltsskripts.

back()

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

Navigiert nach Möglichkeit einen Verlaufseintrag zurück. Gleichbedeutend mit go(-1).

Parameter

• callback

  function optional

  Chrome 44 oder 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 bei loadcommit aufzurufen.

Ausgabe

• boolean

canGoForward()

chrome.webviewTag.canGoForward(): boolean

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

Ausgabe

• boolean

captureVisibleRegion()

Chrome 50 oder höher

chrome.webviewTag.captureVisibleRegion(
  options?: ImageDetails,
  callback: function,
): void

Erfasst den sichtbaren Bereich der Webansicht.

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 aufgenommenen Tabs codiert. Kann der Eigenschaft „src“ eines HTML-Bildelements zur Anzeige zugewiesen werden.

clearData()

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

Löscht Browserdaten für die Partition webview.

Parameter

• Optionen

  ClearDataOptions

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

• Typen

  ClearDataTypeSet

  Die zu löschenden Datentypen.

• callback

  function 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 des auszuführenden Skripts.

• callback

  function optional

  Der Parameter callback sieht so aus:

  (result?: any[]) => void

  • Ergebnis

    any[] optional

    Das Ergebnis des Scripts in jedem eingefügten Frame.

find()

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

Initiiert eine Anfrage zum Suchen auf der Seite.

Parameter

• searchText

  String

  Der String, der auf der Seite gesucht werden soll.

• Optionen

  FindOptions optional

  Optionen für die Suchanfrage.

• callback

  function 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 Text der Callback-Funktion verwendet wird, z. B. wenn der Callback nur verwendet wird, um zu erkennen, wann die Suchanfrage abgeschlossen ist.

forward()

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

Navigiert, wenn möglich, einen Verlaufseintrag vorwärts. Gleichbedeutend mit go(1).

Parameter

• callback

  function optional

  Chrome 44 oder höher

  Der Parameter callback sieht so aus:

  (success: boolean) => void

  • Erfolg

    boolean

    Gibt an, ob die Navigation erfolgreich war.

getAudioState()

Chrome 62 oder 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 erkennen, wie viele Gäste von der Beendigung des Prozesses betroffen wären. Zwei Gäste teilen sich nur dann einen Prozess, wenn sie zur selben App gehören und dieselbe Speicherpartitions-ID haben. Der Aufruf ist synchron und gibt die im Cache gespeicherte Vorstellung des Embedders von 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 vom 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 oder 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 des webview.

go()

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

Navigiert zu einem Verlaufseintrag mithilfe eines Verlaufsindex relativ zur aktuellen Navigation. Wenn die angeforderte Navigation nicht möglich ist, hat diese Methode keine Auswirkungen.

Parameter

• relativeIndex

  Zahl

  Relativer Verlaufsindex, zu dem der webview navigiert werden soll. Beispiel: Bei einem Wert von 2 wird, wenn möglich, zwei Einträge im Verlauf vorwärts navigiert. Bei einem Wert von -3 wird drei Einträge rückwärts navigiert.

• callback

  function 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

  function optional

  Der Parameter callback sieht so aus:

  () => void

isAudioMuted()

Chrome 62 oder höher

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

Fragt ab, ob Audio stummgeschaltet ist.

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus:

  (muted: boolean) => void

  • stummgeschaltet

    boolean

isSpatialNavigationEnabled()

Chrome 71 oder höher

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

Fragt ab, ob die räumliche Navigation für die Webansicht 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 zu ladende Daten-URL.

• 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. Dies entspricht dem Aufruf der skriptbasierten Druckfunktion aus dem webview selbst.

reload()

chrome.webviewTag.reload(): void

Lädt die aktuelle Seite der obersten Ebene neu.

removeContentScripts()

Chrome 44 oder höher

chrome.webviewTag.removeContentScripts(
  scriptNameList?: string[],
): void

Entfernt Inhaltsskripts aus einem webview.

Im folgenden Beispiel wird „myRule“ entfernt, das zuvor hinzugefügt wurde.

webview.removeContentScripts(['myRule']);

Sie können alle Regeln entfernen, indem Sie Folgendes aufrufen:

webview.removeContentScripts();

Parameter

• scriptNameList

  string[] optional

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

setAudioMuted()

Chrome 62 oder höher

chrome.webviewTag.setAudioMuted(
  mute: boolean,
): void

Legt den Audiostummschaltungsstatus der Webansicht fest.

Parameter

• Stummschalten

  boolean

  Wert für „Audio stummschalten“

setSpatialNavigationEnabled()

Chrome 71 oder höher

chrome.webviewTag.setSpatialNavigationEnabled(
  enabled: boolean,
): void

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

Parameter

• aktiviert

  boolean

  Wert für den Status der räumlichen Navigation.

setUserAgentOverride()

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

Überschreiben Sie den User-Agent-String, der vom webview für Gastseitenanfragen verwendet wird. Wenn Sie die Einstellung überschreiben, sind die Headerwerte für User-Agent-Client-Hints 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. Der Umfang und die Dauer dieser Änderung hängen vom aktuellen Zoommodus der Webansicht ab (siehe webviewTag.ZoomMode).

Parameter

• zoomFactor

  Zahl

  Der neue Zoomfaktor.

• callback

  function optional

  Der Parameter callback sieht so aus:

  () => void

setZoomMode()

Chrome 43 oder höher

chrome.webviewTag.setZoomMode(
  ZoomMode: ZoomMode,
  callback?: function,
): void

Legt den Zoommodus des webview fest.

Parameter

• ZoomMode

  ZoomMode

  Definiert, wie das Zoomen im webview gehandhabt wird.

• callback

  function optional

  Der Parameter callback sieht so aus:

  () => void

stop()

chrome.webviewTag.stop(): void

Beendet das Laden der aktuellen webview-Navigation, falls diese gerade ausgeführt wird.

stopFinding()

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

Beendet die aktuelle Suchsitzung (alle Markierungen werden gelöscht) und bricht alle laufenden Suchanfragen ab.

Parameter

• Aktion

  StopFindingAction optional

  Bestimmt, was mit der aktiven Übereinstimmung nach dem Ende der Suchsitzung geschehen soll. clear löscht die Hervorhebung des aktiven Treffers; keep behält die Hervorhebung des aktiven Treffers bei; activate behält die Hervorhebung des aktiven Treffers bei und simuliert einen Nutzerklick auf diesen Treffer. Die Standardaktion ist keep.

terminate()

chrome.webviewTag.terminate(): void

Erzwingt das Beenden des Renderer-Prozesses der Gastwebseite. Dies kann sich auf mehrere webview-Tags in der aktuellen App auswirken, wenn sie denselben Prozess verwenden. webview-Tags in anderen Apps sind davon jedoch nicht betroffen.

Ereignisse

close

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

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

Im folgenden Beispielcode wird der 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 das Gastfenster eine Konsolennachricht protokolliert.

Im folgenden Beispielcode werden alle Logeinträge ohne Berücksichtigung der Logebene oder anderer Attribute an die Konsole des Einbetters 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 das Gastfenster ein load-Ereignis auslöst, d.h., wenn ein neues Dokument geladen wird. Dies umfasst nicht die Seitennavigation innerhalb des aktuellen Dokuments oder das asynchrone Laden von Ressourcen.

Im folgenden Beispielcode wird die Standardschriftgröße des body-Elements des Gastes nach dem Seitenaufbau 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).

Das Standardverhalten ist, das Dialogfeld abzubrechen.

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus:

  (messageType: DialogMessageType, messageText: string, dialog: DialogController) => void

  • messageType

    DialogMessageType

  • messageText

    String

  • Dialogfeld

    DialogController

exit

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

Wird ausgelöst, wenn der Prozess zum Rendern des Gast-Webinhalts beendet wurde.

Im folgenden Beispielcode wird eine Abschiedsnachricht angezeigt, 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. Dies 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. In der Konsole wird eine Fehlermeldung ausgegeben, es sei denn, das Ereignis wird standardmäßig verhindert.

Hinweis: Wenn das Laden einer Ressource abgebrochen wird, folgt auf ein loadabort-Ereignis schließlich ein loadstop-Ereignis, auch wenn alle seit dem letzten loadstop-Ereignis (falls vorhanden) bestätigten Ladevorgänge abgebrochen wurden.

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

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus:

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

  • URL

    String

  • isTopLevel

    boolean

  • Code

    Zahl

  • reason

    LoadAbortReason

loadcommit

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

Wird ausgelöst, wenn ein Ladevorgang abgeschlossen wurde. Dazu gehören die Navigation innerhalb des aktuellen Dokuments sowie das Laden von Dokumenten auf Subframe-Ebene, aber nicht das asynchrone Laden von Ressourcen.

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 zu einer anderen 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 Unterframes) abgeschlossen sind. Dazu gehören die Navigation innerhalb des aktuellen Dokuments sowie das Laden von Dokumenten auf Subframe-Ebene, aber nicht das asynchrone Laden von Ressourcen. 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, der eine Seite lädt. Ein zweites loadstop wird ausgelöst, wenn der Seitenaufbau der iFrame-Seite abgeschlossen ist. Dieses Muster ist häufig auf Seiten zu beobachten, auf denen Anzeigen geladen werden.

Hinweis: Wenn ein Commit-Ladevorgang abgebrochen wird, folgt auf ein loadabort-Ereignis schließlich ein loadstop-Ereignis, auch wenn alle Commit-Ladevorgänge seit dem letzten loadstop-Ereignis (falls vorhanden) 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 Embedder erstellt und aufgerufen:

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

  • Fenster

    NewWindow

  • targetUrl

    String

  • initialWidth

    Zahl

  • initialHeight

    Zahl

  • name

    String

  • windowOpenDisposition

    WindowOpenDisposition

permissionrequest

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

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

Mit dem folgenden Beispielcode wird der Gastseite Zugriff auf die webkitGetUserMedia API gewährt. Beachten Sie, dass eine App, die diesen Beispielcode verwendet, selbst die Manifestberechtigungen audioCapture und/oder videoCapture angeben muss:

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

  • Berechtigung

    PermissionType

  • Anfrage

    Objekt

responsive

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

Wird ausgelöst, wenn der Prozess, der den Gast-Webinhalt rendert, nach einer Phase der Nichtreaktion wieder reagiert.

Mit dem folgenden Beispielcode wird das Element webview ein- oder ausgeblendet, wenn es reagiert oder nicht reagiert:

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 des eingebetteten Webinhalts ü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 den Gast-Webinhalt rendert, nicht mehr reagiert. Dieses Ereignis wird einmal mit einem entsprechenden Antwort-Ereignis generiert, wenn der Gast wieder antwortet.

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