Beschrijving
Gebruik de webview
-tag om live content van het web via het netwerk te laden en in te sluiten in uw Chrome-app. Uw app kan de weergave van de webview
bepalen en met de webcontent communiceren, navigatie in een ingesloten webpagina starten, reageren op fouten die zich daarin voordoen, en meer (zie Gebruik ).
Machtigingen
webview
Typen
ClearDataOptions
Opties die bepalen welke gegevens door clearData
moeten worden gewist.
Eigenschappen
- sinds
nummer optioneel
Gegevens wissen die op of na deze datum zijn verzameld, weergegeven in milliseconden sinds het tijdperk (toegankelijk via de getTime-methode van het JavaScript
Date
object). Indien afwezig, wordt de standaardwaarde0
(waarmee alle browsegegevens worden verwijderd).
ClearDataTypeSet
Een set gegevenstypen. Ontbrekende eigenschappen worden geïnterpreteerd als false
.
Eigenschappen
- appcache
boolean optioneel
Appcaches van websites.
- cache
boolean optioneel
Chroom 44+Sinds Chrome 43. De cache van de browser. Let op: wanneer u gegevens verwijdert, wordt de volledige cache gewist; dit is niet beperkt tot het door u opgegeven bereik.
- koekjes
boolean optioneel
De cookies van de partitie.
- bestandssystemen
boolean optioneel
Bestandssystemen van websites.
- geïndexeerdeDB
boolean optioneel
Geïndexeerde DB-gegevens van websites.
- lokale opslag
boolean optioneel
Lokale opslaggegevens van websites.
- persistenteCookies
boolean optioneel
Chroom 58+De permanente cookies van de partitie.
- sessieCookies
boolean optioneel
Chroom 58+De sessiecookies van de partitie.
- webSQL
boolean optioneel
WebSQL-gegevens van websites.
ContentScriptDetails
Details van het te injecteren contentscript. Raadpleeg de documentatie van de contentscripts 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 isall_frames
false
en wordt de JavaScript of CSS alleen in het bovenste frame geïnjecteerd. - css
InjectionItems optioneel
De CSS-code of een lijst met CSS-bestanden die in de overeenkomende pagina's moeten worden ingevoegd. Deze worden in de volgorde waarin ze verschijnen ingevoegd, voordat er een DOM voor de pagina wordt geconstrueerd of weergegeven.
- uitsluiten_globs
string[] optioneel
Toegepast na overeenkomsten om URL's uit te sluiten die overeenkomen met deze glob. Bedoeld om het Greasemonkey-trefwoord @exclude na te bootsen.
- uitsluit_overeenkomsten
string[] optioneel
Sluit pagina's uit waarin dit inhoudsscript anders zou worden geïnjecteerd.
- include_globs
string[] optioneel
Toegepast na overeenkomsten om alleen die URL's op te nemen die ook met deze glob overeenkomen. Bedoeld om het Greasemonkey-trefwoord @include na te bootsen.
- js
InjectionItems optioneel
De JavaScript-code of een lijst met JavaScript-bestanden die in de overeenkomende pagina's moeten worden ingevoegd. Deze worden in de volgorde waarin ze verschijnen, ingevoegd.
- match_about_blank
boolean optioneel
Of het inhoudsscript moet worden ingevoegd in about:blank en about:srcdoc. Inhoudsscripts worden alleen op pagina's ingevoegd wanneer hun overervende URL overeenkomt met een van de opgegeven patronen in het veld 'matches'. De overervende URL is de URL van het document dat het frame of venster heeft gemaakt. Inhoudsscripts kunnen niet worden ingevoegd in sandboxframes.
- wedstrijden
snaar[]
Geeft aan in welke pagina's dit inhoudsscript wordt ingevoegd.
- naam
snaar
De naam van het inhoudsscript dat moet worden geïnjecteerd.
- run_at
RunAt optioneel
Het moment waarop JavaScript of CSS in het tabblad wordt ingevoegd. Standaard is dit "document_idle".
ContentWindow
Berichten-ingang naar een gastvenster.
Eigenschappen
- berichtbericht
leegte
Plaatst een bericht in de ingesloten webcontent zolang de ingesloten content een pagina van de doelbron weergeeft. Deze methode is beschikbaar zodra de pagina is geladen. Luister naar de
contentload
-gebeurtenis en roep vervolgens de methode aan.De gast kan antwoorden sturen naar de embedder door een bericht te plaatsen op
event.source
bij de message-gebeurtenis die hij ontvangt.Deze API is identiek aan de HTML5 postMessage API voor communicatie tussen webpagina's. De embedder kan naar reacties luisteren door een
message
aan zijn eigen frame toe te voegen.De
postMessage
-functie ziet er als volgt uit:(message: any, targetOrigin: string) => {...}
- bericht
elk
Berichtobject om naar de gast te verzenden.
- doelOrigin
snaar
Geeft aan wat de oorsprong van het gastvenster moet zijn om de gebeurtenis te kunnen verzenden.
ContextMenuCreateProperties
Eigenschappen
- gecontroleerd
boolean optioneel
De beginstatus van een selectievakje of keuzerondje: true voor geselecteerd en false voor niet-geselecteerd. Er kan slechts één keuzerondje tegelijk worden geselecteerd in een bepaalde groep keuzerondjes.
- contexten
[ ContextType , ... ContextType []] optioneel
Lijst met contexten waarin dit menu-item zal verschijnen. Standaard is dit ['pagina'] als dit niet is opgegeven.
- documentUrlPatronen
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 opmaak van een patroon.
- ingeschakeld
boolean optioneel
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 gebeurtenispagina's. Kan niet hetzelfde zijn als een andere ID voor deze extensie.
- ouder-ID
string | nummer optioneel
De ID van een bovenliggend menu-item. Hiermee wordt het item een 'kind' van een eerder toegevoegd item.
- targetUrlPatterns
string[] optioneel
Vergelijkbaar met documentUrlPatterns, maar hiermee kunt u filteren op basis van het
src
-kenmerk van img/audio/video-tags en dehref
van ankertags. - titel
string optioneel
De tekst die in het item moet worden weergegeven; dit is vereist , tenzij
type
'separator' is. Wanneer de context 'selection' is, kunt u%s
binnen de tekenreeks gebruiken om de geselecteerde tekst weer te geven. Als de waarde van deze parameter bijvoorbeeld 'Vertalen van '%s' naar Pig Latin' is en de gebruiker het woord 'cool' selecteert, is het contextmenu-item voor de selectie 'Vertalen van 'cool' naar Pig Latin'. - type
ItemType optioneel
Het type menu-item. Standaard is dit 'normaal' indien niet gespecificeerd.
- onclick
leeg optioneel
Een functie die wordt aangeroepen wanneer er op het menu-item wordt geklikt.
De
onclick
-functie ziet er als volgt uit:(info: OnClickData) => {...}
- informatie
Informatie over het item waarop is geklikt en de context waarin is geklikt.
ContextMenus
Eigenschappen
- opShow
Gebeurtenis<functievoidvoid>
Wordt geactiveerd voordat er een contextmenu in deze
webview
wordt weergegeven. Kan worden gebruikt om dit contextmenu uit te schakelen doorevent.preventDefault()
aan te roepen.De functie
onShow.addListener
ziet er als volgt uit:(callback: function) => {...}
- terugbellen
functie
De
callback
ziet er als volgt uit:(event: object) => void
- evenement
voorwerp
- voorkomenStandaard
leegte
Gebruik deze optie om te voorkomen dat het contextmenu wordt weergegeven.
De functie
preventDefault
ziet er als volgt uit:() => {...}
- creëren
leegte
Maakt een nieuw contextmenu-item aan. Houd er rekening mee dat als er tijdens het aanmaken een fout optreedt, u dit mogelijk pas ontdekt wanneer de callback voor het aanmaken wordt geactiveerd (de details staan in
runtime.lastError
).De
create
functie ziet er als volgt uit:(createProperties: object, callback?: function) => {...}
- createProperties
voorwerp
De eigenschappen die gebruikt zijn om het item te maken
- terugbellen
functie optioneel
De
callback
ziet er als volgt uit:() => void
- retouren
tekenreeks | getal
De ID van het nieuw aangemaakte item.
- verwijderen
leegte
Verwijdert een contextmenu-item.
De
remove
ziet er als volgt uit:(menuItemId: string | number, callback?: function) => {...}
tekenreeks | getal
De ID van het contextmenu-item dat u wilt verwijderen.
- terugbellen
functie optioneel
De
callback
ziet er als volgt uit:() => void
- verwijderAlles
leegte
Verwijdert alle contextmenu-items die aan deze
webview
zijn toegevoegd.De functie
removeAll
ziet er als volgt uit:(callback?: function) => {...}
- terugbellen
functie optioneel
De
callback
ziet er als volgt uit:() => void
- update
leegte
Werkt een eerder gemaakt contextmenu-item bij.
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.
- updateProperties
voorwerp
De bij te werken eigenschappen. Accepteert dezelfde waarden als de create-functie.
- terugbellen
functie optioneel
De
callback
ziet er als volgt uit:() => void
ContextMenuUpdateProperties
Eigenschappen
- gecontroleerd
boolean optioneel
De status van een selectievakje of keuzerondje: true voor geselecteerd en false voor niet-geselecteerd. Er kan slechts één keuzerondje tegelijk worden geselecteerd in een bepaalde groep keuzerondjes.
- contexten
[ ContextType , ... ContextType []] optioneel
Lijst met contexten waarin dit menu-item zal verschijnen.
- documentUrlPatronen
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 opmaak van een patroon.
- ingeschakeld
boolean optioneel
Of dit contextmenu-item is ingeschakeld of uitgeschakeld.
- ouder-ID
string | nummer optioneel
De ID van een bovenliggend menu-item; dit maakt het item een onderliggend item van een eerder toegevoegd item. Let op: U kunt een item niet wijzigen naar een onderliggend item van een van zijn eigen afstammelingen.
- targetUrlPatterns
string[] optioneel
Vergelijkbaar met documentUrlPatterns, maar hiermee kunt u filteren op basis van het
src
-kenmerk van img/audio/video-tags en dehref
van ankertags. - titel
string optioneel
De tekst die in het item moet worden weergegeven
- type
ItemType optioneel
Het type menu-item.
- onclick
leeg optioneel
Een functie die wordt aangeroepen wanneer er op het menu-item wordt geklikt.
De
onclick
-functie ziet er als volgt uit:(info: OnClickData) => {...}
- informatie
Informatie over het item waarop is geklikt en de context waarin is geklikt.
ContextType
De verschillende contexten waarin een menu kan verschijnen. Het specificeren van 'alle' is gelijkwaardig aan de combinatie van alle andere contexten.
Enum
"alle" "pagina" "kader" "selectie" "link" "bewerkbaar" "afbeelding" "video" "audio"
DialogController
Interface gekoppeld aan dialog
DOM-gebeurtenissen.
Eigenschappen
- annuleren
leegte
Het dialoogvenster afwijzen. Dit is vergelijkbaar met het klikken op Annuleren in een
confirm
ofprompt
.De
cancel
ziet er als volgt uit:() => {...}
- OK
leegte
Accepteer de dialoog. Dit komt overeen met het klikken op OK in een
alert
,confirm
ofprompt
.De
ok
-functie ziet er als volgt uit:(response?: string) => {...}
- antwoord
string optioneel
De antwoordreeks die aan de gast moet worden verstrekt wanneer een
prompt
wordt geaccepteerd.
DialogMessageType
Het type modale dialoog dat door de gast is aangevraagd.
Enum
"alert" "bevestigen" "snel"
DownloadPermissionRequest
Het type request
dat gepaard gaat met een download
permissionrequest
DOM-gebeurtenis.
Eigenschappen
- aanvraagmethode
snaar
Het HTTP-aanvraagtype (bijv.
GET
) dat aan de downloadaanvraag is gekoppeld. - 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 wordt aangeroepen.De
deny
ziet er als volgt uit:() => {...}
ExitReason
String die de reden voor het afsluiten aangeeft.
Enum
"normaal" "abnormaal" "crashte" "vermoord" "oom vermoord" "oom" "kan niet worden gestart" "integriteitsfalen"
FileSystemPermissionRequest
Het type request
dat gepaard gaat met 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
Wijs het verzoek om toestemming af.
De
deny
ziet er als volgt uit:() => {...}
FindCallbackResults
Bevat alle resultaten van de zoekopdracht.
Eigenschappen
- actieveMatchOrdinal
nummer
Het rangtelwoord van de huidige wedstrijd.
- geannuleerd
Booleaanse
Geeft aan of deze zoekopdracht is geannuleerd.
- aantal wedstrijden
nummer
Het aantal keren
searchText
op de pagina is gevonden. - selectieRect
Beschrijft een rechthoek rond de actieve match in schermcoördinaten.
FindOptions
Opties voor de zoekopdracht.
Eigenschappen
- achteruit
boolean optioneel
Vlag om overeenkomsten in omgekeerde volgorde te vinden. De standaardwaarde is
false
. - matchCase
boolean optioneel
Vlag om te matchen met hoofdlettergevoeligheid. De standaardwaarde is
false
.
FullscreenPermissionRequest
Het type request
dat gepaard gaat met een DOM-gebeurtenis permissionrequest
fullscreen
.
Eigenschappen
- oorsprong
snaar
De oorsprong van het frame in de
webview
dat de aanvraag voor volledig scherm heeft geïnitieerd. - toestaan
leegte
Sta het toestemmingsverzoek toe.
De
allow
functie ziet er als volgt uit:() => {...}
- ontkennen
leegte
Wijs het verzoek om toestemming af.
De
deny
ziet er als volgt uit:() => {...}
GeolocationPermissionRequest
Het type request
dat permissionrequest
geolocation
-gebeurtenis hoort.
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 wordt aangeroepen.De
deny
ziet er als volgt uit:() => {...}
HidPermissionRequest
Het type request
dat bij een hid
permissionrequest
DOM-gebeurtenis hoort.
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 wordt aangeroepen.De
deny
ziet er als volgt uit:() => {...}
InjectDetails
Details van het script of de CSS die moet worden ingevoegd. Ofwel de code ofwel de bestandseigenschap moet worden ingesteld, maar beide kunnen niet tegelijkertijd worden ingesteld.
Eigenschappen
- code
string optioneel
Te injecteren JavaScript- of CSS-code.
Waarschuwing: Wees voorzichtig met het gebruik van de
code
. Onjuist gebruik ervan kan uw app kwetsbaar maken voor cross-site scripting- aanvallen. - bestand
string optioneel
Te injecteren JavaScript- of CSS-bestand.
InjectionItems
Het type injectie-item: code of een set bestanden.
Eigenschappen
- code
string optioneel
JavaScript-code of CSS die in overeenkomende pagina's moet worden geïnjecteerd.
- bestanden
string[] optioneel
De lijst met JavaScript- of CSS-bestanden die in overeenkomende pagina's moeten worden ingevoegd. Deze worden ingevoegd in de volgorde waarin ze in deze matrix voorkomen.
LoadAbortReason
String die aangeeft welk type abortus er heeft plaatsgevonden. Er is geen garantie dat deze string achterwaarts compatibel blijft tussen releases. U mag de inhoud ervan niet parseren 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_GEBROKEN" "ERR_ONGELDIGE_URL" "ERR_NIET TOEGESTAAN_URL_SCHEMA" "FOUT_GEBLOKKEERD_DOOR_CLIENT" "ERR_ADRES_ONBEREIKBAAR" "ERR_LEGE_REACTIE" "ERR_BESTAND_NIET_GEVONDEN" "ERR_ONBEKENDE_URL_SCHEMA"
LoadPluginPermissionRequest
Het type request
dat bij een loadplugin
permissionrequest
DOM-gebeurtenis hoort.
Eigenschappen
- identificatie
snaar
De identificatiereeks van de plug-in.
- naam
snaar
De weergavenaam van de plug-in.
- 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
Wijs het verzoek om toestemming af.
De
deny
ziet er als volgt uit:() => {...}
MediaPermissionRequest
Het type request
dat bij een media
permissionrequest
DOM-gebeurtenis hoort.
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 wordt aangeroepen.De
deny
ziet er als volgt uit:() => {...}
NewWindow
Interface gekoppeld aan newwindow
DOM-venstergebeurtenissen.
Eigenschappen
- bijvoegen
leegte
Koppel de gevraagde doelpagina aan een bestaand
webview
element.De
attach
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
ziet er als volgt uit:() => {...}
PermissionType
Het type toestemming dat wordt gevraagd.
Enum
"media" "geolocatie" "pointerLock" "downloaden" "laadplugin" "bestandssysteem" "volledig scherm" "verborgen"
PointerLockPermissionRequest
Het type request
dat bij een pointerLock
permissionrequest
DOM-gebeurtenis hoort.
Eigenschappen
- laatstOntgrendeldDoorZelf
Booleaanse
Of het opvragende frame de meest recente client was die de pointerlock vasthield.
- url
snaar
De URL van het frame dat pointervergrendeling aanvraagt.
- gebruikersgebaar
Booleaanse
Of de aanwijzervergrendeling wel of niet is aangevraagd als resultaat van een invoergebaar van de gebruiker.
- 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 wordt aangeroepen.De
deny
ziet er als volgt uit:() => {...}
SelectionRect
Beschrijft een rechthoek in schermcoördinaten.
De containment-semantiek is vergelijkbaar met die van een array. Dat wil zeggen dat de coördinaat (left, top)
wordt beschouwd als omvat door de rechthoek, 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
Bepaalt wat er met de actieve match moet gebeuren nadat de zoekactie is beëindigd. clear
verwijdert de markering van de actieve match; keep
houdt de actieve match gemarkeerd; activate
houdt de actieve match gemarkeerd en simuleert een klik van de gebruiker op die match. De standaardactie is keep
.
Enum
"duidelijk" "houden" "activeren"
WebRequestEventInterface
Interface die toegang biedt tot webRequest-gebeurtenissen op de gastpagina. Zie de chrome.webRequest -extensie-API voor meer informatie over de levenscyclus van webRequest en gerelateerde concepten. Opmerking: de chrome.webRequest.onActionIgnored -gebeurtenis wordt niet ondersteund voor webweergaven.
Om te illustreren hoe het gebruik verschilt van de webRequest API-extensies, kunt u de volgende voorbeeldcode bekijken. Deze code blokkeert alle gastaanvragen voor URL's die overeenkomen met *://www.evil.com/*
:
webview.request.onBeforeRequest.addListener(
function(details) { return {cancel: true}; },
{urls: ["*://www.evil.com/*"]},
["blocking"]);
Bovendien 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 geïnstantieerd moeten worden vanuit hun chrome.webViewRequest.*
tegenhangers. De volgende voorbeeldcode blokkeert declaratief alle verzoeken naar "example.com"
in 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
De gevraagde plaatsing van het nieuwe venster.
Enum
"negeren" "opslaan_op_schijf" "huidige_tab" "nieuwe_achtergrondtab" "nieuwe_voorgrond_tab" "nieuw_venster" "nieuwe_popup"
ZoomMode
Definieert hoe zoomen wordt afgehandeld in de webview
.
Enum
"per oorsprong" "per weergave" "gehandicapt"
Zoomwijzigingen blijven behouden in de oorsprong van de ingezoomde pagina, d.w.z. alle andere webviews in dezelfde partitie die naar dezelfde oorsprong navigeren, worden ook ingezoomd. Bovendien worden zoomwijzigingen per-origin
opgeslagen bij de oorsprong, wat betekent dat bij het navigeren naar andere pagina's in dezelfde oorsprong, deze allemaal met dezelfde zoomfactor worden ingezoomd.
Zoomwijzigingen zijn alleen van toepassing in deze webweergave. Zoomwijzigingen in andere webweergaven hebben geen invloed op de zoomfactor van deze webweergave. Bovendien worden zoomwijzigingen per-view
gereset bij navigatie; bij het navigeren in een webweergave worden pagina's altijd geladen met hun zoomfactor per oorsprong (binnen de reikwijdte van de partitie).
Schakelt alle zoomen in de webweergave uit. De inhoud keert terug naar het standaard zoomniveau en alle pogingen tot zoomwijzigingen worden genegeerd.
Eigenschappen
contentWindow
Objectreferentie die gebruikt kan worden om berichten op de gastpagina te plaatsen.
Type
contextMenus
Vergelijkbaar met de ContextMenus API van Chrome , maar is van toepassing op webview
in plaats van de browser. Gebruik de webview.contextMenus
API om items toe te voegen aan het contextmenu van de webview
. U kunt kiezen op welke typen objecten uw contextmenu-toevoegingen van toepassing zijn, zoals afbeeldingen, hyperlinks en pagina's.
Type
request
Interface die toegang biedt tot webRequest-gebeurtenissen op de gastpagina.
Methoden
addContentScripts()
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';
U kunt de addContentScripts-aanroep uitstellen totdat u scripts moet injecteren.
Het volgende voorbeeld laat zien hoe u een bestaande regel overschrijft.
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 oorsprong (bijv. foo.com) is genavigeerd en webview.addContentScripts
aanroept om 'myRule' toe te voegen, moet u wachten op de volgende navigatie om de scripts te injecteren. Als u direct wilt injecteren, zal executeScript
de juiste oplossing bieden.
Regels blijven behouden, zelfs als het gastproces crasht of wordt beëindigd, of zelfs als de webview
opnieuw wordt gekoppeld.
Raadpleeg de documentatie over de inhoudsscripts voor meer informatie.
Parameters
- contentScriptList
[ ContentScriptDetails , ... ContentScriptDetails []]
Details van de toe te voegen inhoudsscripts.
back()
chrome.webviewTag.back(
callback?: function,
): void
Navigeer indien mogelijk één item terug in de geschiedenis. Gelijk aan go(-1)
.
Parameters
- terugbellen
functie optioneel
Chroom 44+De
callback
ziet er als volgt uit:(success: boolean) => void
- succes
Booleaanse
Geeft aan of de navigatie succesvol was.
canGoBack()
chrome.webviewTag.canGoBack(): boolean
Geeft aan of het mogelijk is om terug te navigeren door de geschiedenis. De status van deze functie wordt gecached en bijgewerkt vóór elke loadcommit
, dus de beste plaats om deze aan te roepen is op loadcommit
.
Retourneren
Booleaanse
canGoForward()
chrome.webviewTag.canGoForward(): boolean
Geeft aan of het mogelijk is om vooruit door de geschiedenis te navigeren. De status van deze functie wordt gecached en bijgewerkt vóór elke loadcommit
, dus de beste plaats om deze aan te roepen is op loadcommit
.
Retourneren
Booleaanse
captureVisibleRegion()
chrome.webviewTag.captureVisibleRegion(
options?: ImageDetails,
callback: function,
): void
Legt het zichtbare gedeelte van de webweergave vast.
Parameters
- opties
ImageDetails optioneel
- terugbellen
functie
De
callback
ziet er als volgt uit:(dataUrl: string) => void
- dataUrl
snaar
Een data-URL die een afbeelding van het zichtbare gebied van het vastgelegde tabblad codeert. Kan worden toegewezen aan de 'src'-eigenschap van een HTML-afbeeldingselement voor weergave.
clearData()
chrome.webviewTag.clearData(
options: ClearDataOptions,
types: ClearDataTypeSet,
callback?: function,
): void
Wist de browsegegevens voor de webview
.
Parameters
- opties
Opties die bepalen welke gegevens u wilt wissen.
- typen
De soorten gegevens die moeten worden gewist.
- terugbellen
functie optioneel
De
callback
ziet er als volgt uit:() => void
executeScript()
chrome.webviewTag.executeScript(
details: InjectDetails,
callback?: function,
): void
Injecteert JavaScript-code in de gastpagina.
De volgende voorbeeldcode maakt gebruik van scriptinjectie om de achtergrondkleur van de gastpagina op rood in te stellen:
webview.executeScript({ code: "document.body.style.backgroundColor = 'red'" });
Parameters
- details
Details van het uit te voeren script.
- terugbellen
functie optioneel
De
callback
ziet er als volgt uit:(result?: any[]) => void
- resultaat
any[] optioneel
Het resultaat van het script in elk geïnjecteerd frame.
find()
chrome.webviewTag.find(
searchText: string,
options?: FindOptions,
callback?: function,
): void
Start een zoek-op-pagina-aanvraag.
Parameters
- zoektekst
snaar
De tekenreeks die op de pagina gevonden moet worden.
- opties
FindOptions optioneel
Opties voor de zoekopdracht.
- terugbellen
functie optioneel
De
callback
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 hoofdtekst van de callback-functie, bijvoorbeeld als de callback alleen wordt gebruikt om vast te stellen of de zoekopdracht is voltooid.
forward()
chrome.webviewTag.forward(
callback?: function,
): void
Navigeer indien mogelijk één geschiedenisitem vooruit. Gelijk aan go(1)
.
Parameters
- terugbellen
functie optioneel
Chroom 44+De
callback
ziet er als volgt uit:(success: boolean) => void
- succes
Booleaanse
Geeft aan of de navigatie succesvol was.
getAudioState()
chrome.webviewTag.getAudioState(
callback: function,
): void
Vraagt audiostatus op.
Parameters
- terugbellen
functie
De
callback
ziet er als volgt uit:(audible: boolean) => void
- hoorbaar
Booleaanse
getProcessId()
chrome.webviewTag.getProcessId(): number
Retourneert de interne proces-ID van Chrome voor het huidige proces van de gastwebpagina, zodat embedders weten hoeveel gasten er last van hebben als het proces wordt beëindigd. Twee gasten delen een proces alleen als ze tot dezelfde app behoren en dezelfde opslagpartitie-ID hebben. De aanroep is synchroon en retourneert de gecachte notie van de huidige proces-ID van de embedder. De proces-ID is niet hetzelfde als de proces-ID van het besturingssysteem.
Retourneren
nummer
getUserAgent()
chrome.webviewTag.getUserAgent(): string
Geeft de useragent-string terug die door de webview
wordt gebruikt voor gastpagina-aanvragen.
Retourneren
snaar
getZoom()
chrome.webviewTag.getZoom(
callback: function,
): void
Geeft de huidige zoomfactor weer.
Parameters
- terugbellen
functie
De
callback
ziet er als volgt uit:(zoomFactor: number) => void
- zoomFactor
nummer
De huidige zoomfactor.
getZoomMode()
chrome.webviewTag.getZoomMode(
callback: function,
): void
Haalt de huidige zoommodus op.
Parameters
- terugbellen
functie
De
callback
ziet er als volgt uit:(ZoomMode: ZoomMode) => void
- Zoommodus
De huidige zoommodus van de
webview
.
go()
chrome.webviewTag.go(
relativeIndex: number,
callback?: function,
): void
Navigeer naar een geschiedenisitem met behulp van een geschiedenisindex die relatief is aan de huidige navigatie. Als de gevraagde navigatie niet mogelijk is, heeft deze methode geen effect.
Parameters
- relatieveIndex
nummer
Relatieve geschiedenisindex waarnaar de
webview
moet navigeren. Een waarde van2
navigeert bijvoorbeeld 2 geschiedenisitems vooruit indien mogelijk; een waarde van-3
navigeert 3 items terug. - terugbellen
functie optioneel
De
callback
ziet er als volgt uit:(success: boolean) => void
- succes
Booleaanse
Geeft aan of de navigatie succesvol was.
insertCSS()
chrome.webviewTag.insertCSS(
details: InjectDetails,
callback?: function,
): void
Injecteert CSS in de gastpagina.
Parameters
- details
Details van de in te voegen CSS.
- terugbellen
functie optioneel
De
callback
ziet er als volgt uit:() => void
isAudioMuted()
chrome.webviewTag.isAudioMuted(
callback: function,
): void
Vraagt of het geluid gedempt is.
Parameters
- terugbellen
functie
De
callback
ziet er als volgt uit:(muted: boolean) => void
- gedempt
Booleaanse
isSpatialNavigationEnabled()
chrome.webviewTag.isSpatialNavigationEnabled(
callback: function,
): void
Vraagt of ruimtelijke navigatie is ingeschakeld voor de webweergave.
Parameters
functie
De
callback
ziet er als volgt uit:(enabled: boolean) => void
Booleaanse
isUserAgentOverridden()
chrome.webviewTag.isUserAgentOverridden(): void
Geeft aan of de gebruikersagenttekenreeks van de webview
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 te laden gegevens-URL.
- basisUrl
snaar
De basis-URL die wordt gebruikt voor relatieve links.
- virtueleUrl
string optioneel
De URL die aan de gebruiker wordt weergegeven (in de adresbalk).
print()
chrome.webviewTag.print(): void
Drukt de inhoud van de webview
af. Dit is gelijk aan het aanroepen van een gescripte afdrukfunctie vanuit de webview
zelf.
reload()
chrome.webviewTag.reload(): void
Laadt de huidige hoofdpagina opnieuw.
removeContentScripts()
chrome.webviewTag.removeContentScripts(
scriptNameList?: string[],
): void
Verwijdert inhoudsscripts uit een webview
.
In het volgende voorbeeld wordt "myRule" verwijderd, dat eerder is toegevoegd.
webview.removeContentScripts(['myRule']);
U kunt alle regels verwijderen door het volgende aan te roepen:
webview.removeContentScripts();
Parameters
- scriptNaamLijst
string[] optioneel
Een lijst met namen van contentscripts die worden verwijderd. Als de lijst leeg is, worden alle contentscripts die aan de
webview
zijn toegevoegd, verwijderd.
setAudioMuted()
chrome.webviewTag.setAudioMuted(
mute: boolean,
): void
Hiermee stelt u de status voor het dempen van het geluid van de webweergave in.
Parameters
- stom
Booleaanse
Dempen audiowaarde
setSpatialNavigationEnabled()
chrome.webviewTag.setSpatialNavigationEnabled(
enabled: boolean,
): void
Stelt de ruimtelijke navigatiestatus van de webweergave in.
Parameters
Booleaanse
Waarde van de ruimtelijke navigatiestatus.
setUserAgentOverride()
chrome.webviewTag.setUserAgentOverride(
userAgent: string,
): void
Overschrijf de user-agentstring die door de webview
wordt gebruikt voor gastpaginaverzoeken. Overschrijven zorgt ervoor dat de waarden in de header van de User-Agent Client Hint en de waarden die door navigator.userAgentData
worden geretourneerd, leeg zijn voor gastpaginaverzoeken waarop deze overschrijving wordt toegepast.
Parameters
- gebruikersagent
snaar
De te gebruiken useragentstring.
setZoom()
chrome.webviewTag.setZoom(
zoomFactor: number,
callback?: function,
): void
Wijzigt de zoomfactor van de pagina. De reikwijdte en persistentie van deze wijziging worden bepaald door de huidige zoommodus van de webview (zie webviewTag.ZoomMode
).
Parameters
- zoomFactor
nummer
De nieuwe zoomfactor.
- terugbellen
functie optioneel
De
callback
ziet er als volgt uit:() => void
setZoomMode()
chrome.webviewTag.setZoomMode(
ZoomMode: ZoomMode,
callback?: function,
): void
Stelt de zoommodus van de webview
in.
Parameters
- Zoommodus
Definieert hoe zoomen in de
webview
wordt afgehandeld. - terugbellen
functie optioneel
De
callback
ziet er als volgt uit:() => void
stop()
chrome.webviewTag.stop(): void
Stopt het laden van de huidige webview
als deze bezig is.
stopFinding()
chrome.webviewTag.stopFinding(
action?: StopFindingAction,
): void
Beëindigt de huidige zoekopdracht (alle markeringen worden gewist) en annuleert alle zoekopdrachten die in uitvoering zijn.
Parameters
- actie
StopFindingAction optioneel
Bepaalt wat er met de actieve match moet gebeuren nadat de zoekactie is beëindigd.
clear
verwijdert de markering van de actieve match;keep
houdt de actieve match gemarkeerd;activate
houdt de actieve match gemarkeerd en simuleert een klik van de gebruiker op die match. De standaardactie iskeep
.
terminate()
chrome.webviewTag.terminate(): void
Sluit het renderproces van de gastwebpagina geforceerd af. Dit kan van invloed zijn op meerdere webview
tags in de huidige app als ze hetzelfde proces delen, maar het heeft geen invloed op webview
tags in andere apps.
Evenementen
close
chrome.webviewTag.close.addListener(
callback: function,
)
Wordt geactiveerd wanneer het gastvenster zichzelf probeert te sluiten.
De volgende voorbeeldcode navigeert de webview
naar about:blank
wanneer de gast zichzelf probeert te sluiten.
webview.addEventListener('close', function() {
webview.src = 'about:blank';
});
Parameters
- terugbellen
functie
De
callback
ziet er als volgt uit:() => void
consolemessage
chrome.webviewTag.consolemessage.addListener(
callback: function,
)
Wordt geactiveerd wanneer het gastvenster een consolebericht registreert.
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
- terugbellen
functie
De
callback
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,
)
Wordt geactiveerd wanneer het gastvenster een load
activeert, d.w.z. wanneer een nieuw document wordt geladen. Dit geldt niet voor paginanavigatie binnen het huidige document of asynchrone resourceladingen.
Met de volgende voorbeeldcode wordt de standaardlettergrootte van het body
element van de gast gewijzigd nadat de pagina is geladen:
webview.addEventListener('contentload', function() {
webview.executeScript({ code: 'document.body.style.fontSize = "42px"' });
});
Parameters
- terugbellen
functie
De
callback
ziet er als volgt uit:() => void
dialog
chrome.webviewTag.dialog.addListener(
callback: function,
)
Wordt geactiveerd wanneer het gastvenster probeert een modaal dialoogvenster te openen via window.alert
, window.confirm
of window.prompt
.
Als deze gebeurtenis wordt afgehandeld, wordt het gastproces geblokkeerd totdat elke gebeurtenislistener terugkeert of het dialog
onbereikbaar wordt (als preventDefault()
is aangeroepen.)
Standaard wordt het dialoogvenster geannuleerd.
Parameters
- terugbellen
functie
De
callback
ziet er als volgt uit:(messageType: DialogMessageType, messageText: string, dialog: DialogController) => void
- berichtType
- berichtTekst
snaar
- dialoog
exit
chrome.webviewTag.exit.addListener(
callback: function,
)
Wordt geactiveerd wanneer het proces dat de gastwebinhoud weergeeft, is beëindigd.
De volgende voorbeeldcode toont een afscheidsbericht wanneer de gastpagina crasht:
webview.addEventListener('exit', function(e) {
if (e.reason === 'crash') {
webview.src = 'data:text/plain,Goodbye, world!';
}
});
Parameters
- terugbellen
functie
De
callback
ziet er als volgt uit:(details: object) => void
- details
voorwerp
- proces-ID
nummer
De interne ID van Chrome van het proces dat is beëindigd.
- reden
String die de reden voor het afsluiten aangeeft.
findupdate
chrome.webviewTag.findupdate.addListener(
callback: function,
)
Wordt geactiveerd wanneer er nieuwe zoekresultaten beschikbaar zijn voor een actieve zoekopdracht. Dit kan meerdere keren gebeuren voor één zoekopdracht, afhankelijk van of er overeenkomsten worden gevonden.
Parameters
- terugbellen
functie
De
callback
ziet er als volgt uit:(searchText: string, numberOfMatches: number, activeMatchOrdinal: number, selectionRect: SelectionRect, canceled: boolean, finalUpdate: string) => void
- zoektekst
snaar
- aantal wedstrijden
nummer
- actieveMatchOrdinal
nummer
- selectieRect
- geannuleerd
Booleaanse
- laatste update
snaar
loadabort
chrome.webviewTag.loadabort.addListener(
callback: function,
)
Wordt geactiveerd wanneer een load op het hoogste niveau is afgebroken zonder commit. Er wordt een foutmelding op de console weergegeven, tenzij de gebeurtenis standaard is geblokkeerd.
Let op: wanneer het laden van een resource wordt afgebroken, wordt een loadabort
-gebeurtenis uiteindelijk gevolgd door een loadstop
-gebeurtenis, zelfs als alle toegewezen ladingen sinds de laatste loadstop
gebeurtenis (indien van toepassing) zijn afgebroken.
Let op: wanneer het laden van een about-URL of een JavaScript-URL wordt afgebroken, wordt loadabort
geactiveerd en wordt de webview
naar 'about:blank' genavigeerd.
Parameters
- terugbellen
functie
De
callback
ziet er als volgt uit:(url: string, isTopLevel: boolean, code: number, reason: LoadAbortReason) => void
- url
snaar
- isTopLevel
Booleaanse
- code
nummer
- reden
loadcommit
chrome.webviewTag.loadcommit.addListener(
callback: function,
)
Wordt geactiveerd wanneer een load is vastgelegd. Dit omvat navigatie binnen het huidige document en load-opdrachten op subframe-documentniveau, maar omvat geen asynchrone resource-loads.
Parameters
- terugbellen
functie
De
callback
ziet er als volgt uit:(url: string, isTopLevel: boolean) => void
- url
snaar
- isTopLevel
Booleaanse
loadredirect
chrome.webviewTag.loadredirect.addListener(
callback: function,
)
Wordt geactiveerd wanneer een laadverzoek op het hoogste niveau is omgeleid naar een andere URL.
Parameters
- terugbellen
functie
De
callback
ziet er als volgt uit:(oldUrl: string, newUrl: string, isTopLevel: boolean) => void
- oudeUrl
snaar
- nieuweUrl
snaar
- isTopLevel
Booleaanse
loadstart
chrome.webviewTag.loadstart.addListener(
callback: function,
)
Wordt afgevuurd wanneer het laden is begonnen.
Parameters
- terugbellen
functie
De
callback
ziet er als volgt uit:(url: string, isTopLevel: boolean) => void
- url
snaar
- isTopLevel
Booleaanse
loadstop
chrome.webviewTag.loadstop.addListener(
callback: function,
)
Wordt geactiveerd wanneer alle laadacties op frameniveau op een gastpagina (inclusief alle subframes) zijn voltooid. Dit omvat navigatie binnen het huidige document en laadacties op documentniveau in subframes, maar omvat geen asynchrone resourceladingen. Deze gebeurtenis wordt geactiveerd telkens wanneer het aantal laadacties op documentniveau van één (of meer) naar nul gaat. Als een pagina bijvoorbeeld al is geladen (d.w.z. loadstop
is al één keer geactiveerd) een nieuw iframe aanmaakt dat een pagina laadt, wordt een tweede loadstop
geactiveerd wanneer het laden van de iframepagina is voltooid. Dit patroon wordt vaak waargenomen op pagina's die advertenties laden.
Let op: wanneer een vastgelegde belasting wordt afgebroken, volgt er uiteindelijk een loadstop
-gebeurtenis op een loadabort
-gebeurtenis, zelfs als alle vastgelegde belastingen sinds de laatste loadstop
-gebeurtenis (indien van toepassing) zijn afgebroken.
Parameters
- terugbellen
functie
De
callback
ziet er als volgt uit:() => void
newwindow
chrome.webviewTag.newwindow.addListener(
callback: function,
)
Wordt geactiveerd wanneer de gastpagina een nieuw browservenster probeert te openen.
Met de volgende voorbeeldcode wordt voor elk aangevraagd nieuw venster een nieuwe webview
in de embedder gemaakt en erdoorheen genavigeerd:
webview.addEventListener('newwindow', function(e) {
var newWebview = document.createElement('webview');
document.body.appendChild(newWebview);
e.window.attach(newWebview);
});
Parameters
- terugbellen
functie
De
callback
ziet er als volgt uit:(window: NewWindow, targetUrl: string, initialWidth: number, initialHeight: number, name: string, windowOpenDisposition: WindowOpenDisposition) => void
- raam
- doel-URL
snaar
- beginbreedte
nummer
- beginhoogte
nummer
- naam
snaar
- vensterOpenDisposition
permissionrequest
chrome.webviewTag.permissionrequest.addListener(
callback: function,
)
Wordt geactiveerd wanneer de gastpagina speciale toestemming van de insluiter nodig heeft.
De volgende voorbeeldcode geeft de gastpagina toegang tot de webkitGetUserMedia
API. Houd er rekening mee dat een app die deze voorbeeldcode gebruikt, zelf audioCapture
en/of videoCapture
manifestrechten moet specificeren:
webview.addEventListener('permissionrequest', function(e) {
if (e.permission === 'media') {
e.request.allow();
}
});
Parameters
- terugbellen
functie
De
callback
ziet er als volgt uit:(permission: PermissionType, request: object) => void
- toestemming
- verzoek
voorwerp
responsive
chrome.webviewTag.responsive.addListener(
callback: function,
)
Wordt geactiveerd wanneer het proces dat de gastwebinhoud weergeeft, weer responsief is geworden, nadat het eerst niet reageerde.
Met de volgende voorbeeldcode wordt het webview
element in- of uitgeschakeld naarmate het responsief wordt of niet meer reageert:
webview.style.webkitTransition = 'opacity 250ms';
webview.addEventListener('unresponsive', function() {
webview.style.opacity = '0.5';
});
webview.addEventListener('responsive', function() {
webview.style.opacity = '1';
});
Parameters
- terugbellen
functie
De
callback
ziet er als volgt uit:(processID: number) => void
- proces-ID
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
- terugbellen
functie
De
callback
ziet er als volgt uit:(oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void
- oudeBreedte
nummer
- oudeHoogte
nummer
- nieuweBreedte
nummer
- nieuweHoogte
nummer
unresponsive
chrome.webviewTag.unresponsive.addListener(
callback: function,
)
Wordt geactiveerd wanneer het proces dat de gastwebcontent weergeeft, niet meer reageert. Deze gebeurtenis wordt eenmalig gegenereerd met een overeenkomende responsieve gebeurtenis als de gast weer reageert.
Parameters
- terugbellen
functie
De
callback
ziet er als volgt uit:(processID: number) => void
- proces-ID
nummer
zoomchange
chrome.webviewTag.zoomchange.addListener(
callback: function,
)
Wordt geactiveerd wanneer de zoom van de pagina verandert.
Parameters
- terugbellen
functie
De
callback
ziet er als volgt uit:(oldZoomFactor: number, newZoomFactor: number) => void
- oudeZoomFactor
nummer
- newZoomFactor
nummer