chrome.webviewTag

Beschrijving

Gebruik de webview -tag om live content van het web via het netwerk te laden en in je Chrome-app in te sluiten. Je app kan het uiterlijk van de webview beheren en interactie hebben met de webcontent, navigatie in een ingesloten webpagina starten, reageren op foutmeldingen en meer (zie Gebruik ).

Toestemmingen

webview

Beschikbaarheid

alleen ChromeOS

Soorten

ClearDataOptions

Opties die bepalen welke gegevens door clearData moeten worden gewist.

Eigenschappen

  • sinds

    nummer optioneel

    Wis alle gegevens die op of na deze datum zijn verzameld, weergegeven in milliseconden sinds de epoch (toegankelijk via de getTime-methode van het JavaScript Date object). Indien niet aanwezig, wordt standaard 0 gebruikt (wat alle browsegegevens zou verwijderen).

ClearDataTypeSet

Een set gegevenstypen. Ontbrekende eigenschappen worden geïnterpreteerd als false .

Eigenschappen

  • appcache

    boolean optioneel

    Appcaches van websites.

  • cache

    boolean optioneel

    Chrome 44+

    Vanaf Chrome 43. De cache van de browser. Let op: bij het verwijderen van gegevens wordt de volledige cache gewist; dit is niet beperkt tot het door u opgegeven bereik.

  • cookies

    boolean optioneel

    De cookies van de partitie.

  • bestandssystemen

    boolean optioneel

    Bestandssystemen van websites.

  • indexedDB

    boolean optioneel

    IndexedDB-gegevens van websites.

  • lokale opslag

    boolean optioneel

    Lokale opslaggegevens van websites.

  • persistente cookies

    boolean optioneel

    Chrome 58+

    De permanente cookies van de partitie.

  • sessiecookies

    boolean optioneel

    Chrome 58+

    De sessiecookies van de partitie.

  • webSQL

    boolean optioneel

    WebSQL-gegevens van websites.

ContentScriptDetails

Chrome 44+

Details van het in te voegen inhoudsscript. Raadpleeg de documentatie over inhoudsscripts voor meer informatie.

Eigenschappen

  • alle frames

    boolean optioneel

    Als all_frames true is, betekent dit dat de JavaScript of CSS in alle frames van de huidige pagina moet worden geïnjecteerd. Standaard is all_frames false en wordt de JavaScript of CSS alleen in het bovenste frame geïnjecteerd.

  • css

    Injectieartikelen optioneel

    De CSS-code of een lijst met CSS-bestanden die in de bijbehorende pagina's moeten worden geïnjecteerd. Deze worden geïnjecteerd in de volgorde waarin ze verschijnen, voordat er DOM-elementen voor de pagina worden opgebouwd of weergegeven.

  • exclude_globs

    string[] optioneel

    Wordt toegepast na overeenkomsten om URL's uit te sluiten die overeenkomen met deze glob. Bedoeld om het @exclude Greasemonkey-trefwoord na te bootsen.

  • uitsluiten_overeenkomsten

    string[] optioneel

    Pagina's waar dit contentscript anders in zou worden geïnjecteerd, zijn uitgesloten.

  • include_globs

    string[] optioneel

    Wordt toegepast na overeenkomsten om alleen die URL's op te nemen die ook overeenkomen met deze glob. Bedoeld om het @include Greasemonkey-trefwoord na te bootsen.

  • js

    Injectieartikelen optioneel

    De JavaScript-code of een lijst met JavaScript-bestanden die in de bijbehorende pagina's moeten worden geïnjecteerd. Deze worden geïnjecteerd in de volgorde waarin ze verschijnen.

  • match_about_blank

    boolean optioneel

    Of het contentscript moet worden ingevoegd op about:blank en about:srcdoc. Contentscripts worden alleen ingevoegd op pagina's wanneer hun overervings-URL overeenkomt met een van de gedeclareerde patronen in het veld 'matches'. De overervings-URL is de URL van het document dat het frame of venster heeft gemaakt. Contentscripts kunnen niet worden ingevoegd in frames die in een sandbox worden uitgevoerd.

  • wedstrijden

    snaar[]

    Hiermee wordt gespecificeerd op welke pagina's dit contentscript zal worden ingevoegd.

  • naam

    snaar

    De naam van het inhoudsscript dat moet worden geïnjecteerd.

  • run_at

    RunAt optioneel

    Het vroegste moment waarop de JavaScript of CSS in het tabblad wordt geïnjecteerd. Standaard is dit "document_idle".

ContentWindow

Berichten versturen naar een gastvenster.

Eigenschappen

  • postMessage

    leegte

    Verzendt een bericht naar de ingesloten webinhoud zolang de ingesloten inhoud een pagina van de doelbron weergeeft. Deze methode is beschikbaar zodra de pagina volledig is geladen. Luister naar de contentload gebeurtenis en roep vervolgens de methode aan.

    De gast kan antwoorden naar de embedder sturen door een bericht te plaatsen in event.source bij de berichtgebeurtenis die hij ontvangt.

    Deze API is identiek aan de HTML5 postMessage API voor communicatie tussen webpagina's. De embedder kan naar antwoorden luisteren door een eventlistener voor message toe te voegen aan zijn eigen frame.

    De postMessage functie ziet er als volgt uit: 

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

    • bericht

      elk

      Berichtobject om naar de gast te sturen.

    • doelOorsprong

      snaar

      Specificeert wat de oorsprong van het gastvenster moet zijn om de gebeurtenis te kunnen verzenden.

ContextMenuCreateProperties

Chrome 44+

Eigenschappen

  • gecontroleerd

    boolean optioneel

    De beginstatus van een selectievakje of keuzerondje: waar als het geselecteerd is en onwaar als het niet geselecteerd is. Er kan slechts één keuzerondje tegelijk geselecteerd zijn binnen een groep keuzerondjes.

  • contexten

    [ ContextType , ... ContextType []] optioneel

    Lijst met contexten waarin dit menu-item verschijnt. Standaard is dit ['pagina'] als er niets is opgegeven.

  • documentUrlPatterns

    string[] optioneel

    Hiermee kunt u het item beperken tot documenten waarvan de URL overeenkomt met een van de opgegeven patronen. (Dit geldt ook voor frames.) Zie 'Patronen matchen' voor meer informatie over de indeling van een patroon.

  • ingeschakeld

    boolean optioneel

    Geeft aan of dit contextmenu-item is in- of uitgeschakeld. Standaard is dit true .

  • id

    string optioneel

    De unieke ID die aan dit item moet worden toegewezen. Verplicht voor evenementpagina's. Mag niet hetzelfde zijn als een andere ID voor deze extensie.

  • ouder-ID

    tekenreeks | getal optioneel

    De ID van een bovenliggend menu-item; hiermee wordt het item een ​​subitem van een eerder toegevoegd item.

  • doelURL-patronen

    string[] optioneel

    Vergelijkbaar met documentUrlPatterns, maar hiermee kunt u filteren op basis van het src attribuut van img/audio/video-tags en de href van anchor-tags.

  • titel

    string optioneel

    De tekst die in het item moet worden weergegeven; dit is verplicht , tenzij type 'separator' is. Wanneer de context 'selectie' is, kunt u %s in de tekenreeks gebruiken om de geselecteerde tekst weer te geven. Als de waarde van deze parameter bijvoorbeeld "Vertaal '%s' naar Pig Latin" is en de gebruiker het woord "cool" selecteert, is het contextmenu-item voor de selectie "Vertaal 'cool' naar Pig Latin".

  • type

    ItemType optioneel

    Het type menu-item. Standaard is dit 'normaal' als er niets is opgegeven.

  • onclick

    void optioneel

    Een functie die wordt aangeroepen wanneer op het menu-item wordt geklikt.

    De onclick functie ziet er als volgt uit: 

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

    • informatie

      OnClickData

      Informatie over het aangeklikte item en de context waarin de klik plaatsvond.

ContextMenus

Chrome 44+

Eigenschappen

  • onShow

    Event<functionvoidvoid>

    Deze gebeurtenis wordt geactiveerd voordat een contextmenu op deze webview wordt weergegeven. Je kunt dit contextmenu uitschakelen door event.preventDefault() aan te roepen.

    De functie onShow.addListener ziet er als volgt uit: 

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

    • terugbelverzoek

      functie

      De callback parameter ziet er als volgt uit: 

      (event: object) => void

      • evenement

        voorwerp

        • voorkomDefault

          leegte

          Roep deze functie aan om te voorkomen dat het contextmenu wordt weergegeven.

          De functie preventDefault ziet er als volgt uit: 

          () => {...}

  • creëren

    leegte

    Hiermee wordt een nieuw contextmenu-item aangemaakt. Houd er rekening mee dat als er een fout optreedt tijdens het aanmaken, u dit mogelijk pas te weten komt wanneer de aanmaakcallback wordt uitgevoerd (de details vindt u in runtime.lastError ).

    De create ziet er als volgt uit: 

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

    • eigenschappen maken

      voorwerp

      De eigenschappen die gebruikt zijn om het item te creëren.

    • terugbelverzoek

      functie optioneel

      De callback parameter ziet er als volgt uit: 

      () => void

    • retourneert

      tekenreeks | getal

      De ID van het nieuw aangemaakte item.

  • verwijderen

    leegte

    Verwijdert een item uit het contextmenu.

    De remove ziet er als volgt uit: 

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

    • menuItemId

      tekenreeks | getal

      De ID van het contextmenu-item dat u wilt verwijderen.

    • terugbelverzoek

      functie optioneel

      De callback parameter ziet er als volgt uit: 

      () => void

  • removeAll

    leegte

    Verwijdert alle contextmenu-items die aan deze webview zijn toegevoegd.

    De functie removeAll ziet er als volgt uit: 

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

    • terugbelverzoek

      functie optioneel

      De callback parameter ziet er als volgt uit: 

      () => void

  • update

    leegte

    Hiermee wordt een eerder aangemaakt contextmenu-item bijgewerkt.

    De update ziet er als volgt uit: 

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

    • id

      tekenreeks | getal

      De ID van het item dat moet worden bijgewerkt.

    • eigenschappen bijwerken

      voorwerp

      De eigenschappen die moeten worden bijgewerkt. Accepteert dezelfde waarden als de aanmaakfunctie.

    • terugbelverzoek

      functie optioneel

      De callback parameter ziet er als volgt uit: 

      () => void

ContextMenuUpdateProperties

Chrome 44+

Eigenschappen

  • gecontroleerd

    boolean optioneel

    De status van een selectievakje of keuzerondje: waar voor geselecteerd en onwaar voor niet geselecteerd. Er kan slechts één keuzerondje tegelijk geselecteerd zijn binnen een groep keuzerondjes.

  • contexten

    [ ContextType , ... ContextType []] optioneel

    Lijst met contexten waarin dit menu-item verschijnt.

  • documentUrlPatterns

    string[] optioneel

    Hiermee kunt u het item beperken tot documenten waarvan de URL overeenkomt met een van de opgegeven patronen. (Dit geldt ook voor frames.) Zie 'Patronen matchen' voor meer informatie over de indeling van een patroon.

  • ingeschakeld

    boolean optioneel

    Of dit contextmenu-item is in- of uitgeschakeld.

  • ouder-ID

    tekenreeks | getal optioneel

    De ID van een bovenliggend menu-item; hiermee wordt het item een ​​subitem van een eerder toegevoegd item. Let op: u kunt een item niet wijzigen zodat het een subitem wordt van een van zijn eigen subitems.

  • doelURL-patronen

    string[] optioneel

    Vergelijkbaar met documentUrlPatterns, maar hiermee kunt u filteren op basis van het src attribuut van img/audio/video-tags en de href van anchor-tags.

  • titel

    string optioneel

    De tekst die in het item moet worden weergegeven

  • type

    ItemType optioneel

    Het type menu-item.

  • onclick

    void optioneel

    Een functie die wordt aangeroepen wanneer op het menu-item wordt geklikt.

    De onclick functie ziet er als volgt uit: 

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

    • informatie

      OnClickData

      Informatie over het aangeklikte item en de context waarin de klik plaatsvond.

ContextType

Chrome 44+

De verschillende contexten waarin een menu kan verschijnen. Door 'alles' te selecteren, wordt de combinatie van alle andere contexten weergegeven.

Enum

"alle"

"pagina"

"kader"

"selectie"

"link"

"bewerkbaar"

"afbeelding"

"video"

"audio"

DialogController

Interface gekoppeld aan DOM-gebeurtenissen dialog .

Eigenschappen

  • annuleren

    leegte

    Het dialoogvenster weigeren. Dit is hetzelfde als op Annuleren klikken in een confirm of prompt .

    De cancel ziet er als volgt uit: 

    () => {...}

  • OK

    leegte

    Accepteer het dialoogvenster. Dit is gelijk aan klikken op OK in een alert , confirm of prompt .

    De ok functie ziet er als volgt uit: 

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

    • antwoord

      string optioneel

      De antwoordtekst die aan de gast wordt getoond wanneer deze een prompt accepteert.

DialogMessageType

Chrome 141+

Het type modaal dialoogvenster dat de gast heeft aangevraagd.

Enum

"waarschuwing"

"bevestigen"

"snel"

DownloadPermissionRequest

Het type request dat hoort bij een DOM-gebeurtenis permissionrequest download .

Eigenschappen

  • verzoekmethode

    snaar

    Het HTTP-verzoektype (bijv. GET ) dat is gekoppeld aan het downloadverzoek.

  • URL

    snaar

    De gevraagde download-URL.

  • toestaan

    leegte

    Sta het toestemmingsverzoek toe.

    De allow functie ziet er als volgt uit: 

    () => {...}

  • ontkennen

    leegte

    Weiger het toestemmingsverzoek. Dit is het standaardgedrag als allow niet is aangeroepen.

    De deny functie ziet er als volgt uit: 

    () => {...}

ExitReason

Chrome 141+

Een tekenreeks die de reden voor het verlaten aangeeft.

Enum

"normaal"

"abnormaal"

"neergestort"

"gedood"

"oom gedood"

"oom"

"Opstarten mislukt"

"integriteitsfout"

FileSystemPermissionRequest

Het type request dat hoort bij een DOM-gebeurtenis permissionrequest filesystem .

Eigenschappen

  • URL

    snaar

    De URL van het frame dat toegang tot het lokale bestandssysteem aanvraagt.

  • toestaan

    leegte

    Sta het toestemmingsverzoek toe.

    De allow functie ziet er als volgt uit: 

    () => {...}

  • ontkennen

    leegte

    Het verzoek om toestemming afwijzen.

    De deny functie ziet er als volgt uit: 

    () => {...}

FindCallbackResults

Bevat alle resultaten van de zoekopdracht.

Eigenschappen

  • activeMatchOrdinal

    nummer

    Het volgnummer van de huidige wedstrijd.

  • geannuleerd

    booleaans

    Geeft aan of dit zoekverzoek is geannuleerd.

  • aantal wedstrijden

    nummer

    Het aantal keren dat searchText op de pagina is gevonden.

  • selectieRect

    SelectieRecht

    Beschrijft een rechthoek rond de actieve wedstrijd in schermcoördinaten.

FindOptions

Opties voor de zoekopdracht.

Eigenschappen

  • achterwaarts

    boolean optioneel

    Vlag om overeenkomsten in omgekeerde volgorde te zoeken. De standaardwaarde is false .

  • matchCase

    boolean optioneel

    Vlag om te controleren op hoofdlettergevoeligheid. De standaardwaarde is false .

FullscreenPermissionRequest

Chrome 43+

Het type request dat hoort bij een DOM-gebeurtenis voor een permissionrequest fullscreen .

Eigenschappen

  • oorsprong

    snaar

    De oorsprong van het frame binnen de webview dat het verzoek voor volledig scherm heeft geïnitieerd.

  • toestaan

    leegte

    Sta het toestemmingsverzoek toe.

    De allow functie ziet er als volgt uit: 

    () => {...}

  • ontkennen

    leegte

    Het verzoek om toestemming afwijzen.

    De deny functie ziet er als volgt uit: 

    () => {...}

GeolocationPermissionRequest

Het type request dat hoort bij een DOM-gebeurtenis voor een permissionrequest geolocation .

Eigenschappen

  • URL

    snaar

    De URL van het frame dat toegang tot geolocatiegegevens aanvraagt.

  • toestaan

    leegte

    Sta het toestemmingsverzoek toe.

    De allow functie ziet er als volgt uit: 

    () => {...}

  • ontkennen

    leegte

    Weiger het toestemmingsverzoek. Dit is het standaardgedrag als allow niet is aangeroepen.

    De deny functie ziet er als volgt uit: 

    () => {...}

HidPermissionRequest

Chrome 125+

Het type request dat hoort bij een hid permissionrequest DOM-gebeurtenis.

Eigenschappen

  • URL

    snaar

    De URL van het frame dat toegang tot de HID API aanvraagt.

  • toestaan

    leegte

    Sta het toestemmingsverzoek toe.

    De allow functie ziet er als volgt uit: 

    () => {...}

  • ontkennen

    leegte

    Weiger het toestemmingsverzoek. Dit is het standaardgedrag als allow niet is aangeroepen.

    De deny functie ziet er als volgt uit: 

    () => {...}

InjectDetails

Details van het script of de CSS die moet worden geïnjecteerd. Ofwel de code, ofwel de bestandseigenschap moet worden ingesteld, maar niet beide tegelijk.

Eigenschappen

  • code

    string optioneel

    JavaScript- of CSS-code om in te voegen.

    Waarschuwing: Wees voorzichtig met het gebruik van de parameter code . Onjuist gebruik ervan kan uw app kwetsbaar maken voor cross-site scripting- aanvallen.

  • bestand

    string optioneel

    JavaScript- of CSS-bestand om te injecteren.

InjectionItems

Chrome 44+

Het type injectie-item: code of een set bestanden.

Eigenschappen

  • code

    string optioneel

    JavaScript-code of CSS die in de bijbehorende pagina's moet worden geïnjecteerd.

  • bestanden

    string[] optioneel

    De lijst met JavaScript- of CSS-bestanden die in de bijbehorende pagina's moeten worden geïnjecteerd. Deze worden geïnjecteerd in de volgorde waarin ze in deze lijst voorkomen.

LoadAbortReason

Chrome 141+

Een tekenreeks die aangeeft welk type afbreking heeft plaatsgevonden. Deze tekenreeks is niet gegarandeerd achterwaarts compatibel tussen releases. U mag de inhoud ervan niet interpreteren en er geen actie op ondernemen. Het is ook mogelijk dat in sommige gevallen een fout wordt gerapporteerd die hier niet wordt vermeld.

Enum

"FOUT AFGEBROKEN"

"FOUT_ONGELDIGE_URL"

"ERR_DISALLOWED_URL_SCHEME"

"FOUT_GEBLOKKEERD_DOOR_CLIENT"

"FOUTADRES ONBEREIKBAAR"

"ERR_EMPTY_RESPONSE"

"FOUTBESTAND NIET GEVONDEN"

"FOUT_ONBEKENDE_URL_SCHEMA"

LoadPluginPermissionRequest

Het type request dat hoort bij een loadplugin permissionrequest DOM-gebeurtenis.

Eigenschappen

  • identificator

    snaar

    De identificatiestring van de plugin.

  • naam

    snaar

    De weergavenaam van de plugin.

  • toestaan

    leegte

    Sta het toestemmingsverzoek toe. Dit is het standaardgedrag als deny niet wordt aangeroepen.

    De allow functie ziet er als volgt uit: 

    () => {...}

  • ontkennen

    leegte

    Het verzoek om toestemming afwijzen.

    De deny functie ziet er als volgt uit: 

    () => {...}

MediaPermissionRequest

Het type request dat hoort bij een media permissionrequest DOM-gebeurtenis.

Eigenschappen

  • URL

    snaar

    De URL van het frame dat toegang tot gebruikersmedia aanvraagt.

  • toestaan

    leegte

    Sta het toestemmingsverzoek toe.

    De allow functie ziet er als volgt uit: 

    () => {...}

  • ontkennen

    leegte

    Weiger het toestemmingsverzoek. Dit is het standaardgedrag als allow niet is aangeroepen.

    De deny functie ziet er als volgt uit: 

    () => {...}

NewWindow

Interface gekoppeld aan DOM-gebeurtenissen newwindow .

Eigenschappen

  • bijvoegen

    leegte

    Koppel de gewenste doelpagina aan een bestaand webview element.

    De attach -functie ziet er als volgt uit: 

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

    • webweergave

      voorwerp

      Het webview element waaraan de doelpagina moet worden gekoppeld.

  • weggooien

    leegte

    Annuleer het verzoek voor een nieuw venster.

    De discard functie ziet er als volgt uit: 

    () => {...}

PermissionType

Chrome 141+

Het type toestemming dat wordt aangevraagd.

Enum

"media"

"geolocatie"

"pointerLock"

"downloaden"

"plugin laden"

"bestandssysteem"

"volledig scherm"

"verborgen"

PointerLockPermissionRequest

Het type request dat hoort bij een pointerLock permissionrequest DOM-gebeurtenis.

Eigenschappen

  • lastUnlockedBySelf

    booleaans

    Ongeacht of het aanvragende frame de meest recente client was die een pointer lock had.

  • URL

    snaar

    De URL van het frame dat een pointer lock aanvraagt.

  • gebruikersgebaar

    booleaans

    Of er al dan niet een pointer lock is aangevraagd als gevolg van een gebruikersinvoer.

  • toestaan

    leegte

    Sta het toestemmingsverzoek toe.

    De allow functie ziet er als volgt uit: 

    () => {...}

  • ontkennen

    leegte

    Weiger het toestemmingsverzoek. Dit is het standaardgedrag als allow niet is aangeroepen.

    De deny functie ziet er als volgt uit: 

    () => {...}

SelectionRect

Beschrijft een rechthoek in schermcoördinaten.

De insluitingssemantiek is vergelijkbaar met die van een array; dat wil zeggen, de coördinaat (left, top) wordt geacht binnen de rechthoek te vallen, maar de coördinaat (left + width, top) niet.

Eigenschappen

  • hoogte

    nummer

    Hoogte van de rechthoek.

  • links

    nummer

    Afstand van de linkerrand van het scherm tot de linkerrand van de rechthoek.

  • bovenkant

    nummer

    Afstand van de bovenrand van het scherm tot de bovenrand van de rechthoek.

  • breedte

    nummer

    Breedte van de rechthoek.

StopFindingAction

Chrome 141+

Bepaalt wat er met de actieve overeenkomst moet gebeuren nadat de zoeksessie is beëindigd. clear verwijdert de markering van de actieve overeenkomst; keep houdt de actieve overeenkomst gemarkeerd; activate houdt de actieve overeenkomst gemarkeerd en simuleert een klik van de gebruiker op die overeenkomst. De standaardactie is keep .

Enum

"duidelijk"

"houden"

"activeren"

WebRequestEventInterface

Chrome 44+

Interface die toegang biedt tot webRequest-gebeurtenissen op de gastpagina. Zie de chrome.webRequest -extensie-API voor details over de levenscyclus van webRequest en gerelateerde concepten. Opmerking: De chrome.webRequest.onActionIgnored -gebeurtenis wordt niet ondersteund voor webviews.

Om te illustreren hoe het gebruik verschilt van de webRequest API van de extensie, bekijk het volgende voorbeeld van code die alle gastverzoeken blokkeert voor URL's die overeenkomen met *://www.evil.com/* : 

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

Daarnaast ondersteunt deze interface declaratieve webRequest-regels via onRequest en onMessage gebeurtenissen. Zie declarativeWebRequest voor API-details.

Houd er rekening mee dat voorwaarden en acties voor declaratieve webview webRequests moeten worden geïnstantieerd vanuit hun tegenhangers chrome.webViewRequest.* . De volgende voorbeeldcode blokkeert declaratief alle verzoeken aan "example.com" op de webview myWebview : 

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

WindowOpenDisposition

Chrome 141+

De gevraagde afhandeling van het nieuwe venster.

Enum

"negeren"

"opslaan_naar_schijf"

"huidig_tabblad"

"nieuwe_achtergrond_tab"

"nieuwe_voorgrond_tab"

"nieuw_venster"

"nieuwe_popup"

ZoomMode

Chrome 43+

Definieert hoe inzoomen in de webview wordt afgehandeld.

Enum

"per oorsprong"
Zoomwijzigingen blijven behouden in de oorspronkelijke pagina van de ingezoomde pagina, wat betekent dat alle andere webweergaven in dezelfde partitie die naar diezelfde oorspronkelijke pagina navigeren, ook worden ingezoomd. Bovendien worden zoomwijzigingen per-origin opgeslagen met de oorspronkelijke pagina, wat betekent dat wanneer u naar andere pagina's in dezelfde oorspronkelijke pagina navigeert, deze allemaal met dezelfde zoomfactor worden ingezoomd.

"per weergave"
Zoomwijzigingen zijn alleen van toepassing op deze webweergave en hebben geen invloed op de zoomfunctie van deze webweergave in andere webweergaven. Bovendien worden zoomwijzigingen per-view gereset bij navigatie; bij het navigeren binnen een webweergave worden pagina's altijd geladen met hun zoomfactor per oorsprong (binnen het bereik van de partitie).

"gehandicapt"
Schakelt alle zoommogelijkheden in de webweergave uit. De inhoud keert terug naar het standaard zoomniveau en alle pogingen tot zoomwijzigingen worden genegeerd.

Eigenschappen

contentWindow

Een objectreferentie die gebruikt kan worden om berichten op de gastpagina te plaatsen.

Type

Inhoudsvenster

contextMenus

Chrome 44+

Vergelijkbaar met de ContextMenus API van Chrome , maar van toepassing op webview in plaats van browsers. Gebruik de webview.contextMenus API om items toe te voegen aan het contextmenu van webview . Je kunt kiezen op welke typen objecten je contextmenu-toevoegingen van toepassing zijn, zoals afbeeldingen, hyperlinks en pagina's.

Type

Contextmenu's

request

Interface die toegang biedt tot webRequest-gebeurtenissen op de gastpagina.

Type

WebRequestEventInterface

Methoden

addContentScripts()

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

Voegt regels voor het injecteren van contentscripts toe aan de webview . Wanneer de webview naar een pagina navigeert die aan een of meer regels voldoet, worden de bijbehorende scripts geïnjecteerd. U kunt programmatisch regels toevoegen of bestaande regels bijwerken.

Het volgende voorbeeld voegt twee regels toe aan de webview : 'myRule' en 'anotherRule'. 

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

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

Je kunt de aanroep van addContentScripts uitstellen tot het moment dat je de scripts moet injecteren.

Het volgende voorbeeld laat zien hoe je een bestaande regel kunt overschrijven. 

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'}]);

Als webview naar de oorspronkelijke pagina (bijv. foo.com) is genavigeerd en webview.addContentScripts aanroept om 'myRule' toe te voegen, moet je wachten tot de volgende navigatie om de scripts te injecteren. Als je onmiddellijke injectie wilt, doet executeScript dat wel.

De regels blijven behouden, zelfs als het gastproces vastloopt of wordt beëindigd, of zelfs als de webview andere ouder krijgt toegewezen.

Raadpleeg de documentatie over content scripts voor meer informatie.

Parameters

back()

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

Gaat indien mogelijk één geschiedenisitem terug. Equivalent aan go(-1) .

Parameters

  • terugbelverzoek

    functie optioneel

    Chrome 44+

    De callback parameter ziet er als volgt uit: 

    (success: boolean) => void

    • succes

      booleaans

      Geeft aan of de navigatie succesvol was.

canGoBack()

chrome.webviewTag.canGoBack(): boolean

Geeft aan of het mogelijk is om terug te navigeren in de geschiedenis. De status van deze functie wordt in de cache opgeslagen en bijgewerkt vóór elke loadcommit , dus de beste plek om deze aan te roepen is bij loadcommit .

Retourneert

  • booleaans

canGoForward()

chrome.webviewTag.canGoForward(): boolean

Geeft aan of het mogelijk is om vooruit te navigeren in de geschiedenis. De status van deze functie wordt in de cache opgeslagen en bijgewerkt vóór elke loadcommit , dus de beste plek om deze aan te roepen is bij loadcommit .

Retourneert

  • booleaans

captureVisibleRegion()

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

Legt het zichtbare gedeelte van de webweergave vast.

Parameters

  • opties

    Afbeeldingsdetails optioneel

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (dataUrl: string) => void

    • dataUrl

      snaar

      Een data-URL die een afbeelding codeert van het zichtbare gedeelte van het vastgelegde tabblad. Kan worden toegewezen aan de 'src'-eigenschap van een HTML-afbeeldingselement voor weergave.

clearData()

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

Verwijdert browsegegevens voor de webview partitie.

Parameters

  • Opties om te bepalen welke gegevens gewist moeten worden.

  • De soorten gegevens die gewist moeten worden.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

executeScript()

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

Voegt JavaScript-code toe aan de gastpagina.

De volgende voorbeeldcode gebruikt scriptinjectie om de achtergrondkleur van de gastpagina op rood in te stellen: 

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

Parameters

  • details

    InjectDetails

    Details van het uit te voeren script.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result?: any[]) => void

    • resultaat

      elk[] optioneel

      Het resultaat van het script in elk ingevoegd frame.

find()

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

Start een zoekopdracht op de pagina.

Parameters

  • zoektekst

    snaar

    De tekenreeks die op de pagina moet worden gevonden.

  • opties

    FindOptions optioneel

    Opties voor de zoekopdracht.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (results?: FindCallbackResults) => void

    • resultaten

      FindCallbackResults (optioneel )

      Bevat alle resultaten van de zoekopdracht. results kunnen worden weggelaten als ze niet worden gebruikt in de callbackfunctie; bijvoorbeeld als de callback alleen wordt gebruikt om te bepalen wanneer de zoekopdracht is voltooid.

forward()

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

Gaat indien mogelijk één geschiedenisitem vooruit. Equivalent aan go(1) .

Parameters

  • terugbelverzoek

    functie optioneel

    Chrome 44+

    De callback parameter ziet er als volgt uit: 

    (success: boolean) => void

    • succes

      booleaans

      Geeft aan of de navigatie succesvol was.

getAudioState()

Chrome 62+
chrome.webviewTag.getAudioState(
  callback: function,
): void

Vraagt ​​de audiostatus op.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (audible: boolean) => void

    • hoorbaar

      booleaans

getProcessId()

chrome.webviewTag.getProcessId(): number

Retourneert de interne proces-ID van Chrome voor het huidige proces van de gastwebpagina, zodat ontwikkelaars weten hoeveel gasten erdoor beïnvloed zouden worden als het proces beëindigd wordt. Twee gasten delen een proces alleen als ze tot dezelfde app behoren en dezelfde opslagpartitie-ID hebben. De aanroep is synchroon en retourneert de in de cache opgeslagen informatie van de ontwikkelaars over de huidige proces-ID. De proces-ID is niet hetzelfde als de proces-ID van het besturingssysteem.

Retourneert

  • nummer

getUserAgent()

chrome.webviewTag.getUserAgent(): string

Retourneert de user agent-string die door de webview wordt gebruikt voor gastpaginaverzoeken.

Retourneert

  • snaar

getZoom()

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

Geeft de huidige zoomfactor weer.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (zoomFactor: number) => void

    • zoomFactor

      nummer

      De huidige zoomfactor.

getZoomMode()

Chrome 43+
chrome.webviewTag.getZoomMode(
  callback: function,
): void

Geeft de huidige zoommodus weer.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (ZoomMode: ZoomMode) => void

    • Zoommodus

      Zoommodus

      De huidige zoommodus van de webview .

go()

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

Hiermee wordt naar een item in de geschiedenis navigeerd met behulp van een geschiedenisindex die relatief is ten opzichte van de huidige navigatie. Als de gevraagde navigatie onmogelijk is, heeft deze methode geen effect.

Parameters

  • relatieveIndex

    nummer

    Relatieve geschiedenisindex waarnaar de webview moet navigeren. Een waarde van 2 navigeert bijvoorbeeld, indien mogelijk, 2 geschiedenisitems vooruit; een waarde van -3 navigeert 3 items achteruit.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (success: boolean) => void

    • succes

      booleaans

      Geeft aan of de navigatie succesvol was.

insertCSS()

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

Voegt CSS toe aan de gastpagina.

Parameters

  • details

    InjectDetails

    Details van de in te voegen CSS.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

isAudioMuted()

Chrome 62+
chrome.webviewTag.isAudioMuted(
  callback: function,
): void

Vraagt ​​of het geluid is gedempt.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (muted: boolean) => void

    • gedempt

      booleaans

isSpatialNavigationEnabled()

Chrome 71+
chrome.webviewTag.isSpatialNavigationEnabled(
  callback: function,
): void

Controleert of ruimtelijke navigatie is ingeschakeld voor de webweergave.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (enabled: boolean) => void

    • ingeschakeld

      booleaans

isUserAgentOverridden()

chrome.webviewTag.isUserAgentOverridden(): void

Geeft aan of de user agent-string van de webview al dan niet is overschreven door webviewTag.setUserAgentOverride .

loadDataWithBaseUrl()

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

Laadt een data-URL met een opgegeven basis-URL die wordt gebruikt voor relatieve links. Optioneel kan een virtuele URL worden opgegeven die aan de gebruiker wordt getoond in plaats van de data-URL.

Parameters

  • dataUrl

    snaar

    De URL voor de te laden gegevens.

  • basisUrl

    snaar

    De basis-URL die gebruikt zal worden voor relatieve links.

  • virtueleUrl

    string optioneel

    De URL die aan de gebruiker wordt getoond (in de adresbalk).

print()

chrome.webviewTag.print(): void

Hiermee wordt de inhoud van de webview afgedrukt. Dit is gelijk aan het aanroepen van een gescripte afdrukfunctie vanuit de webview zelf.

reload()

chrome.webviewTag.reload(): void

Vernieuwt de huidige hoofdpagina.

removeContentScripts()

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

Verwijdert inhoudsscripts uit een webview .

Het volgende voorbeeld verwijdert "myRule", dat eerder was toegevoegd. 

webview.removeContentScripts(['myRule']);

Je kunt alle regels verwijderen door te bellen naar: 

webview.removeContentScripts();

Parameters

  • scriptNameList

    string[] optioneel

    Een lijst met namen van contentscripts die verwijderd zullen worden. Als de lijst leeg is, worden alle contentscripts die aan de webview zijn toegevoegd, verwijderd.

setAudioMuted()

Chrome 62+
chrome.webviewTag.setAudioMuted(
  mute: boolean,
): void

Stelt de audio-dempingsstatus van de webweergave in.

Parameters

  • stom

    booleaans

    Geluidswaarde dempen

setSpatialNavigationEnabled()

Chrome 71+
chrome.webviewTag.setSpatialNavigationEnabled(
  enabled: boolean,
): void

Hiermee wordt de ruimtelijke navigatiestatus van de webweergave ingesteld.

Parameters

  • ingeschakeld

    booleaans

    Waarde van de ruimtelijke navigatiestatus.

setUserAgentOverride()

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

Overschrijf de user agent-string die door de webview wordt gebruikt voor gastpaginaverzoeken. Door deze overschrijving zullen de waarden in de User-Agent Client Hint-header en de waarden die worden geretourneerd door navigator.userAgentData leeg zijn voor gastpaginaverzoeken waarop deze overschrijving wordt toegepast.

Parameters

  • userAgent

    snaar

    De te gebruiken user agent-string.

setZoom()

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

Hiermee wordt de zoomfactor van de pagina aangepast. De reikwijdte en de persistentie van deze wijziging worden bepaald door de huidige zoommodus van de webview (zie webviewTag.ZoomMode ).

Parameters

  • zoomFactor

    nummer

    De nieuwe zoomfactor.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

setZoomMode()

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

Hiermee wordt de zoommodus van de webview ingesteld.

Parameters

  • Zoommodus

    Zoommodus

    Definieert hoe inzoomen in de webview wordt afgehandeld.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

stop()

chrome.webviewTag.stop(): void

Stopt het laden van de huidige webview -navigatie als deze bezig is.

stopFinding()

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

Beëindigt de huidige zoeksessie (waarbij alle markeringen worden verwijderd) en annuleert alle lopende zoekopdrachten.

Parameters

  • actie

    StopFindingAction (optioneel)

    Bepaalt wat er met de actieve overeenkomst moet gebeuren nadat de zoeksessie is beëindigd. clear verwijdert de markering van de actieve overeenkomst; keep houdt de actieve overeenkomst gemarkeerd; activate houdt de actieve overeenkomst gemarkeerd en simuleert een klik van de gebruiker op die overeenkomst. De standaardactie is keep .

terminate()

chrome.webviewTag.terminate(): void

Beëindigt geforceerd het renderproces van de gastwebpagina. Dit kan gevolgen hebben voor meerdere webview tags in de huidige app als ze hetzelfde proces delen, maar het heeft geen gevolgen voor webview tags in andere apps.

Evenementen

close

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

Wordt geactiveerd wanneer het gastenraam probeert te sluiten.

De volgende voorbeeldcode navigeert de webview naar about:blank wanneer de gast probeert de weergave te sluiten. 

webview.addEventListener('close', function() {
  webview.src = 'about:blank';
});

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    () => void

consolemessage

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

Wordt geactiveerd wanneer het gastvenster een bericht naar de console logt.

De volgende voorbeeldcode stuurt alle logberichten door naar de console van de embedder, ongeacht het logniveau of andere eigenschappen. 

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

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (level: number, message: string, line: number, sourceId: string) => void

    • niveau

      nummer

    • bericht

      snaar

    • lijn

      nummer

    • bron-ID

      snaar

contentload

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

Deze gebeurtenis wordt geactiveerd wanneer het gastvenster een load genereert, bijvoorbeeld wanneer een nieuw document wordt geladen. Dit geldt niet voor paginanavigatie binnen het huidige document of asynchrone laadprocessen van resources.

De volgende voorbeeldcode wijzigt de standaard lettergrootte van het body element van de gast nadat de pagina is geladen: 

webview.addEventListener('contentload', function() {
  webview.executeScript({ code: 'document.body.style.fontSize = "42px"' });
});

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    () => void

dialog

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

Deze gebeurtenis wordt geactiveerd wanneer het gastvenster probeert een modaal dialoogvenster te openen via window.alert , window.confirm of window.prompt .

Het afhandelen van deze gebeurtenis blokkeert het gastproces totdat elke gebeurtenislistener een resultaat retourneert of het dialog onbereikbaar wordt (als preventDefault() is aangeroepen).

De standaardinstelling is om het dialoogvenster te annuleren.

Parameters

exit

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

Wordt geactiveerd wanneer het proces dat de webinhoud van de gast rendert, is afgesloten.

De volgende voorbeeldcode toont een afscheidsbericht wanneer de gastpagina vastloopt: 

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

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (details: object) => void

    • details

      voorwerp

      • procesID

        nummer

        De interne ID van Chrome van het proces dat is afgesloten.

      • reden

        ExitReden

        Een tekenreeks die de reden voor het verlaten aangeeft.

findupdate

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

Deze functie wordt geactiveerd wanneer er nieuwe zoekresultaten beschikbaar zijn voor een actieve zoekopdracht. Dit kan meerdere keren gebeuren voor één zoekopdracht, naarmate er overeenkomsten worden gevonden.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

    • zoektekst

      snaar

    • aantal wedstrijden

      nummer

    • activeMatchOrdinal

      nummer

    • selectieRect

      SelectieRecht

    • geannuleerd

      booleaans

    • laatste update

      snaar

loadabort

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

Deze gebeurtenis wordt geactiveerd wanneer een laadbewerking op het hoogste niveau is afgebroken zonder te worden voltooid. Er wordt een foutmelding in de console weergegeven, tenzij de gebeurtenis standaard is voorkomen.

Opmerking: Wanneer het laden van een resource wordt afgebroken, zal een loadabort -gebeurtenis uiteindelijk worden gevolgd door een loadstop -gebeurtenis, zelfs als alle geplande laadprocessen sinds de laatste loadstop gebeurtenis (indien aanwezig) zijn afgebroken.

Opmerking: Als het laden van een 'about'-URL of een JavaScript-URL wordt afgebroken, wordt loadabort geactiveerd en wordt de webview doorgestuurd naar 'about:blank'.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

loadcommit

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

Wordt geactiveerd wanneer een laadbewerking is voltooid. Dit omvat navigatie binnen het huidige document en het laden van subframes op documentniveau, maar niet het asynchroon laden van resources.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

    • URL

      snaar

    • isTopLevel

      booleaans

loadredirect

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

Wordt geactiveerd wanneer een laadverzoek op het hoogste niveau is doorgestuurd naar een andere URL.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (oldUrl: string, newUrl: string, isTopLevel: boolean) => void

    • oudeUrl

      snaar

    • nieuweUrl

      snaar

    • isTopLevel

      booleaans

loadstart

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

Wordt afgevuurd zodra het laden begint.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

    • URL

      snaar

    • isTopLevel

      booleaans

loadstop

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

Deze gebeurtenis wordt geactiveerd wanneer alle laadprocessen op frameniveau in een gastpagina (inclusief alle subframes) zijn voltooid. Dit omvat navigatie binnen het huidige document en laadprocessen op documentniveau van subframes, maar niet het laden van asynchrone resources. Deze gebeurtenis wordt geactiveerd telkens wanneer het aantal laadprocessen op documentniveau overgaat van één (of meer) naar nul. Als bijvoorbeeld een pagina die al volledig is geladen (d.w.z. loadstop is al een keer geactiveerd) een nieuw iframe aanmaakt dat een pagina laadt, wordt een tweede loadstop geactiveerd wanneer het laden van de pagina in het iframe is voltooid. Dit patroon wordt vaak waargenomen op pagina's die advertenties laden.

Opmerking: Wanneer een geplande laadbewerking wordt afgebroken, volgt er uiteindelijk een loadstop gebeurtenis op een loadabort -gebeurtenis, zelfs als alle geplande laadbewerkingen sinds de laatste loadstop gebeurtenis (indien aanwezig) zijn afgebroken.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    () => void

newwindow

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

Deze functie wordt geactiveerd wanneer de gastpagina probeert een nieuw browservenster te openen.

De volgende voorbeeldcode maakt een nieuwe webview aan in de embedder voor elk aangevraagd nieuw venster en zorgt voor de juiste navigatie daartussen: 

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

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (window: NewWindow, targetUrl: string, initialWidth: number, initialHeight: number, name: string, windowOpenDisposition: WindowOpenDisposition) => void

permissionrequest

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

Wordt geactiveerd wanneer de gastpagina speciale toestemming van de embedder moet aanvragen.

De volgende voorbeeldcode geeft de gastpagina toegang tot de webkitGetUserMedia API. Houd er rekening mee dat een app die deze voorbeeldcode gebruikt, zelf de machtigingen audioCapture en/of videoCapture in het manifest moet specificeren: 

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

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (permission: PermissionType, request: object) => void

responsive

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

Deze functie wordt geactiveerd wanneer het proces dat de webinhoud van de gast weergeeft, na een periode van inactiviteit weer reageert.

De volgende voorbeeldcode laat het webview element geleidelijk verschijnen of verdwijnen, afhankelijk van of het element wel of niet reageert: 

webview.style.webkitTransition = 'opacity 250ms';
webview.addEventListener('unresponsive', function() {
  webview.style.opacity = '0.5';
});
webview.addEventListener('responsive', function() {
  webview.style.opacity = '1';
});

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (processID: number) => void

    • procesID

      nummer

sizechanged

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

Wordt geactiveerd wanneer de ingesloten webinhoud is aangepast via autosize . Wordt alleen geactiveerd als autosize is ingeschakeld.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void

    • oudeBreedte

      nummer

    • oudeHoogte

      nummer

    • nieuweBreedte

      nummer

    • nieuwe hoogte

      nummer

unresponsive

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

Deze gebeurtenis wordt geactiveerd wanneer het proces dat de webinhoud van de gast rendert, niet meer reageert. Deze gebeurtenis wordt eenmaal gegenereerd, samen met een overeenkomstige reactiegebeurtenis, zodra de gast weer reageert.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (processID: number) => void

    • procesID

      nummer

zoomchange

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

Wordt geactiveerd wanneer de zoomfactor van de pagina verandert.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

    • oude ZoomFactor

      nummer

    • nieuwe ZoomFactor

      nummer