chrome.webviewTag

Beschreibung

Mit dem Tag webview können Sie Liveinhalte aus dem Web aktiv über das Netzwerk laden und in Ihre Chrome-App einbetten. Deine App kann die Darstellung von webview steuern und mit den Webinhalten interagieren, die Navigation auf einer eingebetteten Webseite einleiten, auf darin auftretende Fehlerereignisse reagieren und vieles mehr (siehe Nutzung).

Berechtigungen

webview

Typen

ClearDataOptions

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

Attribute

• seit

  Zahl optional

  Löscht Daten, die an oder nach diesem Datum gesammelt wurden, angegeben in Millisekunden seit der Epoche (aufrufbar über die getTime-Methode des JavaScript-Date-Objekts). Wird keine Angabe gemacht, wird standardmäßig 0 verwendet. Dadurch werden alle Browserdaten gelöscht.

ClearDataTypeSet

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

Attribute

• App-Cache

  Boolescher Wert optional

  Websites appcaches.

• Cache

  Boolescher Wert optional

  Chrome (ab Version 44)

  Seit Chrome-Version 43. Im Cache des Browsers Hinweis: Beim Entfernen von Daten wird dadurch der gesamte Cache geleert. nicht auf den von Ihnen angegebenen Bereich beschränkt.

• Cookies

  Boolescher Wert optional

  Die Cookies der Partition.

• fileSystems

  Boolescher Wert optional

  Websites Dateisystemen.

• indexedDB

  Boolescher Wert optional

  Websites IndexedDB-Daten.

• localStorage

  Boolescher Wert optional

  Websites im lokalen Speicher.

• persistentCookies

  Boolescher Wert optional

  Chrome (ab Version 58)

  Die persistenten Cookies der Partition.

• sessionCookies

  Boolescher Wert optional

  Chrome (ab Version 58)

  Die Sitzungscookies der Partition.

• webSQL

  Boolescher Wert optional

  Websites WebSQL-Daten.

ContentScriptDetails

Chrome (ab Version 44)

Details des Inhaltsskripts, das eingefügt werden soll. Weitere Informationen finden Sie in der Dokumentation zu Content-Skripts.

Attribute

• all_frames

  Boolescher Wert optional

  Wenn all_frames auf true gesetzt ist, impliziert 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 eingefügt.

• css

  InjectionItems optional

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

• exclude_globs

  string[] optional

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

• exclude_matches

  string[] optional

  Schließt Seiten aus, in die dieses Inhaltsskript andernfalls eingeschleust würde.

• include_globs

  string[] optional

  Wird nach Übereinstimmungen angewendet, um nur die URLs einzuschließen, die auch mit diesem Glob übereinstimmen. Ist zur Emulierung des Keywords @include Greasemonkey vorgesehen.

• JS

  InjectionItems optional

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

• match_about_blank

  Boolescher Wert optional

  Gibt an, ob das Inhaltsskript in about:blank und about:srcdoc eingefügt werden soll. Inhaltsskripte werden nur in Seiten eingeschleust, wenn ihre übernommene URL mit einem der angegebenen Muster im Übereinstimmungsfeld übereinstimmt. Bei der URL zum Übernehmen handelt es sich um die URL des Dokuments, in dem der Frame oder das Fenster erstellt wurde. Inhaltsskripte können nicht in Frames eingefügt werden, die in einer Sandbox ausgeführt werden.

• stimmt überein mit

  String[]

  Gibt an, in welche Seiten dieses Inhaltsskript eingeschleust wird.

• Name

  String

  Der Name des einzuschleusenden Inhaltsskripts.

• run_at

  RunAt optional

  Das früheste Datum, an dem der JavaScript- oder CSS-Code in den Tab injiziert wird. Die Standardeinstellung ist „document_idle“.

ContentWindow

Alias für die Nachricht an ein Gastfenster.

Attribute

• postMessage

  voidm

  Veröffentlicht eine Nachricht an den eingebetteten Webinhalt, solange in dem eingebetteten Inhalt eine Seite des Zielursprungs angezeigt wird. Diese Methode ist verfügbar, sobald die Seite vollständig geladen ist. Warten Sie auf das Ereignis contentload und rufen Sie dann die Methode auf.

  Der Gast kann Antworten an den Einbettungscode senden, indem er zu dem empfangenen Nachrichtenereignis eine Nachricht an event.source postet.

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

  Die Funktion postMessage sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • Nachricht

    beliebig

    Nachrichtenobjekt, das an den Gast gesendet werden soll

  • targetOrigin

    String

    Gibt den Ursprung des Gastfensters an, damit das Ereignis gesendet wird.

ContextMenuCreateProperties

Chrome (ab Version 44)

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 Optionsfeldern kann jeweils nur ein Optionsfeld ausgewählt werden.

• contexts

  [ContextType, ...ContextType[]] optional

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

• documentUrlPatterns

  string[] optional

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

• aktiviert

  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 Element zugewiesen werden soll. Obligatorisch für Veranstaltungsseiten. Darf nicht mit einer anderen ID für diese Erweiterung identisch sein.

• parentId

  string | Zahl optional

  Die ID eines übergeordneten Menüelements. wird das Element einem zuvor hinzugefügten Element untergeordnet.

• targetUrlPatterns

  string[] optional

  Ähnlich wie „documentUrlPatterns“, ermöglicht aber das Filtern basierend auf dem Attribut src von img/audio/video-Tags und dem href von Anchor-Tags.

• 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“ ist, können Sie im String %s verwenden, um den ausgewählten Text anzuzeigen. Lautet der Wert dieses Parameters beispielsweise "%s" übersetzen, zu Pig Latin“ und der Nutzer das Wort „cool“ auswählt, ist das Kontextmenüelement für die Auswahl „Übersetze ‚cool‘“. zu Pig Latin“.

• Typ

  ItemType optional

  Die Art des Menüelements. Die Standardeinstellung ist „normal“. falls nicht angegeben.

• onclick

  void optional

  Eine Funktion, die beim Anklicken des Menüelements zurückgerufen wird.

  Die Funktion onclick sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • Info

    OnClickData

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

ContextMenus

Chrome (ab Version 44)

Attribute

• onShow

  Ereignis<functionvoidvoid>

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

  Die Funktion onShow.addListener sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (event: object) => void

    • event

      Objekt

      • preventDefault

        voidm

        Rufen Sie dies auf, um zu verhindern, dass das Kontextmenü angezeigt wird.

        Die Funktion preventDefault sieht so aus: <ph type="x-smartling-placeholder"></ph>

        () => {...}

• create

  voidm

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

  Die Funktion create sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • createProperties

    Objekt

    Die Eigenschaften, die zum Erstellen des Elements verwendet wurden

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void

  • Gibt zurück

    string | Nummer

    Die ID des neu erstellten Elements.

• Entfernen

  voidm

  Entfernt einen Kontextmenüeintrag.

  Die Funktion remove sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • menuItemId

    string | Nummer

    Die ID des Kontextmenüelements, das entfernt werden soll.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void

• removeAll

  voidm

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

  Die Funktion removeAll sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void

• update

  voidm

  Aktualisiert einen zuvor erstellten Kontextmenüeintrag.

  Die Funktion update sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • id

    string | Nummer

    Die ID des zu aktualisierenden Elements.

  • updateProperties

    Objekt

    Die zu aktualisierenden Eigenschaften. Akzeptiert dieselben Werte wie die Funktion create.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void

ContextMenuUpdateProperties

Chrome (ab Version 44)

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 Optionsfeldern kann jeweils nur ein Optionsfeld ausgewählt werden.

• contexts

  [ContextType, ...ContextType[]] optional

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

• documentUrlPatterns

  string[] optional

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

• aktiviert

  Boolescher Wert optional

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

• parentId

  string | Zahl optional

  Die ID eines übergeordneten Menüelements. wird das Element einem zuvor hinzugefügten Element untergeordnet. Hinweis: Sie können ein Element nicht so ändern, dass es einem seiner eigenen Nachfolgerelemente untergeordnet ist.

• targetUrlPatterns

  string[] optional

  Ähnlich wie „documentUrlPatterns“, ermöglicht aber das Filtern basierend auf dem Attribut src von img/audio/video-Tags und dem href von Anchor-Tags.

• Titel

  String optional

  Der Text, der im Element angezeigt werden soll

• Typ

  ItemType optional

  Die Art des Menüelements.

• onclick

  void optional

  Eine Funktion, die beim Anklicken des Menüelements zurückgerufen wird.

  Die Funktion onclick sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • Info

    OnClickData

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

ContextType

Chrome (ab Version 44)

Die verschiedenen Kontexte, in denen ein Menü angezeigt werden kann. "all" angeben entspricht der Kombination aller anderen Kontexte.

Enum

"alle"

„Seite“

"Frame"

"Auswahl"

"Link"

"bearbeitbar"

"Bild"

"Video"

"Audio"

DialogController

Mit dialog-DOM-Ereignissen verknüpfte Schnittstelle.

Attribute

• Abbrechen

  voidm

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

  Die Funktion cancel sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

• Ok

  voidm

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

  Die Funktion ok sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • Antwort

    String optional

    Der Antwortstring, der dem Gast beim Akzeptieren eines prompt-Dialogfelds zur Verfügung gestellt 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

  voidm

  Lassen Sie die Berechtigungsanfrage zu.

  Die Funktion allow sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

• deny

  voidm

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

  Die Funktion deny sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

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

  voidm

  Lassen Sie die Berechtigungsanfrage zu.

  Die Funktion allow sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

• deny

  voidm

  Lehnen Sie die Berechtigungsanfrage ab.

  Die Funktion deny sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

FindCallbackResults

Enthält alle Ergebnisse der Find-Anfrage.

Attribute

• activeMatchOrdinal

  Zahl

  Die Ordinalzahl der aktuellen Übereinstimmung.

• abgebrochen

  boolean

  Gibt an, ob diese Suchanfrage abgebrochen wurde.

• numberOfMatches

  Zahl

  Gibt an, wie oft searchText auf der Seite Übereinstimmungen gefunden hat.

• selectionRect

  SelectionRect

  Beschreibt ein Rechteck um die aktive Übereinstimmung in Bildschirmkoordinaten.

FindOptions

Optionen für die „Find“-Anfrage.

Attribute

• rückwärts

  Boolescher Wert optional

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

• matchCase

  Boolescher Wert optional

  Für Übereinstimmung mit Groß- und Kleinschreibung kennzeichnen. Der Standardwert ist false.

FullscreenPermissionRequest

Chrome (ab Version 43)

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

Attribute

• origin

  String

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

• allow

  voidm

  Lassen Sie die Berechtigungsanfrage zu.

  Die Funktion allow sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

• deny

  voidm

  Lehnen Sie die Berechtigungsanfrage ab.

  Die Funktion deny sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

GeolocationPermissionRequest

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

Attribute

• URL

  String

  Die URL des Frames, der Zugriff auf Daten zur Standortbestimmung anfordert.

• allow

  voidm

  Lassen Sie die Berechtigungsanfrage zu.

  Die Funktion allow sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

• deny

  voidm

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

  Die Funktion deny sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

HidPermissionRequest

Chrome 125 oder höher

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

Attribute

• URL

  String

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

• allow

  voidm

  Lassen Sie die Berechtigungsanfrage zu.

  Die Funktion allow sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

• deny

  voidm

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

  Die Funktion deny sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

InjectDetails

Details des einzuschleusenden Skripts oder CSS-Codes Es muss entweder der Code oder die Dateieigenschaft festgelegt werden. Beide können nicht gleichzeitig festgelegt werden.

Attribute

• Code

  String optional

  JavaScript- oder CSS-Code einzuführen.

  Warnung: Seien Sie bei der Verwendung des code-Parameters vorsichtig. Bei falscher Verwendung kann Ihre App zu Cross-Site-Scripting-Angriffen führen.

• Datei

  String optional

  JavaScript- oder CSS-Datei, die injiziert werden soll.

InjectionItems

Chrome (ab Version 44)

Der Typ des eingeschleusten Elements: Code oder eine Reihe von Dateien.

Attribute

• Code

  String optional

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

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

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

  voidm

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

  Die Funktion allow sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

• deny

  voidm

  Lehnen Sie die Berechtigungsanfrage ab.

  Die Funktion deny sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

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

  voidm

  Lassen Sie die Berechtigungsanfrage zu.

  Die Funktion allow sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

• deny

  voidm

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

  Die Funktion deny sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

NewWindow

Mit newwindow-DOM-Ereignissen verknüpfte Schnittstelle.

Attribute

• anhängen

  voidm

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

  Die Funktion attach sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • WebView

    Objekt

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

• Verwerfen

  voidm

  Brechen Sie die Anfrage für ein neues Fenster ab.

  Die Funktion discard sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

PointerLockPermissionRequest

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

Attribute

• lastUnlockedBySelf

  boolean

  Gibt an, ob der anfordernde Frame der letzte Client mit Zeigersperre war.

• URL

  String

  Die URL des Frames, der eine Zeigersperre anfordert.

• userGesture

  boolean

  Gibt an, ob die Zeigersperre als Ergebnis einer Geste zur Nutzereingabe angefordert wurde.

• allow

  voidm

  Lassen Sie die Berechtigungsanfrage zu.

  Die Funktion allow sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

• deny

  voidm

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

  Die Funktion deny sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

SelectionRect

Beschreibt ein Rechteck in Bildschirmkoordinaten.

Die Begrenzungssemantik ist Array-ähnlich. Das heißt, die Koordinate (left, top) wird als durch das Rechteck eingeschlossen, die Koordinate (left + width, top) jedoch nicht.

Attribute

• Höhe

  Zahl

  Höhe des Rechtecks

• links

  Zahl

  Abstand vom linken Bildschirmrand zum linken Rand des Rechtecks.

• oben

  Zahl

  Abstand vom oberen Bildschirmrand zum oberen Rand des Rechtecks.

• Breite

  Zahl

  Breite des Rechtecks

WebRequestEventInterface

Chrome (ab Version 44)

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

Anhand des folgenden Beispielcodes werden alle Gastanfragen für URLs blockiert, die mit *://www.evil.com/* übereinstimmen, um die Unterschiede bei der Nutzung von der webRequest API der Erweiterungen zu veranschaulichen:

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-WebView-Anfragen sollten über ihre chrome.webViewRequest.*-Entsprechungen 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 (ab Version 43)

Definiert, wie Zoomen im webview gehandhabt wird.

Enum

"per-origin"
Zoomänderungen bleiben am Ursprung der gezoomten Seite bestehen, d.h. alle anderen WebViews in derselben Partition, die zum selben Ursprung navigiert werden, werden ebenfalls gezoomt. Außerdem werden per-origin Zoomänderungen mit dem Ursprung gespeichert. Das bedeutet, dass beim Navigieren zu anderen Seiten mit demselben Ursprung alle auf denselben Zoomfaktor gezoomt werden.

„Per-View“
Zoomänderungen werden nur in dieser WebView wirksam. Zoomänderungen in anderen WebViews wirken sich nicht auf diese WebView aus. Außerdem werden per-view Zoomänderungen bei der Navigation zurückgesetzt. Beim Navigieren in einer WebView werden Seiten immer mit ihren ursprungsspezifischen Zoomfaktoren (im Bereich der Partition) geladen.

"deaktiviert"
Deaktiviert das Zoomen in der Webansicht Der Inhalt wird auf die Standard-Zoomstufe 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 (ab Version 44)

Ähnlich wie die ContextMenus API von Chrome, gilt aber für webview anstelle des Browsers. Verwende die webview.contextMenus API, um dem Kontextmenü von webview Elemente hinzuzufügen. Sie können auswählen, für welche Typen von Objekten Ihre Kontextmenüs gelten sollen, z. B. Bilder, Hyperlinks und Seiten.

Typ

ContextMenus

request

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

Typ

WebRequestEventInterface

Methoden

addContentScripts()

Chrome (ab Version 44)

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

Fügt Regeln zum Einschleusen von Content-Skripts zum webview hinzu. Wenn über webview eine Seite aufgerufen wird, die mit einer oder mehreren Regeln übereinstimmt, werden die zugehörigen Skripts eingeschleust. Sie können programmatisch Regeln hinzufügen oder vorhandene Regeln aktualisieren.

Im folgenden Beispiel werden der webview zwei Regeln hinzugefügt: „myRule“. und 'andereRegel'.

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 verzögern, 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, um die Skripts einzufügen. Wenn du eine sofortige Injektion wünschen, wird executeScript das Richtige tun.

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

Weitere Informationen finden Sie in der Dokumentation zu Content-Skripts.

Parameter

• contentScriptList

  [ContentScriptDetails, ...ContentScriptDetails[]]

  Details zu den Inhaltsskripten, die hinzugefügt werden sollen.

back()

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

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

Parameter

• callback

  Funktion optional

  Chrome (ab Version 44)

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (success: boolean) => void

  • Erfolg

    boolean

    Gibt an, ob die Navigation erfolgreich war.

canGoBack()

chrome.webviewTag.canGoBack()

Gibt an, ob im Verlauf rückwärts navigiert werden kann. Der Status dieser Funktion wird im Cache gespeichert und vor jeder loadcommit aktualisiert. Der beste Ort zum Aufrufen der Funktion ist also loadcommit.

Gibt Folgendes zurück:

• 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 jeder loadcommit aktualisiert. Der beste Ort zum Aufrufen der Funktion ist also loadcommit.

Gibt Folgendes zurück:

• boolean

captureVisibleRegion()

Chrome 50 und 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: <ph type="x-smartling-placeholder"></ph>

  (dataUrl: string) => void

  • dataUrl

    String

    Eine Daten-URL, die ein Bild des sichtbaren Bereichs des erfassten Tabs codiert. Kann dem 'src' zugewiesen werden eines HTML-Bildelements, das angezeigt werden soll.

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.

• Typen

  ClearDataTypeSet

  Zu löschende Datentypen.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

executeScript()

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

Es wird JavaScript-Code in die Gastseite eingefügt.

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

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

Parameter

• Details

  InjectDetails

  Details zum auszuführenden Skript.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (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 „Auf Seite suchen“-Anfrage.

Parameter

• searchText

  String

  Die Zeichenfolge, die auf der Seite gesucht werden soll.

• Optionen

  FindOptions optional

  Optionen für die „Find“-Anfrage.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (results?: FindCallbackResults) => void

  • Ergebnisse

    FindCallbackResults – optional

    Enthält alle Ergebnisse der Find-Anfrage. results kann weggelassen werden, wenn er nicht im Text der Callback-Funktion verwendet wird. Dies ist beispielsweise der Fall, wenn die Callback-Funktion nur verwendet wird, um zu erkennen, wann die Suchanfrage abgeschlossen ist.

forward()

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

Nach Möglichkeit wird ein Verlaufseintrag vorwärts spulen. Gleichbedeutend mit go(1).

Parameter

• callback

  Funktion optional

  Chrome (ab Version 44)

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (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: <ph type="x-smartling-placeholder"></ph>

  (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 vom Beenden des Prozesses betroffen wären. Zwei Gäste teilen sich nur dann einen Prozess, wenn sie zu derselben Anwendung gehören und dieselbe Speicherpartitions-ID haben. Der Aufruf erfolgt synchron und gibt den zwischengespeicherten Wert der aktuellen 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()

Gibt den User-Agent-String zurück, der von webview für Gastseitenanfragen 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: <ph type="x-smartling-placeholder"></ph>

  (zoomFactor: number) => void

  • zoomFactor

    Zahl

    Der aktuelle Zoomfaktor

getZoomMode()

Chrome (ab Version 43)

chrome.webviewTag.getZoomMode(
  callback: function,
)

Ruft den aktuellen Zoommodus ab.

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (ZoomMode: ZoomMode) => void

  • ZoomMode

    ZoomMode

    Der aktuelle Zoommodus von webview.

go()

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

Navigiert mit einem Verlaufsindex relativ zur aktuellen Navigation 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 navigiert werden soll. Mit dem Wert 2 werden beispielsweise nach Möglichkeit zwei Verlaufseinträge vorwärts navigiert. mit dem Wert -3 navigiert er drei Einträge zurück.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (success: boolean) => void

  • Erfolg

    boolean

    Gibt an, ob die Navigation erfolgreich war.

insertCSS()

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

CSS wird in die Gastseite eingefügt.

Parameter

• Details

  InjectDetails

  Details zum einzufügenden CSS.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

isAudioMuted()

Chrome 62 und höher

chrome.webviewTag.isAudioMuted(
  callback: function,
)

Fragt ab, ob der Ton stummgeschaltet ist.

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (muted: boolean) => void

  • stummgeschaltet

    boolean

isSpatialNavigationEnabled()

Chrome 71 und höher

chrome.webviewTag.isSpatialNavigationEnabled(
  callback: function,
)

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

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (enabled: boolean) => void

  • aktiviert

    boolean

isUserAgentOverridden()

chrome.webviewTag.isUserAgentOverridden()

Gibt an, ob der User-Agent-String der 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 dem Nutzer anstelle der Daten-URL angezeigt wird.

Parameter

• dataUrl

  String

  Die zu ladende Daten-URL.

• baseUrl

  String

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

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

reload()

chrome.webviewTag.reload()

Lädt die aktuelle Seite der obersten Ebene neu

removeContentScripts()

Chrome (ab Version 44)

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

Entfernt Inhaltsskripte aus einem webview.

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

webview.removeContentScripts(['myRule']);

Sie können alle Regeln mit folgendem Aufruf entfernen:

webview.removeContentScripts();

Parameter

• scriptNameList

  string[] optional

  Eine Liste der Namen der Inhaltsskripte, die entfernt werden. Wenn die Liste leer ist, werden alle Inhaltsskripte entfernt, die dem webview hinzugefügt wurden.

setAudioMuted()

Chrome 62 und höher

chrome.webviewTag.setAudioMuted(
  mute: boolean,
)

Legt den Stummschaltungsstatus der WebView fest.

Parameter

• Stummschalten

  boolean

  Wert für Stummschaltung

setSpatialNavigationEnabled()

Chrome 71 und höher

chrome.webviewTag.setSpatialNavigationEnabled(
  enabled: boolean,
)

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

Parameter

• aktiviert

  boolean

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

setUserAgentOverride()

chrome.webviewTag.setUserAgentOverride(
  userAgent: string,
)

Überschreibe den User-Agent-String, der von webview für Gastseitenanfragen verwendet wird. Das Überschreiben führt dazu, dass die Headerwerte für den User-Agent-Client-Hinweis 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 Persistenz der Änderung hängen vom aktuellen Zoommodus der WebView ab (siehe webviewTag.ZoomMode).

Parameter

• zoomFactor

  Zahl

  Der neue Zoomfaktor

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

setZoomMode()

Chrome (ab Version 43)

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

Legt den Zoommodus von webview fest.

Parameter

• ZoomMode

  ZoomMode

  Definiert, wie Zoomen im webview gehandhabt wird.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

stop()

chrome.webviewTag.stop()

Beendet das Laden der aktuellen Navigation für webview.

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

  "löschen"
   | "keep"
   | "aktivieren"
   optional

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

terminate()

chrome.webviewTag.terminate()

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

Ereignisse

close

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

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

Mit dem folgenden Beispielcode wird das webview zu about:blank, 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: <ph type="x-smartling-placeholder"></ph>

  () => void

consolemessage

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

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

Mit dem folgenden Beispielcode werden alle Protokollnachrichten ohne Berücksichtigung der Protokollebene oder anderer Eigenschaften an die Konsole des Einbettungsanbieters weitergeleitet.

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

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (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, also wenn ein neues Dokument geladen wird. Dazu gehört nicht die Seitennavigation im aktuellen Dokument oder das Laden asynchroner 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: <ph type="x-smartling-placeholder"></ph>

  () => void

dialog

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

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

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

Standardmäßig wird das Dialogfeld abgebrochen.

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • messageType

    "Benachrichtigung"
     | "bestätigen"
     | "Prompt"
    

  • messageText

    String

  • kleines Fenster

    DialogController

exit

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

Wird ausgelöst, wenn das Rendern des Webinhalts des Gasts beendet wurde

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

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

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • processID

    Zahl

  • reason

    "normal"
     | "ungewöhnlich"
     | "Absturz"
     | "kill"
    

findupdate

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

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

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • searchText

    String

  • numberOfMatches

    Zahl

  • activeMatchOrdinal

    Zahl

  • selectionRect

    SelectionRect

  • abgebrochen

    boolean

  • finalUpdate

    String

loadabort

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

Wird ausgelöst, wenn ein Ladevorgang auf oberster Ebene ohne Commit abgebrochen wurde. Eine Fehlermeldung wird an die Konsole ausgegeben, sofern das Ereignis nicht standardmäßig verhindert wird.

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

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

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (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"
     | &quot;ERR_INVALID_URL&quot;
     | &quot;ERR_DISALLOWED_URL_SCHEME&quot;
     | &quot;ERR_BLOCKED_BY_CLIENT&quot;
     | "ERR_ADDRESS_UNREACHABLE"
     | &quot;ERR_EMPTY_RESPONSE&quot;
     | &quot;ERR_FILE_NOT_FOUND&quot;
     | &quot;ERR_UNKNOWN_URL_SCHEME&quot;
    

loadcommit

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

Wird ausgelöst, wenn ein Commit für einen Ladevorgang durchgeführt wurde. Dazu gehören die Navigation innerhalb des aktuellen Dokuments sowie Ladevorgänge auf Subframe-Dokumentebene, jedoch nicht das asynchrone Laden von Ressourcen.

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (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: <ph type="x-smartling-placeholder"></ph>

  (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 gestartet wurde

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (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 innerhalb des aktuellen Dokuments sowie Ladevorgänge auf Subframe-Dokumentebene, jedoch nicht das asynchrone Laden von Ressourcen. Dieses Ereignis wird immer dann ausgelöst, wenn die Anzahl der Ladevorgänge auf Dokumentebene von einem (oder mehreren) zu null übergeht. Wenn beispielsweise eine Seite bereits fertig geladen ist (d.h. loadstop bereits einmal ausgelöst) erstellt einen neuen iFrame, der eine Seite lädt. Dann wird ein zweites loadstop ausgelöst, wenn die iFrame-Seite geladen ist. Dieses Muster tritt häufig bei Seiten auf, auf denen Anzeigen geladen werden.

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

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => 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 ein neues webview im Einbettungscode für jedes angeforderte neue Fenster erstellt und aufgerufen:

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

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (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

    "ignorieren"
     | "save_to_disk"
     | "current_tab"
     | &quot;new_background_tab&quot;
     | "new_foreground_tab"
     | "new_window"
     | "new_popup"
    

permissionrequest

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

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

Der folgende Beispielcode gewährt der Gastseite Zugriff auf die webkitGetUserMedia API. Für eine App, in der dieser Beispielcode verwendet wird, muss selbst die Manifestberechtigung 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: <ph type="x-smartling-placeholder"></ph>

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

  • Berechtigung

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

  • Anfrage

    Objekt

responsive

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

Wird ausgelöst, wenn der Renderingprozess des Gast-Webinhalts wieder responsiv ist, nachdem er nicht reagiert hat

Mit dem folgenden Beispielcode wird das webview-Element ein- oder 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: <ph type="x-smartling-placeholder"></ph>

  (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: <ph type="x-smartling-placeholder"></ph>

  (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 das Rendern der Webinhalte des Gasts nicht mehr reagiert Dieses Ereignis wird einmal mit einem passenden responsiven Termin generiert, wenn der Gast noch einmal antwortet.

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (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: <ph type="x-smartling-placeholder"></ph>

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

  • oldZoomFactor

    Zahl

  • newZoomFactor

    Zahl