chrome.webviewTag

Beschreibung

Verwende das webview-Tag, um Live-Inhalte aus dem Web über das Netzwerk aktiv zu laden und in deine Chrome-App einzubetten. Deine App kann unter anderem die Darstellung von webview steuern, mit den Webinhalten interagieren, Navigationen auf einer eingebetteten Webseite starten und auf darin auftretende Fehlerereignisse reagieren. Weitere Informationen findest du unter Nutzung.

Berechtigungen

webview

Typen

ClearDataOptions

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

Attribute

• seit

  Nummer optional

  Löscht Daten, die an oder nach diesem Datum angesammelt wurden, dargestellt in Millisekunden seit der Epoche (zugänglich über die getTime-Methode des JavaScript-Date-Objekts). Falls nichts angegeben, wird standardmäßig 0 verwendet. Damit werden alle Browserdaten gelöscht.

ClearDataTypeSet

Ein Satz von Datentypen. Fehlende Attribute werden als false interpretiert.

Attribute

• App-Cache

  Boolescher Wert optional

  App-Caches von Websites

• Cache

  Boolescher Wert optional

  Chrome 44 und höher

  Seit Chrome 43. Der Cache des Browsers. Hinweis: Beim Entfernen von Daten wird der gesamte Cache geleert. Der Cache 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

  Lokale Speicherdaten von Websites

• persistentCookies

  Boolescher Wert optional

  Chrome 58 und höher

  Die persistenten 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 Contentskripts.

Attribute

• all_frames

  Boolescher Wert optional

  Wenn all_frames den Wert true hat, bedeutet dies, dass der JavaScript- oder CSS-Code in alle Frames der aktuellen Seite eingeschleust werden sollte. Standardmäßig ist all_frames auf false gesetzt und der JavaScript- oder CSS-Code wird nur in den obersten Frame eingeschleust.

• css

  InjectionItems optional

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

• exclude_globs

  string[] optional

  Wird nach Übereinstimmungen angewendet, um URLs auszuschließen, die diesem Glob entsprechen. Ist zur Emulation des Keywords @Ausschließen Greasemonkey vorgesehen.

• exclude_matches

  string[] optional

  Schließt Seiten aus, auf denen dieses Inhaltsskript andernfalls eingeschleust werden würde.

• include_globs

  string[] optional

  Wird nach Übereinstimmungen angewendet, um nur die URLs einzuschließen, die auch mit diesem Glob übereinstimmen. Dient zur Emulation des Suchbegriffs @include Greasemonkey.

• 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 eingeschleust, in der sie erscheinen.

• match_about_blank

  Boolescher Wert optional

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

• Übereinstimmungen

  String[]

  Gibt an, auf welche Seiten dieses Inhaltsskript eingeschleust wird.

• name

  String

  Der Name des einzufügenden Inhaltsskripts.

• run_at

  RunAt optional

  Das Datum, bis zu dem der JavaScript- oder CSS-Code frühestens in den Tab eingeschleust wird. Der Standardwert ist „document_idle“.

ContentWindow

Nachrichten-Alias für ein Gastfenster.

Attribute

• postMessage

  void

  Es wird eine Nachricht an den eingebetteten Webinhalt gepostet, solange in dem eingebetteten Inhalt eine Seite des Zielursprungs angezeigt wird. Diese Methode ist verfügbar, sobald das Laden der Seite abgeschlossen ist. Warten Sie auf das Ereignis contentload und rufen Sie dann die Methode auf.

  Der Gast kann Antworten an den eingebetteten Nutzer senden, indem er zu dem Nachrichtenereignis, das er erhält, eine Nachricht an event.source postet.

  Diese API ist für die Kommunikation zwischen Webseiten identisch mit der HTML5 postMessage API. Der Einbettunger kann auf Antworten warten, indem er einen message-Event-Listener zu seinem eigenen Frame 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, welcher Ursprung das Gastfenster sein muss, damit das Ereignis gesendet wird.

ContextMenuCreateProperties

Chrome 44 und höher

Attribute

• ausgewählt

  Boolescher Wert optional

  Der Anfangszustand eines Kästchens oder Optionsfelds: „true“ für „ausgewählt“ und „false“ für „nicht ausgewählt“. In einer Gruppe von Elementen 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 erfolgt, wird standardmäßig ['page'] verwendet.

• documentUrlPatterns

  string[] optional

  Ermöglicht das Einschränken des Elements auf Dokumente, 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

  Boolescher Wert optional

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

• id

  String optional

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

• parentId

  String|Zahl optional

  Die ID eines übergeordneten Menüpunkts. Dadurch wird der Artikel einem zuvor hinzugefügten Element untergeordnet.

• targetUrlPatterns

  string[] optional

  Ähnlich wie „documentUrlPatterns“, doch lässt sich mithilfe des src-Attributs der „img/audio/video“-Tags und des href der Anchor-Tags filtern.

• Titel

  String optional

  Der Text, der im Element angezeigt werden soll. Dies ist erforderlich, es sei denn, type ist ein Trennzeichen. Wenn der Kontext „Auswahl“ lautet, können Sie innerhalb des Strings %s 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üeintrag für die Auswahl „Übersetzen von ‚cool‘ in Pig Latin“.

• Typ

  ItemType optional

  Die Art des Menüpunkts. Ist keine Angabe vorhanden, wird standardmäßig „normal“ verwendet.

• onclick

  void optional

  Eine Funktion, die beim Klicken auf das Menüelement aufgerufen wird.

  Die Funktion onclick sieht so aus:

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

  • Info

    OnClickData

    Informationen zum angeklickten Artikel und Kontext, in dem der Klick erfolgte

ContextMenus

Chrome 44 und höher

Attribute

• onShow

  Ereignis<functionvoidvoid>

  Wird ausgelöst, bevor auf diesem webview ein Kontextmenü angezeigt wird. Kann zum Deaktivieren dieses Kontextmenüs durch Aufrufen von event.preventDefault() verwendet werden.

  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 auf, um zu verhindern, dass das Kontextmenü angezeigt wird.

        Die Funktion preventDefault sieht so aus:

        ()=> {...}

• Entwicklung

  void

  Erstellt ein neues Kontextmenüelement. Hinweis: Wenn während der Erstellung ein Fehler auftritt, erfahren Sie dies möglicherweise erst, wenn der Erstellungs-Callback ausgelöst wird (Details finden Sie in runtime.lastError).

  Die Funktion create sieht so aus:

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

  • createProperties

    Objekt

    Die Eigenschaften, die zum Erstellen des Elements verwendet wurden

  • callback

    Funktion optional

    Der Parameter callback sieht so aus:

    ()=>void

  • Gibt zurück

    string|number

    Die ID des neu erstellten Elements

• entfernen

  void

  Entfernt einen Kontextmenüeintrag.

  Die Funktion remove sieht so aus:

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

  • menuItemId

    string|number

    Die ID des zu entfernenden Kontextmenüelements.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus:

    ()=>void

• removeAll

  void

  Entfernt alle Kontextmenüeinträge, die diesem/r webview hinzugefügt wurden.

  Die Funktion removeAll sieht so aus:

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus:

    ()=>void

• update

  void

  Aktualisiert ein zuvor erstelltes Kontextmenü.

  Die Funktion update sieht so aus:

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

  • id

    string|number

    Die ID des Artikels, der aktualisiert werden soll.

  • updateProperties

    Objekt

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

  • callback

    Funktion 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: „true“ für „ausgewählt“ und „false“ für „nicht ausgewählt“. In einer Gruppe von Elementen 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

  Ermöglicht das Einschränken des Elements auf Dokumente, 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

  Boolescher Wert optional

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

• parentId

  String|Zahl optional

  Die ID eines übergeordneten Menüpunkts. Dadurch wird der Artikel einem zuvor hinzugefügten Element untergeordnet. Hinweis:Sie können ein Element nicht in ein untergeordnetes Element von Nachfolgerelementen umwandeln.

• targetUrlPatterns

  string[] optional

  Ähnlich wie „documentUrlPatterns“, doch lässt sich mithilfe des src-Attributs der „img/audio/video“-Tags und des href der Anchor-Tags filtern.

• Titel

  String optional

  Der Text, der im Element angezeigt werden soll

• Typ

  ItemType optional

  Die Art des Menüpunkts.

• onclick

  void optional

  Eine Funktion, die beim Klicken auf das Menüelement aufgerufen wird.

  Die Funktion onclick sieht so aus:

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

  • Info

    OnClickData

    Informationen zum angeklickten Artikel und Kontext, in dem der Klick erfolgte

ContextType

Chrome 44 und höher

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

Enum

DialogController

An dialog-DOM-Ereignisse angehängte Schnittstelle.

Attribute

• Abbrechen

  void

  Dialogfeld ablehnen. Entspricht dem Klicken auf „Abbrechen“ in einem confirm- oder prompt-Dialogfeld.

  Die Funktion cancel sieht so aus:

  ()=> {...}

• Ok

  void

  Bestätigen Sie den Dialog. 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 zur Verfügung gestellt wird, wenn ein prompt-Dialogfeld akzeptiert wird.

DownloadPermissionRequest

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

Attribute

• requestMethod

  String

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

• url

  String

  Die angeforderte Download-URL.

• allow

  void

  Lassen Sie die Berechtigungsanfrage zu.

  Die Funktion allow sieht so aus:

  ()=> {...}

• deny

  void

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

  Die Funktion deny sieht so aus:

  ()=> {...}

FileSystemPermissionRequest

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

Attribute

• url

  String

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

• allow

  void

  Lassen Sie die Berechtigungsanfrage zu.

  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 Suche-Anfrage.

Attribute

• activeMatchOrdinal

  Zahl

  Ordinalzahl der aktuellen Übereinstimmung.

• annulliert

  boolean

  Gibt an, ob diese Suchanfrage abgebrochen wurde.

• numberOfMatches

  Zahl

  Gibt an, wie oft searchText auf der Seite in Übereinstimmung gebracht 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, das auf Groß- und Kleinschreibung achtet. Der Standardwert ist false.

FullscreenPermissionRequest

Chrome 43 und höher

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

Attribute

• Ursprung

  String

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

• allow

  void

  Lassen Sie die Berechtigungsanfrage zu.

  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 ein geolocation-permissionrequest-DOM-Ereignis begleitet.

Attribute

• url

  String

  Die URL des Frames, der Zugriff auf die Standortbestimmungsdaten anfordert.

• allow

  void

  Lassen Sie die Berechtigungsanfrage zu.

  Die Funktion allow sieht so aus:

  ()=> {...}

• deny

  void

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

  Die Funktion deny sieht so aus:

  ()=> {...}

HidPermissionRequest

Ausstehend

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

  Lassen Sie die Berechtigungsanfrage zu.

  Die Funktion allow sieht so aus:

  ()=> {...}

• deny

  void

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

  Die Funktion deny sieht so aus:

  ()=> {...}

InjectDetails

Details zum zu injizierenden Skript oder CSS-Code. Es muss entweder der Code oder die Dateieigenschaft festgelegt werden, aber beides kann nicht gleichzeitig festgelegt werden.

Attribute

• Code

  String optional

  JavaScript- oder CSS-Code, der eingeschleust werden soll.

  Warnung:Verwenden Sie den Parameter code mit Vorsicht. Bei unsachgemäßer Verwendung kann es dazu kommen, dass Ihre App für Cross-Site-Scripting-Angriffe geöffnet wird.

• 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 Reihe von Dateien.

Attribute

• Code

  String optional

  JavaScript-Code oder CSS, der in übereinstimmende Seiten eingeschleust werden soll

• Dateien

  string[] optional

  Die Liste der JavaScript- oder CSS-Dateien, die in übereinstimmende Seiten eingeschleust werden sollen. Diese werden in der Reihenfolge eingeschleust, in der sie in diesem Array erscheinen.

LoadPluginPermissionRequest

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

Attribute

• identifier

  String

  Der ID-String des Plug-ins.

• name

  String

  Der Anzeigename des Plug-ins.

• allow

  void

  Lassen Sie die Berechtigungsanfrage zu. Das ist die Standardeinstellung, 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 ein media-permissionrequest-DOM-Ereignis begleitet.

Attribute

• url

  String

  Die URL des Frames, der Zugriff auf Nutzermedien anfordert.

• allow

  void

  Lassen Sie die Berechtigungsanfrage zu.

  Die Funktion allow sieht so aus:

  ()=> {...}

• deny

  void

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

  Die Funktion deny sieht so aus:

  ()=> {...}

NewWindow

An newwindow-DOM-Ereignisse angehängte Schnittstelle.

Attribute

• anhängen

  void

  Hängen Sie die angeforderte Landingpage 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

  Anfrage für neues Fenster abbrechen.

  Die Funktion discard sieht so aus:

  ()=> {...}

PointerLockPermissionRequest

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

Attribute

• lastUnlockedBySelf

  boolean

  Gibt an, ob der anfragende Frame der letzte Client war, der eine Zeigersperre besitzt.

• url

  String

  Die URL des Frames, der die Zeigersperre anfordert.

• userGesture

  boolean

  Gibt an, ob die Zeigersperre als Ergebnis einer Nutzereingabegeste angefordert wurde.

• allow

  void

  Lassen Sie die Berechtigungsanfrage zu.

  Die Funktion allow sieht so aus:

  ()=> {...}

• deny

  void

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

  Die Funktion deny sieht so aus:

  ()=> {...}

SelectionRect

Beschreibt ein Rechteck in Bildschirmkoordinaten.

Die Begrenzungssemantik ist Array-ähnlich. Das heißt, es wird davon ausgegangen, dass die Koordinate (left, top) vom Rechteck enthalten ist, 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 zwischen dem oberen Bildschirmrand und dem oberen Rand des Rechtecks

• Breite

  Zahl

  Breite des Rechtecks.

WebRequestEventInterface

Chrome 44 und höher

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

Der folgende Beispielcode zeigt, wie sich die Nutzung von der WebRequest API der Erweiterungen unterscheidet, mit der alle Gastanfragen für URLs blockiert werden, 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. Weitere Informationen zur API finden Sie unter declarativeWebRequest.

Bedingungen und Aktionen für deklarative WebView-webRequests sollten von ihren chrome.webViewRequest.*-Gegenstücken instanziiert werden. Mit dem folgenden Beispielcode werden alle Anfragen an "example.com" in der WebView-myWebview deklarativ blockiert:

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

ZoomMode

Chrome 43 und höher

Definiert, wie das Zoomen in webview gehandhabt wird.

Enum

"per-origin"
Zoomänderungen bleiben im Ursprung der vergrößerten Seite erhalten, d.h., alle anderen Webansichten in derselben Partition, die zu demselben Ursprung navigiert sind, werden ebenfalls gezoomt. Außerdem werden per-origin-Zoomänderungen mit dem Ursprung gespeichert. Das bedeutet, dass beim Aufrufen anderer Seiten mit demselben Ursprung alle Zoomstufen auf den gleichen Zoomfaktor gezoomt werden.

"Per-View"
Zoomänderungen werden nur in dieser WebView wirksam und Zoomänderungen in anderen WebViews wirken sich nicht auf das Zoomen dieser WebView aus. Außerdem werden per-view-Zoomänderungen bei der Navigation zurückgesetzt. Beim Navigieren in einer Webansicht werden immer die Seiten mit den Zoomfaktoren pro Ursprung (innerhalb der Partition) geladen.

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

Attribute

contentWindow

Objektreferenz, mit der Nachrichten auf der Gastseite 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. Verwenden Sie die webview.contextMenus API, um Elemente zum Kontextmenü von webview hinzuzufügen. Sie können auswählen, für welche Objekttypen die Elemente im Kontextmenü gelten, z. B. Bilder, Hyperlinks und Seiten.

Typ

ContextMenus

request

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

Typ

WebRequestEventInterface

Methoden

addContentScripts()

Chrome 44 und höher

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

Fügt Regeln für das Einschleusen von Content-Skripten in webview ein. Wenn das webview eine Seite aufruft, die einer oder mehreren Regeln entspricht, werden die zugehörigen Skripts eingefügt. Sie können programmatisch Regeln hinzufügen oder vorhandene Regeln aktualisieren.

Im folgenden Beispiel werden dem webview zwei Regeln hinzugefügt: „myRule“ und „AndereRule“.

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

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

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

Das folgende Beispiel zeigt, 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 navigiert wurde (z.B. foo.com) und webview.addContentScripts aufruft, um „myRule“ hinzuzufügen, müssen Sie auf die nächste Navigation warten, damit die Skripts eingefügt werden. Wenn Sie eine sofortige Injektion wünschen, übernimmt executeScript das Richtige.

Die Regeln werden auch dann beibehalten, wenn der Gastprozess abstürzt oder beendet wird oder der webview ein neues übergeordnetes Element zugewiesen wird.

Weitere Informationen finden Sie in der Dokumentation zu Contentskripts.

Parameter

• contentScriptList

  [ContentScriptDetails,...ContentScriptDetails[]]

  Details zu den hinzuzufügenden Inhaltsskripts

back()

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

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

Parameter

• callback

  Funktion optional

  Chrome 44 und höher

  Der Parameter callback sieht so aus:

  (success: boolean)=>void

  • Erfolg

    boolean

    Gibt an, ob die Navigation erfolgreich war.

canGoBack()

chrome.webviewTag.canGoBack()

Gibt an, ob durch den Verlauf rückwärts navigiert werden kann. Der Status dieser Funktion wird im Cache gespeichert und vor jedem loadcommit-Objekt aktualisiert. Daher sollte sie am besten unter loadcommit aufgerufen werden.

Returns

• boolean

canGoForward()

chrome.webviewTag.canGoForward()

Gibt an, ob im Verlauf vorwärts navigiert werden kann. Der Status dieser Funktion wird im Cache gespeichert und vor jedem loadcommit-Objekt aktualisiert. Daher sollte sie am besten unter loadcommit aufgerufen werden.

Returns

• boolean

captureVisibleRegion()

Chrome 50 oder höher

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

Erfasst den sichtbaren Bereich der WebView.

Parameter

• Optionen

  ImageDetails optional

• callback

  Funktion

  Der Parameter callback sieht so aus:

  (dataUrl: string)=>void

  • dataUrl

    String

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

clearData()

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

Löscht Browserdaten für die Partition webview.

Parameter

• Optionen

  ClearDataOptions

  Optionen, die bestimmen, welche Daten gelöscht werden sollen.

• Typ

  ClearDataTypeSet

  Die Datentypen, die gelöscht werden sollen.

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  ()=>void

executeScript()

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

JavaScript-Code wird auf der Gastseite eingefügt.

Im folgenden Beispielcode wird mithilfe einer Skripteinschleusung die Hintergrundfarbe der Gastseite auf Rot eingestellt:

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

Parameter

• Details

  InjectDetails

  Details zum auszuführenden Skript.

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  (result?: any[])=>void

  • Ergebnis

    Beliebig[] optional

    Das Ergebnis des Skripts in jedem eingefügten Frame.

find()

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

Initiiert eine Anfrage vom Typ „Auf Seite suchen“.

Parameter

• searchText

  String

  Zeichenfolge, die auf der Seite gesucht werden soll

• Optionen

  FindOptions optional

  Optionen für die Suchanfrage.

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  (results?: FindCallbackResults)=>void

  • Ergebnisse

    FindCallbackResults optional

    Enthält alle Ergebnisse der Suche-Anfrage. results kann weggelassen werden, wenn es nicht im Callback-Funktionsrumpf verwendet wird, z. B. wenn der Callback nur verwendet wird, um zu erkennen, wann die Suchanfrage abgeschlossen ist.

forward()

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

Navigiert nach Möglichkeit einen Verlaufseintrag vorwärts. Gleichbedeutend mit go(1).

Parameter

• callback

  Funktion optional

  Chrome 44 und höher

  Der Parameter callback sieht so aus:

  (success: boolean)=>void

  • Erfolg

    boolean

    Gibt an, ob die Navigation erfolgreich war.

getAudioState()

Chrome 62 und höher

chrome.webviewTag.getAudioState(
  callback: function,
)

Fragt den Audiostatus ab.

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, sodass Einbettungen wissen, wie viele Gäste von einer Beendigung des Prozesses betroffen wären. Zwei Gäste teilen sich nur dann einen Prozess, wenn sie derselben App angehören und dieselbe Speicherpartitions-ID haben. Der Aufruf ist synchron und gibt den im Cache gespeicherten Begriff der aktuellen Prozess-ID des Einbettungsanbieters zurück. Die Prozess-ID ist nicht mit der Prozess-ID des Betriebssystems identisch.

Returns

• Zahl

getUserAgent()

chrome.webviewTag.getUserAgent()

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

Returns

• 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 des webview.

go()

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

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

Parameter

• relativeIndex

  Zahl

  Relativer Verlaufsindex, zu dem das webview-Objekt navigiert werden soll. Beispiel: Mit dem Wert 2 werden wenn möglich zwei Verlaufseinträge vorwärts navigiert. Mit dem Wert -3 werden drei Einträge zurückgenavigiert.

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  (success: boolean)=>void

  • Erfolg

    boolean

    Gibt an, ob die Navigation erfolgreich war.

insertCSS()

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

CSS in die Gastseite einfügen

Parameter

• Details

  InjectDetails

  Details des einzufügenden CSS-Codes.

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  ()=>void

isAudioMuted()

Chrome 62 und höher

chrome.webviewTag.isAudioMuted(
  callback: function,
)

Fragt, ob Audio stummgeschaltet ist.

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus:

  (muted: boolean)=>void

  • stummgeschaltet

    boolean

isSpatialNavigationEnabled()

Chrome 71 und höher

chrome.webviewTag.isSpatialNavigationEnabled(
  callback: function,
)

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

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus:

  (enabled: boolean)=>void

  • aktiviert

    boolean

isUserAgentOverridden()

chrome.webviewTag.isUserAgentOverridden()

Gibt an, ob der User-Agent-String von webview von 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 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 der Nutzer in der Adressleiste sieht.

print()

chrome.webviewTag.print()

Gibt den Inhalt von webview aus. Dies entspricht dem Aufrufen einer skriptbasierten Druckfunktion aus webview selbst.

reload()

chrome.webviewTag.reload()

Lädt die aktuelle Seite der obersten Ebene neu.

removeContentScripts()

Chrome 44 und höher

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

Entfernt Inhaltsskripte aus einem webview.

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

webview.removeContentScripts(['myRule']);

Sie können alle Regeln durch folgenden Aufruf entfernen:

webview.removeContentScripts();

Parameter

• scriptNameList

  string[] optional

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

setAudioMuted()

Chrome 62 und höher

chrome.webviewTag.setAudioMuted(
  mute: boolean,
)

Legt die Audiostummschaltung der WebView fest.

Parameter

• Stummschalten

  boolean

  Wert für „Audio stummschalten“

setSpatialNavigationEnabled()

Chrome 71 und höher

chrome.webviewTag.setSpatialNavigationEnabled(
  enabled: boolean,
)

Legt den räumlichen Navigationsstatus der WebView fest.

Parameter

• aktiviert

  boolean

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

setUserAgentOverride()

chrome.webviewTag.setUserAgentOverride(
  userAgent: string,
)

Überschreibt den User-Agent-String, der von webview für Gastseitenanfragen verwendet wird. Das Überschreiben führt dazu, dass die Werte im Header „User-Agent-Client-Hint“ und die von „navigator.userAgentData“ zurückgegebenen Werte bei Gastseitenanfragen, auf die diese Überschreibung angewendet wird, leer sind.

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 WebView bestimmt (siehe webviewTag.ZoomMode).

Parameter

• zoomFactor

  Zahl

  Der neue Zoomfaktor.

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  ()=>void

setZoomMode()

Chrome 43 und höher

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

Legt den Zoommodus von webview fest.

Parameter

• ZoomMode

  ZoomMode

  Definiert, wie das Zoomen in webview gehandhabt wird.

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  ()=>void

stop()

chrome.webviewTag.stop()

Wenn die Navigation gerade läuft, wird das Laden der aktuellen webview-Navigation beendet.

stopFinding()

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

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

Parameter

• Aktion

   optional

  Legt fest, was mit der aktiven Übereinstimmung nach dem Ende der Suchsitzung geschehen soll. Mit clear wird die Markierung über der aktiven Übereinstimmung entfernt. Bei keep bleibt die aktive Übereinstimmung hervorgehoben. activate sorgt dafür, dass die aktive Übereinstimmung hervorgehoben wird, und simuliert einen Nutzerklick auf diese Übereinstimmung. Die Standardaktion ist keep.

terminate()

chrome.webviewTag.terminate()

Beendet den Rendererprozess der Gastwebseite zwangsweise. Dies 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.

Veranstaltungen

close

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

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

Mit dem folgenden Beispielcode wird webview zu about:blank gewechselt, 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.

Mit dem folgenden Beispielcode werden alle Lognachrichten an die Konsole des Einbettungsanbieters weitergeleitet, ohne die Logebene oder andere Eigenschaften zu berücksichtigen.

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. beim Laden eines neuen Dokuments. Dies gilt nicht für die Seitennavigation im aktuellen Dokument oder das Laden von asynchronen Ressourcen.

Mit dem folgenden Beispielcode wird die Standardschriftgröße des body-Elements des Gasts geändert, nachdem die Seite geladen wurde:

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.

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

Das Dialogfeld wird standardmäßig abgebrochen.

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus:

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

  • messageType

  • messageText

    String

  • kleines Fenster

    DialogController

exit

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

Wird ausgelöst, wenn der Prozess zum Rendern der Gastwebinhalte beendet wurde.

Der folgende Beispielcode zeigt eine Abschiedsnachricht, 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:

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

  • processID

    Zahl

  • reason

    "normal"
    |"abnormal"
    |"absturz"
    |"kill"
    

findupdate

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

Wird ausgelöst, wenn neue Suchergebnisse für eine aktive Suche verfügbar sind. Das kann bei einer einzelnen Suchanfrage mehrmals vorkommen, 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

  • annulliert

    boolean

  • finalUpdate

    String

loadabort

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

Wird ausgelöst, wenn ein Ladevorgang auf oberster Ebene ohne Commit abgebrochen wurde. Eine Fehlermeldung wird in der Konsole ausgegeben, es sei denn, der Termin wird standardmäßig verhindert.

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

Hinweis:Wenn das Laden einer Info- oder einer JavaScript-URL abgebrochen wird, wird loadabort ausgelöst und webview wird dann 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_SCHEME""ERR_FILE_NOT_SCHEME"
    
    

loadcommit

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

Wird ausgelöst, wenn für einen Ladevorgang ein Commit durchgeführt wurde. Dazu gehören die Navigation im aktuellen Dokument sowie Ladevorgänge auf Dokumentebene von Subframes, aber keine asynchronen Ressourcenladevorgänge.

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus:

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

  • url

    String

  • isTopLevel

    boolean

loadredirect

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

Wird ausgelöst, wenn eine Ladeanfrage auf oberster Ebene 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 Frameebene auf einer Gastseite (einschließlich aller Subframes) abgeschlossen sind. Dazu gehören die Navigation im aktuellen Dokument sowie Ladevorgänge auf Dokumentebene von Subframes, aber keine asynchronen Ressourcenladevorgänge. Dieses Ereignis wird jedes Mal ausgelöst, wenn die Anzahl der Ladevorgänge auf Dokumentebene von eins (oder mehr) auf null übergeht. Wenn eine Seite, die bereits geladen wurde (z.B. loadstop bereits einmal ausgelöst) erstellt einen neuen iFrame, der eine Seite lädt. Anschließend wird ein zweiter loadstop ausgelöst, wenn der iFrame-Seitenaufbau abgeschlossen ist. Dieses Muster tritt häufig auf Seiten auf, auf denen Anzeigen geladen werden.

Hinweis: Wenn ein Commit-Ladevorgang abgebrochen wird, folgt schließlich das Ereignis loadstop auf das Ereignis loadabort, 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-Objekt im Einbettungsprogramm erstellt und darin 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: "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 für die Gastseite eine spezielle Berechtigung vom Einbettungscode angefordert werden muss

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

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

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus:

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

  • Berechtigung

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

  • Request

    Objekt

responsive

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

Wird ausgelöst, wenn der Prozess des Renderings der Gastwebinhalte wieder responsiv wird, wenn der Gast nicht mehr reagiert.

Mit dem folgenden Beispielcode wird das webview-Element ein- bzw. ausgeblendet, wenn es responsiv wird 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 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 zum Rendern der Gastwebinhalte nicht mehr reagiert. Dieses Ereignis wird einmal mit einem passenden 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 die Zoomstufe der Seite ändert

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus:

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

  • oldZoomFactor

    Zahl

  • newZoomFactor

    Zahl