Beschrijving
Gebruik de webview
tag om actief live-inhoud van internet via het netwerk te laden en deze in uw Chrome-app in te sluiten. Uw app kan de weergave van de webview
bepalen en communiceren met de webinhoud, navigatie starten op een ingesloten webpagina, reageren op foutgebeurtenissen die daarin plaatsvinden, en meer (zie Gebruik ).
Machtigingen
webview
Soorten
ClearDataOptions
Opties die bepalen welke gegevens door clearData
moeten worden gewist.
Eigenschappen
- sinds
nummer optioneel
Duidelijke gegevens verzameld op of na deze datum, weergegeven in milliseconden sinds het tijdperk (toegankelijk via de getTime-methode van het JavaScript
Date
object). Indien afwezig, standaard ingesteld op0
(waardoor alle browsegegevens worden verwijderd).
ClearDataTypeSet
Een set gegevenstypen. Ontbrekende eigenschappen worden als false
geïnterpreteerd.
Eigenschappen
- app-cache
Booleaans optioneel
App-caches van websites.
- cache
Booleaans optioneel
Chroom 44+Sinds Chrome 43. De cache van de browser. Let op: bij het verwijderen van gegevens wordt de gehele cache gewist; het is niet beperkt tot het bereik dat u opgeeft.
- koekjes
Booleaans optioneel
De cookies van de partitie.
- bestandssystemen
Booleaans optioneel
Bestandssystemen van websites.
- geïndexeerdeDB
Booleaans optioneel
GeïndexeerdeDB-gegevens van websites.
- lokale opslag
Booleaans optioneel
Lokale opslaggegevens van websites.
- persistente cookies
Booleaans optioneel
Chroom 58+De permanente cookies van de partitie.
- sessieCookies
Booleaans optioneel
Chroom 58+De sessiecookies van de partitie.
- webSQL
Booleaans optioneel
WebSQL-gegevens van websites.
ContentScriptDetails
Details van het inhoudsscript dat moet worden geïnjecteerd. Raadpleeg de documentatie over inhoudsscripts voor meer details.
Eigenschappen
- alle_frames
Booleaans optioneel
Als
all_frames
true
is, betekent dit dat JavaScript of CSS in alle frames van de huidige pagina moet worden geïnjecteerd. Standaard isall_frames
false
en wordt JavaScript of CSS alleen in het bovenste frame geïnjecteerd. - css
InjectieItems optioneel
De CSS-code of een lijst met CSS-bestanden die in overeenkomende pagina's moeten worden geïnjecteerd. Deze worden geïnjecteerd in de volgorde waarin ze verschijnen, voordat er een DOM voor de pagina wordt gemaakt of weergegeven.
- sluit_globs uit
tekenreeks[] optioneel
Toegepast na overeenkomsten om URL's uit te sluiten die overeenkomen met deze glob. Bedoeld om het trefwoord @exclude Greasemonkey te emuleren.
- sluit_overeenkomsten uit
tekenreeks[] optioneel
Exclusief pagina's waarin dit inhoudsscript anders zou worden geïnjecteerd.
- include_globs
tekenreeks[] optioneel
Toegepast na overeenkomsten om alleen die URL's op te nemen die ook overeenkomen met deze glob. Bedoeld om het trefwoord @include Greasemonkey te emuleren.
- js
InjectieItems optioneel
De JavaScript-code of een lijst met JavaScript-bestanden die in overeenkomende pagina's moeten worden geïnjecteerd. Deze worden geïnjecteerd in de volgorde waarin ze verschijnen.
- match_about_blank
Booleaans optioneel
Of het inhoudsscript moet worden ingevoegd in about:blank en about:srcdoc. Contentscripts worden alleen op pagina's geïnjecteerd als hun overgenomen URL overeenkomt met een van de gedeclareerde patronen in het overeenkomstenveld. De overervende URL is de URL van het document dat het frame of venster heeft gemaakt. Inhoudsscripts kunnen niet in sandboxframes worden ingevoegd.
- wedstrijden
snaar[]
Specificeert op welke pagina's dit inhoudsscript wordt geïnjecteerd.
- naam
snaar
De naam van het inhoudsscript dat moet worden geïnjecteerd.
- run_at
RunAt optioneel
Het snelste dat JavaScript of CSS in het tabblad wordt geïnjecteerd. Standaard ingesteld op "document_idle".
ContentWindow
Berichteningang naar een gastvenster.
Eigenschappen
- postBericht
leegte
Plaatst een bericht op de ingesloten webinhoud zolang de ingesloten inhoud een pagina vanaf de doeloorsprong 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 naar de insluiter sturen door een bericht te plaatsen op
event.source
op de berichtgebeurtenis die hij ontvangt.Deze API is identiek aan de HTML5 postMessage API voor communicatie tussen webpagina's. De insluiter kan naar antwoorden 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 dat naar de gast moet worden verzonden.
- doelHerkomst
snaar
Specificeert wat de oorsprong van het gastvenster moet zijn voordat de gebeurtenis wordt verzonden.
ContextMenuCreateProperties
Eigenschappen
- gecontroleerd
Booleaans optioneel
De initiële status van een selectievakje of keuzerondje: waar voor geselecteerd en onwaar voor niet-geselecteerd. Er kan slechts één radio-item tegelijk worden geselecteerd in een bepaalde groep radio-items.
- contexten
[ ContextType , ... ContextType []] optioneel
Lijst met contexten waarin dit menu-item zal verschijnen. Standaard ingesteld op ['pagina'] indien niet gespecificeerd.
- documentUrlPatterns
tekenreeks[] optioneel
Hiermee kunt u het item beperken zodat het alleen van toepassing is op documenten waarvan de URL overeenkomt met een van de opgegeven patronen. (Dit geldt ook voor frames.) Zie Matchpatronen voor details over het formaat van een patroon.
- ingeschakeld
Booleaans optioneel
Of dit contextmenu-item is ingeschakeld of uitgeschakeld. Standaard ingesteld op
true
. - Identiteitskaart
tekenreeks optioneel
De unieke ID die aan dit item moet worden toegewezen. Verplicht voor evenementpagina's. Kan niet hetzelfde zijn als een andere ID voor deze extensie.
- ouderId
tekenreeks | nummer optioneel
De ID van een bovenliggend menu-item; hierdoor wordt het item een onderliggend item van een eerder toegevoegd item.
- targetUrlPatterns
tekenreeks[] optioneel
Vergelijkbaar met documentUrlPatterns, maar u kunt filteren op basis van het
src
attribuut van img/audio/video-tags en dehref
van ankertags. - titel
tekenreeks optioneel
De tekst die in het item moet worden weergegeven; dit is vereist tenzij
type
'separator' is. Wanneer de context 'selectie' is, kunt u%s
binnen de string 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 ingesteld op 'normaal' als dit niet is opgegeven.
- klik
ongeldig optioneel
Een functie die wordt teruggeroepen wanneer 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 de klik heeft plaatsgevonden.
ContextMenus
Eigenschappen
- opToon
Gebeurtenis<functionvoidvoid>
Geactiveerd voordat een contextmenu op deze
webview
werd weergegeven. Kan worden gebruikt om dit contextmenu uit te schakelen doorevent.preventDefault()
aan te roepen.De
onShow.addListener
-functie ziet er als volgt uit:(callback: function) => {...}
- terugbellen
functie
De
callback
parameter ziet er als volgt uit:(event: object) => void
- evenement
voorwerp
- voorkomenStandaard
leegte
Roep dit op om te voorkomen dat het contextmenu wordt weergegeven.
De
preventDefault
functie ziet er als volgt uit:() => {...}
- creëren
leegte
Creëert een nieuw contextmenu-item. Houd er rekening mee dat als er tijdens het maken een fout optreedt, u daar mogelijk pas achter komt als de callback voor het maken van de creatie wordt geactiveerd (de details staan in
runtime.lastError
).De
create
functie ziet er als volgt uit:(createProperties: object, callback?: function) => {...}
- maakeigenschappen
voorwerp
De eigenschappen die zijn gebruikt om het item te maken
- terugbellen
functie optioneel
De
callback
parameter ziet er als volgt uit:() => void
- retourneert
tekenreeks | nummer
De ID van het nieuw gemaakte item.
- verwijderen
leegte
Verwijdert een contextmenu-item.
De
remove
ziet er als volgt uit:(menuItemId: string | number, callback?: function) => {...}
tekenreeks | nummer
De ID van het contextmenu-item dat moet worden verwijderd.
- terugbellen
functie optioneel
De
callback
parameter ziet er als volgt uit:() => void
- verwijderAlles
leegte
Verwijdert alle contextmenu-items die aan deze
webview
zijn toegevoegd.De
removeAll
functie ziet er als volgt uit:(callback?: function) => {...}
- terugbellen
functie optioneel
De
callback
parameter 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) => {...}
- Identiteitskaart
tekenreeks | nummer
De ID van het item dat moet worden bijgewerkt.
- updateEigenschappen
voorwerp
De eigenschappen die moeten worden bijgewerkt. Accepteert dezelfde waarden als de create-functie.
- terugbellen
functie optioneel
De
callback
parameter ziet er als volgt uit:() => void
ContextMenuUpdateProperties
Eigenschappen
- gecontroleerd
Booleaans optioneel
De status van een selectievakje of keuzerondje: waar voor geselecteerd en onwaar voor niet-geselecteerd. Er kan slechts één radio-item tegelijk worden geselecteerd in een bepaalde groep radio-items.
- contexten
[ ContextType , ... ContextType []] optioneel
Lijst met contexten waarin dit menu-item zal verschijnen.
- documentUrlPatterns
tekenreeks[] optioneel
Hiermee kunt u het item beperken zodat het alleen van toepassing is op documenten waarvan de URL overeenkomt met een van de opgegeven patronen. (Dit geldt ook voor frames.) Zie Matchpatronen voor details over het formaat van een patroon.
- ingeschakeld
Booleaans optioneel
Of dit contextmenu-item is ingeschakeld of uitgeschakeld.
- ouderId
tekenreeks | nummer optioneel
De ID van een bovenliggend menu-item; hierdoor wordt het item een onderliggend item van een eerder toegevoegd item. Opmerking: u kunt een item niet wijzigen zodat het een onderliggend item is van een van zijn eigen afstammelingen.
- targetUrlPatterns
tekenreeks[] optioneel
Vergelijkbaar met documentUrlPatterns, maar u kunt filteren op basis van het
src
attribuut van img/audio/video-tags en dehref
van ankertags. - titel
tekenreeks optioneel
De tekst die in het item moet worden weergegeven
- type
ItemType optioneel
Het type menu-item.
- klik
ongeldig optioneel
Een functie die wordt teruggeroepen wanneer 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 de klik heeft plaatsgevonden.
ContextType
De verschillende contexten waarin een menu kan verschijnen. Het specificeren van 'alles' is gelijk 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
Verwerp de dialoog. Gelijk aan het klikken op Annuleren in een
confirm
ofprompt
.De
cancel
ziet er als volgt uit:() => {...}
- OK
leegte
Accepteer het dialoogvenster. Gelijk aan klikken op OK in een
alert
,confirm
ofprompt
.De
ok
functie ziet er als volgt uit:(response?: string) => {...}
- antwoord
tekenreeks optioneel
De antwoordtekenreeks die aan de gast moet worden verstrekt bij het accepteren van een
prompt
.
DownloadPermissionRequest
Het type request
dat bij een DOM-gebeurtenis permissionrequest
download
hoort.
Eigenschappen
- aanvraagmethode
snaar
Het HTTP-verzoektype (bijvoorbeeld
GET
) dat aan het downloadverzoek 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
functie ziet er als volgt uit:() => {...}
FileSystemPermissionRequest
Het type request
dat bij een DOM-gebeurtenis permissionrequest
van een filesystem
hoort.
Eigenschappen
- URL
snaar
De URL van het frame dat toegang vraagt tot het lokale bestandssysteem.
- toestaan
leegte
Sta het toestemmingsverzoek toe.
De
allow
functie ziet er als volgt uit:() => {...}
- ontkennen
leegte
Weiger het toestemmingsverzoek.
De
deny
functie ziet er als volgt uit:() => {...}
FindCallbackResults
Bevat alle resultaten van de zoekopdracht.
Eigenschappen
- activeMatchOrdinaal
nummer
Het volgnummer van de huidige wedstrijd.
- geannuleerd
Booleaans
Geeft aan of deze zoekopdracht is geannuleerd.
- aantalWedstrijden
nummer
Het aantal keren dat
searchText
op de pagina werd gevonden. - selectieRect
Beschrijft een rechthoek rond de actieve match in schermcoördinaten.
FindOptions
Opties voor de zoekopdracht.
Eigenschappen
- achteruit
Booleaans optioneel
Markeer om overeenkomsten in omgekeerde volgorde te vinden. De standaardwaarde is
false
. - matchCase
Booleaans optioneel
Vlag die overeenkomt met hoofdlettergevoeligheid. De standaardwaarde is
false
.
FullscreenPermissionRequest
Het type request
dat bij een DOM-gebeurtenis permissionrequest
fullscreen
hoort.
Eigenschappen
- oorsprong
snaar
De oorsprong van het frame in de
webview
die het verzoek op volledig scherm heeft gestart. - toestaan
leegte
Sta het toestemmingsverzoek toe.
De
allow
functie ziet er als volgt uit:() => {...}
- ontkennen
leegte
Weiger het toestemmingsverzoek.
De
deny
functie ziet er als volgt uit:() => {...}
GeolocationPermissionRequest
Het type request
dat bij een DOM-gebeurtenis permissionrequest
geolocation
hoort.
Eigenschappen
- URL
snaar
De URL van het frame dat toegang vraagt tot geolocatiegegevens.
- 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
functie 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 vraagt tot de HID API.
- 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
functie ziet er als volgt uit:() => {...}
InjectDetails
Details van het script of de CSS die moet worden geïnjecteerd. De code of de bestandseigenschap moet worden ingesteld, maar beide mogen niet tegelijkertijd worden ingesteld.
Eigenschappen
- code
tekenreeks optioneel
JavaScript- of CSS-code om te injecteren.
Waarschuwing: Wees voorzichtig met het gebruik van de
code
. Bij onjuist gebruik ervan kan uw app openstaan voor cross-site scripting- aanvallen. - bestand
tekenreeks optioneel
JavaScript- of CSS-bestand om te injecteren.
InjectionItems
Het type injectie-item: code of een set bestanden.
Eigenschappen
- code
tekenreeks optioneel
JavaScript-code of CSS die in overeenkomende pagina's moet worden geïnjecteerd.
- bestanden
tekenreeks[] optioneel
De lijst met JavaScript- of CSS-bestanden die in overeenkomende pagina's moeten worden geïnjecteerd. Deze worden geïnjecteerd in de volgorde waarin ze in deze array verschijnen.
LoadPluginPermissionRequest
Het type request
dat bij een DOM-gebeurtenis loadplugin
permissionrequest
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
Weiger het toestemmingsverzoek.
De
deny
functie ziet er als volgt uit:() => {...}
MediaPermissionRequest
Het type request
dat bij een DOM-gebeurtenis permissionrequest
media
.
Eigenschappen
- URL
snaar
De URL van het frame dat toegang vraagt tot gebruikersmedia.
- 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
functie ziet er als volgt uit:() => {...}
NewWindow
Interface gekoppeld aan newwindow
DOM-gebeurtenissen.
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 nieuwe vensterverzoek.
De
discard
ziet er als volgt uit:() => {...}
PointerLockPermissionRequest
Het type request
dat bij een DOM-gebeurtenis pointerLock
permissionrequest
hoort.
Eigenschappen
- lastUnlockedBySelf
Booleaans
Of het verzoekende frame wel of niet de meest recente client was die pointerlock vasthield.
- URL
snaar
De URL van het frame dat om aanwijzervergrendeling vraagt.
- gebruikerGebaar
Booleaans
Of de aanwijzervergrendeling wel of niet is aangevraagd als gevolg 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
functie ziet er als volgt uit:() => {...}
SelectionRect
Beschrijft een rechthoek in schermcoördinaten.
De containment-semantiek is array-achtig; dat wil zeggen dat de coördinaat (left, top)
wordt geacht te zijn opgenomen in 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.
WebRequestEventInterface
Interface die toegang biedt tot webRequest-evenementen op de gastpagina. Zie de chrome.webRequest- extensies-API voor meer informatie over de levenscyclus van webRequest en gerelateerde concepten. Opmerking: de gebeurtenis chrome.webRequest.onActionIgnored wordt niet ondersteund voor webviews.
Om te illustreren hoe het gebruik verschilt van de webRequest API van de extensie, kunt u de volgende voorbeeldcode bekijken 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"]);
Bovendien ondersteunt deze interface declaratieve webRequest-regels via onRequest
en onMessage
gebeurtenissen. Zie declarativeWebRequest
voor API-details.
Houd er rekening mee dat de voorwaarden en acties voor declaratieve webview-webRequests moeten worden geïnstantieerd vanuit hun chrome.webViewRequest.*
tegenhangers. 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]);
ZoomMode
Definieert hoe er wordt ingezoomd in de webview
.
Enum
"per oorsprong" "per weergave" "gehandicapt"
Zoomwijzigingen blijven behouden in de oorsprong van de ingezoomde pagina, dat wil zeggen dat alle andere webweergaven in dezelfde partitie die naar dezelfde oorsprong worden genavigeerd, ook zullen worden ingezoomd. Bovendien worden zoomwijzigingen per-origin
opgeslagen bij de oorsprong, wat betekent dat wanneer u naar andere pagina's in dezelfde oorsprong navigeert, ze allemaal met dezelfde zoomfactor worden ingezoomd.
Zoomwijzigingen zijn alleen van kracht in deze webweergave, en zoomwijzigingen in andere webweergaven hebben geen invloed op het zoomen van deze webweergave. Ook worden zoomwijzigingen per-view
gereset tijdens de navigatie; het navigeren door een webweergave laadt altijd pagina's met hun zoomfactoren per oorsprong (binnen het bereik 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 kan worden gebruikt om berichten op de gastpagina te plaatsen.
Type
contextMenus
Vergelijkbaar met de ContextMenus API van Chrome , maar van toepassing op webview
in plaats van browser. Gebruik de webview.contextMenus
API om items toe te voegen aan het contextmenu van webview
. U kunt kiezen op welke typen objecten de toevoegingen aan het contextmenu van toepassing zijn, zoals afbeeldingen, hyperlinks en pagina's.
Type
request
Interface die toegang biedt tot webRequest-evenementen op de gastpagina.
Methoden
addContentScripts()
chrome.webviewTag.addContentScripts(
contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
)
Voegt injectieregels voor inhoudsscripts 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.
In het volgende voorbeeld worden twee regels aan de webview
toegevoegd: '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.
In het volgende voorbeeld ziet u hoe u 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 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 laten injecteren. Als u onmiddellijke injectie wilt, zal executeScript
het juiste doen.
Regels blijven behouden, zelfs als het gastproces crasht of wordt beëindigd, of zelfs als de webview
opnieuw wordt ingesteld.
Raadpleeg de documentatie over inhoudsscripts voor meer details.
Parameters
- inhoudScriptLijst
[ ContentScriptDetails , ... ContentScriptDetails []]
Details van de inhoudsscripts die moeten worden toegevoegd.
back()
chrome.webviewTag.back(
callback?: function,
)
Navigeer indien mogelijk één geschiedenisitem terug. Equivalent aan go(-1)
.
Parameters
- terugbellen
functie optioneel
Chroom 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()
Geeft aan of het mogelijk is om terug door de geschiedenis te navigeren. De status van deze functie wordt in de cache opgeslagen en vóór elke loadcommit
bijgewerkt, dus de beste plaats om deze aan te roepen is op loadcommit
.
Retouren
Booleaans
canGoForward()
chrome.webviewTag.canGoForward()
Geeft aan of het mogelijk is om vooruit door de geschiedenis te navigeren. De status van deze functie wordt in de cache opgeslagen en vóór elke loadcommit
bijgewerkt, dus de beste plaats om deze aan te roepen is op loadcommit
.
Retouren
Booleaans
captureVisibleRegion()
chrome.webviewTag.captureVisibleRegion(
options?: ImageDetails,
callback: function,
)
Legt het zichtbare gebied van de webweergave vast.
Parameters
- opties
Afbeeldingsdetails optioneel
- terugbellen
functie
De
callback
parameter ziet er als volgt uit:(dataUrl: string) => void
- dataUrl
snaar
Een gegevens-URL die een afbeelding codeert van het zichtbare gebied van het vastgelegde tabblad. Kan worden toegewezen aan de eigenschap 'src' van een HTML-afbeeldingselement voor weergave.
clearData()
chrome.webviewTag.clearData(
options: ClearDataOptions,
types: ClearDataTypeSet,
callback?: function,
)
Wist de browsegegevens voor de webview
partitie.
Parameters
- opties
Opties die bepalen welke gegevens moeten worden gewist.
- typen
De soorten gegevens die moeten worden gewist.
- terugbellen
functie optioneel
De
callback
parameter ziet er als volgt uit:() => void
executeScript()
chrome.webviewTag.executeScript(
details: InjectDetails,
callback?: function,
)
Injecteert JavaScript-code in de gastpagina.
De volgende voorbeeldcode maakt gebruik van scriptinjectie om de achtergrondkleur van de gastpagina in te stellen op rood:
webview.executeScript({ code: "document.body.style.backgroundColor = 'red'" });
Parameters
- details
Details van het uit te voeren script.
- terugbellen
functie optioneel
De
callback
parameter ziet er als volgt uit:(result?: any[]) => void
- resultaat
elke [] optioneel
Het resultaat van het script in elk geïnjecteerd frame.
find()
chrome.webviewTag.find(
searchText: string,
options?: FindOptions,
callback?: function,
)
Start een zoek-op-pagina-verzoek.
Parameters
- zoekTekst
snaar
De tekenreeks die op de pagina moet worden gevonden.
- opties
FindOptions optioneel
Opties voor de zoekopdracht.
- terugbellen
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 deze niet worden gebruikt in de callback-functie; bijvoorbeeld als het terugbellen alleen wordt gebruikt om vast te stellen wanneer het zoekverzoek is voltooid.
forward()
chrome.webviewTag.forward(
callback?: function,
)
Navigeer indien mogelijk één geschiedenisitem vooruit. Equivalent aan go(1)
.
Parameters
- terugbellen
functie optioneel
Chroom 44+De
callback
parameter ziet er als volgt uit:(success: boolean) => void
- succes
Booleaans
Geeft aan of de navigatie succesvol was.
getAudioState()
chrome.webviewTag.getAudioState(
callback: function,
)
Vraagt audiostatus op.
Parameters
- terugbellen
functie
De
callback
parameter ziet er als volgt uit:(audible: boolean) => void
- hoorbaar
Booleaans
getProcessId()
chrome.webviewTag.getProcessId()
Retourneert de interne proces-ID van Chrome voor het huidige proces van de gastwebpagina, zodat insluiters kunnen weten hoeveel gasten worden beïnvloed door het beëindigen van het proces. Twee gasten delen een proces alleen als ze tot dezelfde app behoren en dezelfde opslagpartitie-ID hebben. De aanroep is synchroon en retourneert het in de cache opgeslagen notie van de huidige proces-ID van de embedder. De proces-ID is niet hetzelfde als de proces-ID van het besturingssysteem.
Retouren
nummer
getUserAgent()
chrome.webviewTag.getUserAgent()
Retourneert de user-agentstring die door de webview
wordt gebruikt voor gastpaginaverzoeken.
Retouren
snaar
getZoom()
chrome.webviewTag.getZoom(
callback: function,
)
Haalt de huidige zoomfactor op.
Parameters
- terugbellen
functie
De
callback
parameter ziet er als volgt uit:(zoomFactor: number) => void
- zoomFactor
nummer
De huidige zoomfactor.
getZoomMode()
chrome.webviewTag.getZoomMode(
callback: function,
)
Haalt de huidige zoommodus op.
Parameters
- terugbellen
functie
De
callback
parameter ziet er als volgt uit:(ZoomMode: ZoomMode) => void
- Zoommodus
De huidige zoommodus van de
webview
.
go()
chrome.webviewTag.go(
relativeIndex: number,
callback?: function,
)
Navigeer naar een geschiedenisitem met behulp van een geschiedenisindex relatief aan 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 van2
zal bijvoorbeeld indien mogelijk twee geschiedenisitems vooruit navigeren; een waarde van-3
navigeert 3 items achteruit. - terugbellen
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,
)
Injecteert CSS in de gastpagina.
Parameters
- details
Details van de CSS die moet worden ingevoegd.
- terugbellen
functie optioneel
De
callback
parameter ziet er als volgt uit:() => void
isAudioMuted()
chrome.webviewTag.isAudioMuted(
callback: function,
)
Vraagt of het geluid is gedempt.
Parameters
- terugbellen
functie
De
callback
parameter ziet er als volgt uit:(muted: boolean) => void
- gedempt
Booleaans
isSpatialNavigationEnabled()
chrome.webviewTag.isSpatialNavigationEnabled(
callback: function,
)
Vraagt of ruimtelijke navigatie is ingeschakeld voor de webweergave.
Parameters
functie
De
callback
parameter ziet er als volgt uit:(enabled: boolean) => void
Booleaans
isUserAgentOverridden()
chrome.webviewTag.isUserAgentOverridden()
Geeft aan of de user-agentstring van de webview
al dan niet is overschreven door webviewTag.setUserAgentOverride
.
loadDataWithBaseUrl()
chrome.webviewTag.loadDataWithBaseUrl(
dataUrl: string,
baseUrl: string,
virtualUrl?: string,
)
Laadt een gegevens-URL met een opgegeven basis-URL die wordt gebruikt voor relatieve links. Optioneel kan in plaats van de gegevens-URL een virtuele URL worden opgegeven die aan de gebruiker kan worden getoond.
Parameters
- dataUrl
snaar
De gegevens-URL die moet worden geladen.
- basisUrl
snaar
De basis-URL die wordt gebruikt voor relatieve links.
- virtueleUrl
tekenreeks optioneel
De URL die aan de gebruiker wordt weergegeven (in de adresbalk).
print()
chrome.webviewTag.print()
Drukt de inhoud van de webview
af. Dit komt overeen met het aanroepen van de scriptafdrukfunctie vanuit de webview
zelf.
reload()
chrome.webviewTag.reload()
Laadt de huidige pagina op het hoogste niveau opnieuw.
removeContentScripts()
chrome.webviewTag.removeContentScripts(
scriptNameList?: string[],
)
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 te bellen naar:
webview.removeContentScripts();
Parameters
- scriptNameLijst
tekenreeks[] optioneel
Een lijst met namen van inhoudsscripts die worden verwijderd. Als de lijst leeg is, worden alle inhoudsscripts die aan de
webview
zijn toegevoegd, verwijderd.
setAudioMuted()
chrome.webviewTag.setAudioMuted(
mute: boolean,
)
Stelt de audio-dempingsstatus van de webweergave in.
Parameters
- stom
Booleaans
Audiowaarde dempen
setSpatialNavigationEnabled()
chrome.webviewTag.setSpatialNavigationEnabled(
enabled: boolean,
)
Stelt de ruimtelijke navigatiestatus van de webweergave in.
Parameters
Booleaans
Waarde van de ruimtelijke navigatiestatus.
setUserAgentOverride()
chrome.webviewTag.setUserAgentOverride(
userAgent: string,
)
Overschrijf de user-agentstring die door de webview
wordt gebruikt voor gastpaginaverzoeken. Overschrijven zorgt ervoor dat de waarden van de User-Agent Client Hint-header en de door navigator.userAgentData
geretourneerde waarden leeg zijn voor gastpaginaverzoeken waarop deze overschrijving wordt toegepast.
Parameters
- gebruikerAgent
snaar
De user-agentreeks die moet worden gebruikt.
setZoom()
chrome.webviewTag.setZoom(
zoomFactor: number,
callback?: function,
)
Verandert 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
parameter ziet er als volgt uit:() => void
setZoomMode()
chrome.webviewTag.setZoomMode(
ZoomMode: ZoomMode,
callback?: function,
)
Stelt de zoommodus van de webview
in.
Parameters
- Zoommodus
Definieert hoe er wordt ingezoomd in de
webview
. - terugbellen
functie optioneel
De
callback
parameter ziet er als volgt uit:() => void
stop()
chrome.webviewTag.stop()
Stopt met het laden van de huidige webview
als deze bezig is.
stopFinding()
chrome.webviewTag.stopFinding(
action?: "clear"
| "keep"
| "activate"
,
)
Beëindigt de huidige zoeksessie (waarbij alle markeringen worden gewist) en annuleert alle lopende zoekverzoeken.
Parameters
- actie
"duidelijk"
| "houden"
| "activeren"
optioneelBepaalt wat er met de actieve match moet gebeuren nadat de zoeksessie is beëindigd.
clear
verwijdert de markering van de actieve match;keep
zorgt ervoor dat de actieve match gemarkeerd blijft;activate
zorgt ervoor dat de actieve match gemarkeerd blijft en simuleert een gebruikersklik op die match. De standaardactie iskeep
.
terminate()
chrome.webviewTag.terminate()
Doodt met geweld het rendererproces van de gastwebpagina. Dit kan van invloed zijn op meerdere webview
tags in de huidige app als deze hetzelfde proces delen, maar 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 door 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
parameter 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 insluiter, 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
parameter ziet er als volgt uit:(level: number, message: string, line: number, sourceId: string) => void
- niveau
nummer
- bericht
snaar
- lijn
nummer
- bronId
snaar
contentload
chrome.webviewTag.contentload.addListener(
callback: function,
)
Wordt geactiveerd wanneer het gastvenster een load
activeert, dat wil zeggen wanneer een nieuw document wordt geladen. Dit omvat niet de paginanavigatie binnen het huidige document of het asynchrone laden van bronnen.
De volgende voorbeeldcode wijzigt de standaardlettergrootte 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
- terugbellen
functie
De
callback
parameter 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
.
Het afhandelen van deze gebeurtenis blokkeert het gastproces totdat elke gebeurtenislistener terugkeert of het dialog
onbereikbaar wordt (als preventDefault()
is aangeroepen.)
Het standaardgedrag is het annuleren van het dialoogvenster.
Parameters
- terugbellen
functie
De
callback
parameter ziet er als volgt uit:(messageType: "alert"
| "confirm"
| "prompt"
, messageText: string, dialog: DialogController) => void- berichtType
"waarschuwing"
| "bevestigen"
| "snel" - berichtTekst
snaar
- dialoog
exit
chrome.webviewTag.exit.addListener(
callback: function,
)
Wordt geactiveerd wanneer het proces dat de gastwebinhoud weergeeft, is afgesloten.
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
parameter ziet er als volgt uit:(processID: number, reason: "normal"
| "abnormal"
| "crash"
| "kill"
) => void- procesID
nummer
- reden
"normaal"
| "abnormaal"
| "crashen"
| "doden"
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 een enkel zoekverzoek als er overeenkomsten worden gevonden.
Parameters
- terugbellen
functie
De
callback
parameter ziet er als volgt uit:(searchText: string, numberOfMatches: number, activeMatchOrdinal: number, selectionRect: SelectionRect, canceled: boolean, finalUpdate: string) => void
- zoekTekst
snaar
- aantalWedstrijden
nummer
- activeMatchOrdinaal
nummer
- selectieRect
- geannuleerd
Booleaans
- laatsteupdate
snaar
loadabort
chrome.webviewTag.loadabort.addListener(
callback: function,
)
Wordt geactiveerd wanneer een lading op het hoogste niveau is afgebroken zonder vast te leggen. Er wordt een foutmelding op de console afgedrukt, tenzij de gebeurtenis standaard wordt voorkomen.
Opmerking: Wanneer het laden van een bron wordt afgebroken, wordt een loadabort
-gebeurtenis uiteindelijk gevolgd door een loadstop
gebeurtenis, zelfs als alle vastgelegde ladingen sinds de laatste loadstop
gebeurtenis (indien aanwezig) zijn afgebroken.
Opmerking: 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
parameter ziet er als volgt uit:(url: string, isTopLevel: boolean, code: number, reason: "ERR_ABORTED"
| "ERR_INVALID_URL"
| "ERR_DISALLOWED_URL_SCHEME"
| "ERR_BLOCKED_BY_CLIENT"
| "ERR_ADDRESS_UNREACHABLE"
| "ERR_EMPTY_RESPONSE"
| "ERR_FILE_NOT_FOUND"
| "ERR_UNKNOWN_URL_SCHEME"
) => void- URL
snaar
- isTopLevel
Booleaans
- code
nummer
- reden
"ERR_ABORTED"
| "ERR_INVALID_URL"
| "ERR_DISALLOWED_URL_SCHEMA"
| "ERR_BLOCKED_BY_CLIENT"
| "ERR_ADDRESS_UNREACHABLE"
| "ERR_EMPTY_RESPONSE"
| "ERR_FILE_NOT_FOUND"
| "ERR_UNKNOWN_URL_SCHEMA"
loadcommit
chrome.webviewTag.loadcommit.addListener(
callback: function,
)
Wordt afgevuurd wanneer een lading is vastgelegd. Dit omvat navigatie binnen het huidige document en het laden van subframes op documentniveau, maar niet het asynchrone laden van bronnen.
Parameters
- terugbellen
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 omgeleid naar een andere URL.
Parameters
- terugbellen
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 wanneer een lading is begonnen.
Parameters
- terugbellen
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,
)
Wordt geactiveerd wanneer alle laden op frameniveau op een gastpagina (inclusief alle subframes) zijn voltooid. Dit omvat navigatie binnen het huidige document en het laden van subframes op documentniveau, maar niet het asynchrone laden van bronnen. Deze gebeurtenis wordt elke keer geactiveerd wanneer het aantal ladingen op documentniveau overgaat van één (of meer) naar nul. Als bijvoorbeeld een pagina die al is geladen (dwz loadstop
is al één keer geactiveerd) een nieuw iframe maakt dat een pagina laadt, wordt een tweede loadstop
geactiveerd wanneer het laden van de iframe-pagina is voltooid. Dit patroon wordt vaak waargenomen op pagina's waarop advertenties worden geladen.
Opmerking: Wanneer een vastgelegde lading wordt afgebroken, zal er uiteindelijk een loadstop
volgen op een loadabort
, zelfs als alle vastgelegde ladingen sinds de laatste loadstop
(indien aanwezig) zijn afgebroken.
Parameters
- terugbellen
functie
De
callback
parameter ziet er als volgt uit:() => void
newwindow
chrome.webviewTag.newwindow.addListener(
callback: function,
)
Wordt geactiveerd wanneer de gastpagina probeert een nieuw browservenster te openen.
Met de volgende voorbeeldcode wordt voor elk aangevraagd nieuw venster een nieuwe webview
in de insluiting gemaakt en er doorheen genavigeerd:
webview.addEventListener('newwindow', function(e) {
var newWebview = document.createElement('webview');
document.body.appendChild(newWebview);
e.window.attach(newWebview);
});
Parameters
- terugbellen
functie
De
callback
parameter ziet er als volgt uit:(window: NewWindow, targetUrl: string, initialWidth: number, initialHeight: number, name: string, windowOpenDisposition: "ignore"
| "save_to_disk"
| "current_tab"
| "new_background_tab"
| "new_foreground_tab"
| "new_window"
| "new_popup"
) => void- raam
- doelUrl
snaar
- initiëleBreedte
nummer
- initiële Hoogte
nummer
- naam
snaar
- vensterOpenDisposition
"negeren"
| "opslaan_op_schijf"
| "huidig_tabblad"
| "nieuwe_achtergrond_tab"
| "nieuwe_voorgrond_tab"
| "nieuw_venster"
| "nieuwe_pop-up"
permissionrequest
chrome.webviewTag.permissionrequest.addListener(
callback: function,
)
Wordt geactiveerd wanneer de gastpagina speciale toestemming van de insluiter moet aanvragen.
De volgende voorbeeldcode verleent de gastpagina toegang tot de webkitGetUserMedia
API. Houd er rekening mee dat een app die deze voorbeeldcode gebruikt, zelf de manifestrechten audioCapture
en/of videoCapture
moet opgeven:
webview.addEventListener('permissionrequest', function(e) {
if (e.permission === 'media') {
e.request.allow();
}
});
Parameters
- terugbellen
functie
De
callback
parameter ziet er als volgt uit:(permission: "media"
| "geolocation"
| "pointerLock"
| "download"
| "loadplugin"
| "filesystem"
| "fullscreen"
| "hid"
, request: object) => void- toestemming
"media"
| "geolocatie"
| "pointerLock"
| "downloaden"
| "laadplug-in"
| "bestandssysteem"
| "volledig scherm"
| "verborgen" - verzoek
voorwerp
responsive
chrome.webviewTag.responsive.addListener(
callback: function,
)
Wordt geactiveerd wanneer het proces dat de gastwebinhoud weergeeft, weer responsief is geworden nadat het niet meer reageerde.
Met de volgende voorbeeldcode wordt het webview
element in- of uitgeschakeld naarmate het responsief of niet-reagerend wordt:
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
parameter ziet er als volgt uit:(processID: number) => void
- procesID
nummer
sizechanged
chrome.webviewTag.sizechanged.addListener(
callback: function,
)
Wordt geactiveerd wanneer de grootte van de ingesloten webinhoud is aangepast via autosize
. Wordt alleen geactiveerd als autosize
is ingeschakeld.
Parameters
- terugbellen
functie
De
callback
parameter ziet er als volgt uit:(oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void
- oudBreedte
nummer
- oudHoogte
nummer
- nieuwBreedte
nummer
- nieuwHoogte
nummer
unresponsive
chrome.webviewTag.unresponsive.addListener(
callback: function,
)
Wordt geactiveerd wanneer het proces dat de gastwebinhoud weergeeft niet meer reageert. Deze gebeurtenis wordt één keer gegenereerd met een bijpassende responsieve gebeurtenis als de gast opnieuw begint te reageren.
Parameters
- terugbellen
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 zoom van de pagina verandert.
Parameters
- terugbellen
functie
De
callback
parameter ziet er als volgt uit:(oldZoomFactor: number, newZoomFactor: number) => void
- oudeZoomFactor
nummer
- nieuweZoomFactor
nummer