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) => {...}

    • 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) => {...}

    • 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

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.

  • 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