chrome.webviewTag

Beschreibung

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

Berechtigungen

webview

Typen

ClearDataOptions

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

Attribute

• seit

  number optional

  Löscht Daten, die an oder nach diesem Datum erfasst wurden. Die Zeit wird in Millisekunden seit der Epoche angegeben (über die getTime-Methode 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 Properties werden als false interpretiert.

Attribute

• appcache

  boolescher Wert optional

  App-Caches von Websites

• Cache

  boolescher Wert 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

  boolescher Wert optional

  Die Cookies der Partition.

• fileSystems

  boolescher Wert optional

  Dateisysteme von Websites

• indexedDB

  boolescher Wert optional

  IndexedDB-Daten von Websites

• localStorage

  boolescher Wert optional

  Daten im lokalen Speicher von Websites

• persistentCookies

  boolescher Wert optional

  Chrome 58 und höher

  Die nichtflüchtigen Cookies der Partition.

• sessionCookies

  boolescher Wert optional

  Chrome 58 und höher

  Die Sitzungscookies der Partition.

• webSQL

  boolescher Wert optional

  WebSQL-Daten von Websites

ContentScriptDetails

Chrome 44 und höher

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

Attribute

• all_frames

  boolescher Wert optional

  Wenn all_frames true ist, bedeutet das, dass das JavaScript oder CSS in alle Frames der aktuellen Seite eingefügt werden soll. Standardmäßig ist all_frames false und das JavaScript oder CSS wird nur in den oberen 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 ihrer Darstellung eingefügt, 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 Globus übereinstimmen. Emuliert das Greasemonkey-Keyword „@exclude“.

• exclude_matches

  string[] optional

  Ausschlüsse von Seiten, in die dieses Inhaltsskript sonst eingefügt würde.

• include_globs

  string[] optional

  Wird nach Übereinstimmungen angewendet, um nur URLs einzubeziehen, die auch mit diesem Globus übereinstimmen. Emuliert das Greasemonkey-Keyword „@include“.

• 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 erscheinen.

• match_about_blank

  boolescher Wert optional

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

• stimmt überein mit

  String[]

  Gibt an, in welche Seiten dieses Inhalts-Script eingefügt werden soll.

• name

  String

  Der Name des einzuschleusenden Inhaltsscripts.

• run_at

  RunAt optional

  Der früheste Zeitpunkt, zu dem das JavaScript oder CSS in den Tab eingefügt wird. Standardmäßig ist „document_idle“ festgelegt.

ContentWindow

Messaging-Handle für ein Gastfenster.

Attribute

• postMessage

  void

  Es wird eine Nachricht in den eingebetteten Webcontent gepostet, solange in den eingebetteten Inhalten eine Seite aus der Zielquelle angezeigt wird. Diese Methode ist verfügbar, sobald die Seite vollständig geladen ist. Höre auf das Ereignis contentload und rufe dann die Methode auf.

  Der Gast kann dem Einbettungs-Nutzer antworten, indem er bei dem empfangenen Nachrichtenereignis eine Nachricht an event.source sendet.

  Diese API ist mit der HTML5 postMessage API für die Kommunikation zwischen Webseiten identisch. Der Einbettungscode kann auf Antworten warten, indem seinem eigenen Frame ein message-Ereignis-Listener hinzugefügt wird.

  Die postMessage-Funktion sieht so aus:

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

  • Nachricht

    beliebig

    Nachrichtenobjekt, das an den Gast gesendet werden soll.

  • targetOrigin

    String

    Gibt an, wie der Ursprung des Gastfensters sein muss, damit das Ereignis gesendet wird.

ContextMenuCreateProperties

Chrome 44 und höher

Attribute

• ausgewählt

  boolescher Wert optional

  Der Anfangsstatus eines Kästchens oder Optionsfelds: „wahr“ für ausgewählt und „falsch“ für deaktiviert. In einer Gruppe von Optionselementen kann jeweils nur ein Optionselement ausgewählt werden.

• contexts

  [ContextType, ...ContextType[]] optional

  Liste der Kontexte, in denen dieser Menüpunkt angezeigt wird. Wenn keine Angabe gemacht wird, ist der Standardwert ['page'].

• documentUrlPatterns

  string[] optional

  Hiermit können Sie das Element so einschränken, dass es nur auf Dokumente angewendet wird, 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

  boolescher Wert 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. Sie 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 mit der Möglichkeit, nach dem src-Attribut von img-/audio-/video-Tags und dem href-Attribut von Anker-Tags zu filtern.

• Titel

  String optional

  Der Text, der im Artikel angezeigt werden soll. Diese Angabe ist erforderlich, es sei denn, type ist „separator“. Wenn der Kontext „selection“ ist, können Sie %s in der Zeichenfolge verwenden, um den ausgewählten Text anzuzeigen. Wenn der Wert dieses Parameters beispielsweise „%s in Pig Latin übersetzen“ lautet und der Nutzer das Wort „cool“ auswählt, lautet der Kontextmenüpunkt für die Auswahl „Cool in Pig Latin übersetzen“.

• Typ

  ItemType optional

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

• onclick

  void optional

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

  Die onclick-Funktion sieht so aus:

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

  • 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. Dieses Kontextmenü lässt sich durch Aufrufen von event.preventDefault() 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 Kontextmenü zu verhindern.

        Die preventDefault-Funktion sieht so aus:

        () => {...}

• create

  void

  Erstellt ein neues Kontextmenüelement. Wenn während der Erstellung ein Fehler auftritt, wirst du ihn möglicherweise erst beim Auslösen des Rückrufs zur Erstellung bemerken. Die Details findest du in runtime.lastError.

  Die create-Funktion sieht so aus:

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

  • createProperties

    Objekt

    Die Properties, die zum Erstellen des Elements verwendet wurden

  • callback

    function optional

    Der Parameter callback sieht so aus:

    () => void

  • Gibt zurück

    String | Zahl

    Die ID des neu erstellten Artikels.

• 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üpunkts.

  • callback

    function optional

    Der Parameter callback sieht so aus:

    () => void

• removeAll

  void

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

  Die removeAll-Funktion sieht so aus:

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

  • callback

    function 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 Properties. Akzeptiert dieselben Werte wie die Funktion „create“.

  • callback

    function optional

    Der Parameter callback sieht so aus:

    () => void

ContextMenuUpdateProperties

Chrome 44 und höher

Attribute

• ausgewählt

  boolescher Wert optional

  Der Status eines Kästchens oder Optionsfelds: „wahr“ für ausgewählt und „falsch“ für nicht ausgewählt. In einer Gruppe von Optionselementen kann jeweils nur ein Optionselement ausgewählt werden.

• contexts

  [ContextType, ...ContextType[]] optional

  Liste der Kontexte, in denen dieser Menüpunkt angezeigt wird.

• documentUrlPatterns

  string[] optional

  Hiermit können Sie das Element so einschränken, dass es nur auf Dokumente angewendet wird, 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

  boolescher Wert 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 so ändern, dass es ein untergeordnetes Element eines seiner eigenen Nachkommen ist.

• targetUrlPatterns

  string[] optional

  Ähnlich wie „documentUrlPatterns“, aber mit der Möglichkeit, nach dem src-Attribut von img-/audio-/video-Tags und dem href-Attribut von Anker-Tags zu filtern.

• Titel

  String optional

  Der Text, der im Artikel 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 onclick-Funktion sieht so aus:

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

  • 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 „alle“ entspricht der Kombination aller anderen Kontexte.

Enum

"alle"

"page"

"frame"

„selection“

"link"

„editable“

"image"

"video"

„audio“

DialogController

Benutzeroberfläche, 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

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

  Die ok-Funktion sieht so aus:

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

  • Antwort

    String optional

    Der Antwortstring, der dem Gast angezeigt wird, wenn ein prompt-Dialogfeld akzeptiert wird.

DownloadPermissionRequest

Der Typ des request-Objekts, das einem download-permissionrequest-DOM-Ereignis zugeordnet ist.

Attribute

• requestMethod

  String

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

• URL

  String

  Die angeforderte Download-URL.

• allow

  void

  Gewähren 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:

  () => {...}

FileSystemPermissionRequest

Der Typ des request-Objekts, das einem filesystem-permissionrequest-DOM-Ereignis zugeordnet ist.

Attribute

• URL

  String

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

• allow

  void

  Gewähren 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 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

  boolescher Wert optional

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

• matchCase

  boolescher Wert optional

  Flag, um die Groß- und Kleinschreibung zu berücksichtigen. Der Standardwert ist false.

FullscreenPermissionRequest

Chrome 43 und höher

Der Typ des request-Objekts, das einem fullscreen-permissionrequest-DOM-Ereignis zugeordnet ist.

Attribute

• origin

  String

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

• allow

  void

  Gewähren 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 einem geolocation-permissionrequest-DOM-Ereignis zugeordnet ist.

Attribute

• URL

  String

  Die URL des Frames, für den der Zugriff auf Standortdaten angefordert wird.

• allow

  void

  Gewähren 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 einem hid-permissionrequest-DOM-Ereignis zugeordnet ist.

Attribute

• URL

  String

  Die URL des Frames, für den der Zugriff auf die HID API angefordert wird.

• allow

  void

  Gewähren 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 einzuschleusenden Script oder CSS. Es muss entweder die Code- oder die Dateieigenschaft festgelegt werden, aber nicht beide 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

Die Art 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. Sie werden in der Reihenfolge eingefügt, in der sie in diesem Array erscheinen.

LoadPluginPermissionRequest

Der Typ des request-Objekts, das einem loadplugin-permissionrequest-DOM-Ereignis zugeordnet ist.

Attribute

• identifier

  String

  Der Identifikationsstring des Plug-ins.

• name

  String

  Der Anzeigename des Plug-ins.

• allow

  void

  Gewähren 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 einem media-permissionrequest-DOM-Ereignis zugeordnet ist.

Attribute

• URL

  String

  Die URL des Frames, für den Zugriff auf Nutzermedien angefordert wird.

• allow

  void

  Gewähren 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

Benutzeroberfläche, 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

  Stornieren Sie die Anfrage für das neue Fenster.

  Die discard-Funktion sieht so aus:

  () => {...}

PointerLockPermissionRequest

Der Typ des request-Objekts, das einem pointerLock-permissionrequest-DOM-Ereignis zugeordnet ist.

Attribute

• lastUnlockedBySelf

  boolean

  Gibt an, ob der anfragende Frame der letzte Client war, der die Maussperre gehalten hat.

• URL

  String

  Die URL des Frames, für den die Maussperre angefordert wird.

• userGesture

  boolean

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

• allow

  void

  Gewähren 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 Begrenzungssemantik ist arrayartig. Das heißt, 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 Displayrand zum linken Rand des Rechtecks.

• oben

  Zahl

  Abstand vom oberen Displayrand zum oberen Rand des Rechtecks.

• Breite

  Zahl

  Breite des Rechtecks.

WebRequestEventInterface

Chrome 44 und höher

Benutzeroberfläche, die Zugriff auf webRequest-Ereignisse auf der Gästeseite bietet. Weitere Informationen zum Lebenszyklus von webRequest und zu ähnlichen Konzepten finden Sie in der chrome.webRequest-Erweiterungs-API. Hinweis: Das Ereignis chrome.webRequest.onActionIgnored wird für Webviews nicht unterstützt.

Im folgenden Beispielcode wird veranschaulicht, wie sich die Verwendung von webRequest von der Erweiterungs-API unterscheidet. Hier werden 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 onRequest- und onMessage-Ereignisse. API-Details finden Sie unter declarativeWebRequest.

Bedingungen und Aktionen für deklarative Webview-Webanfragen sollten von ihren chrome.webViewRequest.*-Entsprechungen instanziiert werden. 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]);

ZoomMode

Chrome 43 und höher

Hier wird festgelegt, wie das Zoomen in der webview funktioniert.

Enum

„per-origin“
Zoomänderungen bleiben am 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 per-origin-Zoomänderungen mit der Quelle gespeichert. Wenn Sie also andere Seiten derselben Quelle aufrufen, werden sie alle mit demselben Zoomfaktor angezeigt.

„pro-view“
Zoomänderungen werden nur in dieser Webansicht übernommen. Zoomänderungen in anderen Webansichten wirken sich nicht auf die Zoomfunktion dieser Webansicht aus. Außerdem werden per-view-Zoomänderungen bei der Navigation zurückgesetzt. Beim Navigieren in einer Webansicht werden Seiten immer mit den pro Ursprung festgelegten Zoomfaktoren geladen (innerhalb der Partition).

„disabled“
Deaktiviert das Zoomen in der Webansicht. Die Inhalte werden auf die Standardzoomstufe zurückgesetzt und alle versuchten Zoomänderungen werden ignoriert.

Attribute

contentWindow

Objektreferenz, mit der Nachrichten auf der Gästeseite gepostet werden können.

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 die Ergänzungen im Kontextmenü angewendet werden sollen, z. B. auf Bilder, Hyperlinks und Seiten.

Typ

ContextMenus

request

Benutzeroberfläche, die Zugriff auf webRequest-Ereignisse auf der Gästeseite bietet.

Typ

WebRequestEventInterface

Methoden

addContentScripts()

Chrome 44 und höher

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

Fügt der webview Regeln für die Injektion von Inhaltsscripts hinzu. Wenn der webview eine Seite aufruft, die mit einer oder mehreren Regeln übereinstimmt, werden die zugehörigen Scripts 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';

Du kannst den Aufruf von „addContentScripts“ verschieben, bis du Scripts einschleusen musst.

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 über webview der Ursprung (z.B. foo.com) aufgerufen wurde und webview.addContentScripts aufgerufen wird, um „myRule“ hinzuzufügen, müssen Sie auf die nächste Navigation warten, damit die Scripts eingefügt werden. Wenn Sie eine sofortige Auszahlung wünschen, wird executeScript das Richtige tun.

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

Weitere Informationen finden Sie in der Dokumentation zu Inhaltsscripts.

Parameter

• contentScriptList

  [ContentScriptDetails, ...ContentScriptDetails[]]

  Details zu den hinzuzufügenden Inhaltsscripts.

back()

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

Ruft den vorherigen Verlaufseintrag auf, sofern möglich. Gleichbedeutend mit go(-1).

Parameter

• callback

  function 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()

Gibt an, ob es möglich ist, rückwärts durch den Verlauf zu gehen. Der Status dieser Funktion wird im Cache gespeichert und vor jedem loadcommit aktualisiert. Daher sollte sie am besten bei loadcommit aufgerufen werden.

Gibt Folgendes zurück:

• boolean

canGoForward()

chrome.webviewTag.canGoForward()

Gibt an, ob es möglich ist, durch den Verlauf zu springen. Der Status dieser Funktion wird im Cache gespeichert und vor jedem loadcommit aktualisiert. Daher sollte sie am besten bei loadcommit aufgerufen werden.

Gibt Folgendes zurück:

• boolean

captureVisibleRegion()

Chrome 50 und höher

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

Der sichtbare Bereich der WebView wird erfasst.

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 Property „src“ eines HTML-Bildelements zugewiesen werden.

clearData()

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

Browserdaten für die webview-Partition werden gelöscht.

Parameter

• Optionen

  ClearDataOptions

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

• Typen

  ClearDataTypeSet

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

• callback

  function optional

  Der Parameter callback sieht so aus:

  () => void

executeScript()

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

Fügt JavaScript-Code in die Gästeseite ein.

Im folgenden Beispielcode wird die Hintergrundfarbe der Gästeseite mithilfe von Script Injection auf Rot festgelegt:

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

Parameter

• Details

  InjectDetails

  Details zum auszuführenden Script.

• callback

  function optional

  Der Parameter callback sieht so aus:

  (result?: any[]) => void

  • Ergebnis

    any[] optional

    Das Ergebnis des Scripts in jedem eingeschleusten Frame.

find()

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

Initiiert eine Suchanfrage auf der Seite.

Parameter

• searchText

  String

  Der String, der auf der Seite gefunden 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 im Text der Rückruffunktion nicht verwendet wird, z. B. wenn der Rückruf nur dazu dient, festzustellen, wann die Suchanfrage abgeschlossen ist.

forward()

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

Springt nach Möglichkeit einen Eintrag im Verlauf vor. Gleichbedeutend mit go(1).

Parameter

• callback

  function 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,
)

Der Audiostatus wird abgefragt.

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus:

  (audible: boolean) => void

  • audible

    boolean

getProcessId()

chrome.webviewTag.getProcessId()

Gibt die interne Prozess-ID von Chrome für den aktuellen Prozess der Gastwebseite zurück. Damit können Einbettungskunden sehen, wie viele Gäste von der Beendigung des Prozesses betroffen wären. Zwei Gäste teilen sich nur dann einen Prozess, wenn sie zu derselben App gehören und dieselbe Speicherpartitions-ID haben. Der Aufruf ist synchron und gibt die im Cache des Einbettungstools gespeicherte aktuelle Prozess-ID zurück. Die Prozess-ID ist nicht mit der Prozess-ID des Betriebssystems identisch.

Gibt Folgendes zurück:

• Zahl

getUserAgent()

chrome.webviewTag.getUserAgent()

Der User-Agent-String, der von webview für Anfragen an die Gästeseite verwendet wird.

Gibt Folgendes zurück:

• String

getZoom()

chrome.webviewTag.getZoom(
  callback: function,
)

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,
)

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,
)

Ruft einen Verlaufseintrag mithilfe eines Verlaufsindexes auf, der sich auf die aktuelle Navigation bezieht. Wenn die angeforderte Navigation nicht möglich ist, hat diese Methode keine Auswirkungen.

Parameter

• relativeIndex

  Zahl

  Relativer Verlaufsindex, zu dem webview springen soll. Wenn Sie beispielsweise den Wert 2 eingeben, werden Sie bei Möglichkeit zwei Einträge nach vorne geleitet. Bei einem Wert von -3 werden Sie drei Einträge zurückgeleitet.

• 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,
)

CSS-Code wird in die Gästeseite eingefügt.

Parameter

• Details

  InjectDetails

  Details zum einzufügenden CSS.

• callback

  function optional

  Der Parameter callback sieht so aus:

  () => void

isAudioMuted()

Chrome 62 und höher

chrome.webviewTag.isAudioMuted(
  callback: function,
)

Prüft, ob der Ton 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,
)

Prüft, 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()

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

loadDataWithBaseUrl()

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

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 anstelle der Daten-URL für den Nutzer 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()

Der Inhalt der webview wird gedruckt. Das entspricht dem Aufruf der druckerspezifischen Funktion aus der webview selbst.

reload()

chrome.webviewTag.reload()

Die aktuelle Seite der obersten Ebene wird neu geladen.

removeContentScripts()

Chrome 44 und höher

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

Entfernt Content-Scripts aus einer webview.

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

webview.removeContentScripts(['myRule']);

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

webview.removeContentScripts();

Parameter

• scriptNameList

  string[] optional

  Eine Liste der Namen der zu entfernenden Content-Scripts. Wenn die Liste leer ist, werden alle Inhaltsscripts entfernt, die webview hinzugefügt wurden.

setAudioMuted()

Chrome 62 und höher

chrome.webviewTag.setAudioMuted(
  mute: boolean,
)

Legt den Stummschaltungsstatus der Audiowiedergabe der WebView fest.

Parameter

• Stummschalten

  boolean

  Wert für „Audio stummschalten“

setSpatialNavigationEnabled()

Chrome 71 und höher

chrome.webviewTag.setSpatialNavigationEnabled(
  enabled: boolean,
)

Hiermit wird der Status der räumlichen Navigation der Webansicht festgelegt.

Parameter

• aktiviert

  boolean

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

setUserAgentOverride()

chrome.webviewTag.setUserAgentOverride(
  userAgent: string,
)

Überschreiben Sie den User-Agent-String, der von der webview für Anfragen an die Gästeseite verwendet wird. Wenn Sie die Überschreibung verwenden, sind die Werte der User-Agent-Client-Hinweis-Header und die von navigator.userAgentData zurückgegebenen Werte für Anfragen an die Gästeseite, auf die diese Überschreibung angewendet wird, leer.

Parameter

• userAgent

  String

  Der zu verwendende User-Agent-String.

setZoom()

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

Ändert den Zoomfaktor der Seite. Umfang und Dauer dieser Änderung werden durch den aktuellen Zoommodus der Webansicht bestimmt (siehe webviewTag.ZoomMode).

Parameter

• zoomFactor

  Zahl

  Der neue Zoomfaktor.

• callback

  function optional

  Der Parameter callback sieht so aus:

  () => void

setZoomMode()

Chrome 43 und höher

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

Legt den Zoommodus der webview fest.

Parameter

• ZoomMode

  ZoomMode

  Hier wird festgelegt, wie das Zoomen in der webview funktioniert.

• callback

  function optional

  Der Parameter callback sieht so aus:

  () => void

stop()

chrome.webviewTag.stop()

Das Laden der aktuellen webview-Navigation wird beendet, falls es gerade ausgeführt wird.

stopFinding()

chrome.webviewTag.stopFinding(
  action?: "clear" 
  | "keep" 
  | "activate" 
 ,
)

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

Parameter

• Aktion

  "clear"
   | "keep"
   | "activate"
   optional

  Bestimmt, was mit der aktiven Übereinstimmung nach dem Ende der Suchsitzung geschehen soll. Mit clear wird die Markierung der aktiven Übereinstimmung aufgehoben. Mit keep bleibt die Markierung der aktiven Übereinstimmung erhalten. Mit activate bleibt die Markierung der aktiven Übereinstimmung erhalten und es wird ein Nutzerklick auf diese Übereinstimmung simuliert. Die Standardaktion ist keep.

terminate()

chrome.webviewTag.terminate()

Der Renderingvorgang der Gastwebseite wird erzwungen beendet. Das kann sich auf mehrere webview-Tags in der aktuellen App auswirken, wenn sie denselben Prozess verwenden. webview-Tags in anderen Apps sind davon 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 im Gastfenster eine Konsolennachricht protokolliert wird.

Im folgenden Beispielcode werden alle Protokollmeldungen unabhängig von der Protokollebene oder anderen Eigenschaften an die Konsole des Embedbers 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. Die Seitennavigation innerhalb des aktuellen Dokuments oder asynchrone Ressourcenladungen sind nicht enthalten.

Im folgenden Beispielcode wird die Standardschriftgröß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 im Gastfenster versucht wird, ein modales Dialogfeld über window.alert, window.confirm oder window.prompt zu öffnen.

Wenn dieses Ereignis verarbeitet wird, wird der Gastprozess blockiert, bis jeder Ereignis-Listener zurückgegeben wird oder das dialog-Objekt nicht mehr erreichbar ist (falls preventDefault() aufgerufen wurde).

Standardmäßig wird das Dialogfeld geschlossen.

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus:

  (messageType: "alert" 
    | "confirm" 
    | "prompt" 
   , messageText: string, dialog: DialogController) => void

  • messageType

    "alert"
     | "confirm"
     | "prompt"
    

  • messageText

    String

  • kleines Fenster

    DialogController

exit

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

Wird ausgelöst, wenn der Prozess zum Rendern der Webinhalte des Gastes beendet wurde.

Im folgenden Beispielcode wird eine Abschiedsnachricht angezeigt, wenn die Gästeseite 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:

  (processID: number, reason: "normal" 
    | "abnormal" 
    | "crash" 
    | "kill" 
   ) => void

  • processID

    Zahl

  • reason

    "normal"
     | "abnormal"
     | "crash"
     | "kill"
    

findupdate

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

Wird ausgelöst, wenn neue Suchergebnisse für eine aktive Suchanfrage verfügbar sind. Dies kann für eine einzelne Suchanfrage mehrmals geschehen, 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 eine Ladung der obersten Ebene ohne Commit abgebrochen wurde. Es wird eine Fehlermeldung in der Konsole ausgegeben, es sei denn, das Ereignis wird standardmäßig verhindert.

Hinweis:Wenn eine Ressourcenladevorgang abgebrochen wird, folgt auf ein loadabort-Ereignis irgendwann ein loadstop-Ereignis, auch wenn alle Commits seit dem letzten loadstop-Ereignis (falls vorhanden) 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: "ERR_ABORTED" 
    | "ERR_INVALID_URL" 
    | "ERR_DISALLOWED_URL_SCHEME" 
    | "ERR_BLOCKED_BY_CLIENT" 
    | "ERR_ADDRESS_UNREACHABLE" 
    | "ERR_EMPTY_RESPONSE" 
    | "ERR_FILE_NOT_FOUND" 
    | "ERR_UNKNOWN_URL_SCHEME" 
   ) => void

  • URL

    String

  • isTopLevel

    boolean

  • Code

    Zahl

  • reason

    "ERR_ABORTED"
     | "ERR_INVALID_URL"
     | "ERR_DISALLOWED_URL_SCHEME"
     | "ERR_BLOCKED_BY_CLIENT"
     | "ERR_ADDRESS_UNREACHABLE"
     | "ERR_EMPTY_RESPONSE"
     | "ERR_FILE_NOT_FOUND"
     | "ERR_UNKNOWN_URL_SCHEME"
    

loadcommit

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

Wird ausgelöst, wenn eine Ladung bestätigt wurde. Dazu gehören die Navigation innerhalb des aktuellen Dokuments sowie das Laden von Unterframes auf Dokumentebene, 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 der obersten Ebene auf 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 Frameebene auf einer Gastseite (einschließlich aller Unterframes) abgeschlossen sind. Dazu gehören die Navigation innerhalb des aktuellen Dokuments sowie das Laden von Unterframes auf Dokumentebene, 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 übergeht. Das ist beispielsweise der Fall, wenn eine Seite, die bereits vollständig geladen ist (d.h. loadstop bereits einmal ausgelöst wurde), wird ein neuer Iframe erstellt, in dem eine Seite geladen wird. Anschließend wird ein zweites loadstop ausgelöst, wenn der Iframe-Seitenaufbau abgeschlossen ist. Dieses Muster wird häufig auf Seiten beobachtet, auf denen Anzeigen geladen werden.

Hinweis:Wenn eine Commit-Ladung abgebrochen wird, folgt auf ein loadabort-Ereignis irgendwann ein loadstop-Ereignis, auch wenn alle Commit-Ladungen 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 auf der Gästeseite versucht wird, ein neues Browserfenster zu öffnen.

Im folgenden Beispielcode wird für jedes angeforderte neue Fenster eine neue webview im Embedder erstellt und darauf navigiert:

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: "ignore" 
    | "save_to_disk" 
    | "current_tab" 
    | "new_background_tab" 
    | "new_foreground_tab" 
    | "new_window" 
    | "new_popup" 
   ) => void

  • Fenster

    NewWindow

  • targetUrl

    String

  • initialWidth

    Zahl

  • initialHeight

    Zahl

  • name

    String

  • windowOpenDisposition

    "ignore"
     | "save_to_disk"
     | "current_tab"
     | "new_background_tab"
     | "new_foreground_tab"
     | "new_window"
     | "new_popup"
    

permissionrequest

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

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

Im folgenden Beispielcode wird der Gästeseite Zugriff auf die webkitGetUserMedia API gewährt. Eine App, die diesen Beispielcode verwendet, muss selbst die Manifestberechtigungen audioCapture und/oder videoCapture angeben:

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

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus:

  (permission: "media" 
    | "geolocation" 
    | "pointerLock" 
    | "download" 
    | "loadplugin" 
    | "filesystem" 
    | "fullscreen" 
    | "hid" 
   , request: object) => void

  • Berechtigung

    "media"
     | "geolocation"
     | "pointerLock"
     | "download"
     | "loadplugin"
     | "filesystem"
     | "fullscreen"
     | "hid"
    

  • Anfrage

    Objekt

responsive

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

Wird ausgelöst, wenn der Prozess, der die Webinhalte des Gastes rendert, wieder reagiert, nachdem er zuvor nicht reagiert hat.

Im folgenden Beispielcode wird das webview-Element eingeblendet oder ausgeblendet, wenn es reagiert oder nicht mehr 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 Web-Inhalts ü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 Webinhalte des Gastes rendert, nicht mehr reagiert. Dieses Ereignis wird einmal mit einem übereinstimmenden responsiven 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