Beschrijving
Gebruik de tag webview om live content van het web actief via het netwerk te laden en in te sluiten in je Chrome-app. Je app kan de weergave van de webview beheren en interactie hebben met de webcontent, navigaties starten op een ingesloten webpagina, reageren op foutgebeurtenissen die zich daarin voordoen en meer (zie Gebruik).
Rechten
webviewBeschikbaarheid
Typen
ClearDataOptions
Opties die bepalen welke gegevens moeten worden gewist door clearData.
Eigenschappen
-
sinds
number optioneel
Wis gegevens die zijn verzameld op of na deze datum, weergegeven in milliseconden sinds het tijdperk (toegankelijk via de getTime-methode van het JavaScript-object
Date). Als deze waarde ontbreekt, is de standaardwaarde0(waardoor alle browsegegevens worden verwijderd).
ClearDataTypeSet
Een set gegevenstypen. Ontbrekende property's worden geïnterpreteerd als false.
Eigenschappen
-
appcache
booleaans optioneel
Appcaches van websites.
-
cachegeheugen
booleaans optioneel
Chrome 44+Sinds Chrome 43. Het cachegeheugen van de browser. Opmerking: Als je gegevens verwijdert, wordt het hele cachegeheugen gewist. Dit is niet beperkt tot de periode die je invoert.
-
cookies
booleaans optioneel
De cookies van de partitie.
-
fileSystems
booleaans optioneel
Bestandssystemen van websites.
-
indexedDB
booleaans optioneel
IndexedDB-gegevens van websites.
-
localStorage
booleaans optioneel
Gegevens over lokale opslag van websites.
-
persistentCookies
booleaans optioneel
Chrome 58+De permanente cookies van de partitie.
-
sessionCookies
booleaans optioneel
Chrome 58+De sessiecookies van de partitie.
-
webSQL
booleaans optioneel
WebSQL-gegevens van websites.
ContentScriptDetails
Details van het contentscript dat moet worden geïnjecteerd. Ga naar de documentatie over contentscripts voor meer informatie.
Eigenschappen
-
all_frames
booleaans optioneel
Als
all_framestrueis, betekent dit dat de JavaScript of CSS moet worden geïnjecteerd in alle frames van de huidige pagina. Standaard isall_framesfalseen 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 moeten worden geïnjecteerd in overeenkomende pagina's. Deze worden geïnjecteerd in de volgorde waarin ze verschijnen, voordat er een DOM wordt samengesteld of getoond voor de pagina.
-
exclude_globs
string[] optioneel
Toegepast na overeenkomsten om URL's uit te sluiten die overeenkomen met deze glob. Bedoeld om het Greasemonkey-zoekwoord @exclude na te bootsen.
-
exclude_matches
string[] optioneel
Sluit pagina's uit waarin dit contentscript anders zou worden geïnjecteerd.
-
include_globs
string[] optioneel
Wordt toegepast na overeenkomsten om alleen de URL's op te nemen die ook overeenkomen met deze glob. Bedoeld om het Greasemonkey-sleutelwoord @include na te bootsen.
-
js
InjectionItems optioneel
De JavaScript-code of een lijst met JavaScript-bestanden die moeten worden geïnjecteerd in overeenkomende pagina's. Deze worden geïnjecteerd in de volgorde waarin ze verschijnen.
-
match_about_blank
booleaans optioneel
Of het contentscript moet worden ingevoegd op about:blank en about:srcdoc. Contentscripts worden alleen op pagina's geïnjecteerd als de overgenomen URL overeenkomt met een van de gedefinieerde patronen in het veld matches. De overgenomen URL is de URL van het document dat het frame of venster heeft gemaakt. Contentscripts kunnen niet worden ingevoegd in sandboxed frames.
-
komt overeen
tekenreeks[]
Geeft aan op welke pagina's dit contentscript wordt geïnjecteerd.
-
name
tekenreeks
De naam van het contentscript dat moet worden geïnjecteerd.
-
run_at
RunAt optioneel
Het vroegste moment waarop de JavaScript of CSS in het tabblad wordt geïnjecteerd. De standaardwaarde is document_idle.
ContentWindow
Berichtgreep naar een gastvenster.
Eigenschappen
-
postMessage
ongeldig
Post een bericht naar de ingesloten webcontent zolang de ingesloten content een pagina van de doelbron toont. Deze methode is beschikbaar nadat de pagina is geladen. Luister naar de gebeurtenis
contentloaden roep de methode aan.De gast kan antwoorden naar de insluiter sturen door een bericht te posten naar
event.sourcein de berichtgebeurtenis die de gast krijgt.Deze API is identiek aan de HTML5 postMessage API voor communicatie tussen webpagina's. De insluiter kan luisteren naar antwoorden door een
message-gebeurtenislistener toe te voegen aan het eigen frame.De functie
postMessageziet er zo uit:(message: any, targetOrigin: string) => {...}
-
bericht
alle
Berichtobject dat naar de gast moet worden gestuurd.
-
targetOrigin
tekenreeks
Hiermee geef je aan wat de oorsprong van het gastvenster moet zijn om de gebeurtenis te verzenden.
-
ContextMenuCreateProperties
Eigenschappen
-
aangevinkt
booleaans optioneel
De beginstatus van een selectievakje of keuzerondje: true voor geselecteerd en false voor niet geselecteerd. Er kan maar één keuzerondje tegelijk worden geselecteerd in een bepaalde groep keuzerondjes.
-
contexten
[ContextType, ...ContextType[]] optioneel
Lijst met contexten waarin dit menu-item verschijnt. De standaardwaarde is ['page'] als deze niet wordt aangegeven.
-
documentUrlPatterns
string[] optioneel
Hiermee kun je het item beperken tot documenten waarvan de URL overeenkomt met een van de opgegeven patronen. (Dit geldt ook voor frames.) Ga naar Overeenkomstpatronen voor meer informatie over de indeling van een patroon.
-
aangezet
booleaans optioneel
Of dit contextmenu-item aan- of uitstaat. De standaardwaarde is
true. -
id
tekenreeks 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.
-
parentId
tekenreeks | getal optioneel
De ID van een bovenliggend menu-item. Hiermee wordt het item een onderliggend item van een eerder toegevoegd item.
-
targetUrlPatterns
string[] optioneel
Vergelijkbaar met documentUrlPatterns, maar hiermee kun je filteren op basis van het kenmerk
srcvan img-/audio-/videotags en dehrefvan ankertags. -
titel
tekenreeks optioneel
De tekst die in het item moet worden getoond. Dit is vereist, tenzij
type'separator' is. Als de context 'selectie' is, kun je%sgebruiken in de tekenreeks om de geselecteerde tekst te tonen. 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. De standaardwaarde is 'normal' als deze niet wordt aangegeven.
-
onclick
void optioneel
Een functie die wordt teruggeroepen als er op het menu-item wordt geklikt.
De functie
onclickziet er zo uit:(info: OnClickData) => {...}
-
info
Informatie over het item waarop is geklikt en de context waarin de klik heeft plaatsgevonden.
-
ContextMenus
Eigenschappen
-
onShow
Event<functionvoidvoid>
Wordt geactiveerd voordat een contextmenu wordt getoond op deze
webview. Kan worden gebruikt om dit contextmenu uit te zetten doorevent.preventDefault()aan te roepen.De functie
onShow.addListenerziet er zo uit:(callback: function) => {...}
-
callback
functie
De parameter
callbackziet er zo uit:(event: object) => void
-
gebeurtenis
object
-
preventDefault
ongeldig
Roep dit aan om te voorkomen dat het contextmenu wordt getoond.
De functie
preventDefaultziet er zo uit:() => {...}
-
-
-
-
create
ongeldig
Maakt een nieuw contextmenu-item. Als er een fout optreedt tijdens het maken, komt u er misschien pas achter als de callback voor maken wordt geactiveerd (de details staan in
runtime.lastError).De functie
createziet er zo uit:(createProperties: object, callback?: function) => {...}
-
createProperties
object
De property's die zijn gebruikt om het item te maken
-
callback
functie optioneel
De parameter
callbackziet er zo uit:() => void
-
returns
tekenreeks | getal
De ID van het nieuwe item.
-
-
verwijderen
ongeldig
Verwijdert een contextmenu-item.
De functie
removeziet er zo uit:(menuItemId: string | number, callback?: function) => {...}
-
tekenreeks | getal
De ID van het contextmenu-item dat je wilt verwijderen.
-
callback
functie optioneel
De parameter
callbackziet er zo uit:() => void
-
-
removeAll
ongeldig
Verwijdert alle contextmenu-items die aan deze
webviewzijn toegevoegd.De functie
removeAllziet er zo uit:(callback?: function) => {...}
-
callback
functie optioneel
De parameter
callbackziet er zo uit:() => void
-
-
update
ongeldig
Updatet een eerder gemaakt contextmenu-item.
De functie
updateziet er zo uit:(id: string | number, updateProperties: object, callback?: function) => {...}
-
id
tekenreeks | getal
De ID van het item dat je wilt updaten.
-
updateProperties
object
De eigenschappen die je wilt updaten. Accepteert dezelfde waarden als de functie create.
-
callback
functie optioneel
De parameter
callbackziet er zo uit:() => void
-
ContextMenuUpdateProperties
Eigenschappen
-
aangevinkt
booleaans optioneel
De status van een selectievakje of keuzerondje: waar voor geselecteerd en onwaar voor niet geselecteerd. Er kan maar één keuzerondje tegelijk worden geselecteerd in een bepaalde groep keuzerondjes.
-
contexten
[ContextType, ...ContextType[]] optioneel
Lijst met contexten waarin dit menu-item verschijnt.
-
documentUrlPatterns
string[] optioneel
Hiermee kun je het item beperken tot documenten waarvan de URL overeenkomt met een van de opgegeven patronen. (Dit geldt ook voor frames.) Ga naar Overeenkomstpatronen voor meer informatie over de indeling van een patroon.
-
aangezet
booleaans optioneel
Of dit contextmenu-item aan- of uitstaat.
-
parentId
tekenreeks | getal optioneel
De ID van een bovenliggend menu-item. Hiermee wordt het item een onderliggend item van een eerder toegevoegd item. Opmerking: Je kunt een item niet wijzigen in een onderliggend item van een van de eigen onderliggende items.
-
targetUrlPatterns
string[] optioneel
Vergelijkbaar met documentUrlPatterns, maar hiermee kun je filteren op basis van het kenmerk
srcvan img-/audio-/videotags en dehrefvan ankertags. -
titel
tekenreeks optioneel
De tekst die in het item moet worden getoond
-
type
ItemType optioneel
Het type menu-item.
-
onclick
void optioneel
Een functie die wordt teruggeroepen als er op het menu-item wordt geklikt.
De functie
onclickziet er zo uit:(info: OnClickData) => {...}
-
info
Informatie over het item waarop is geklikt en de context waarin de klik heeft plaatsgevonden.
-
ContextType
De verschillende contexten waarin een menu kan verschijnen. Als je 'all' invoert, is dat gelijk aan de combinatie van alle andere contexten.
Enum
"all"
"page"
"frame"
selectie
"link"
"editable"
"image"
"video"
"audio"
DialogController
Interface gekoppeld aan dialog DOM-gebeurtenissen.
Eigenschappen
-
annuleren
ongeldig
Het dialoogvenster weigeren. Dit is hetzelfde als klikken op Annuleren in een dialoogvenster
confirmofprompt.De functie
cancelziet er zo uit:() => {...} -
ok
ongeldig
Accepteer het dialoogvenster. Komt overeen met klikken op OK in een dialoogvenster
alert,confirmofprompt.De functie
okziet er zo uit:(response?: string) => {...}
-
reactie
tekenreeks optioneel
De reactietekenreeks die aan de gast moet worden verstrekt bij het accepteren van een
prompt-dialoogvenster.
-
DialogMessageType
Het type modaal dialoogvenster dat door de gast is aangevraagd.
Enum
"alert"
"confirm"
"prompt"
DownloadPermissionRequest
Het type request-object dat bij een download permissionrequest DOM-gebeurtenis hoort.
Eigenschappen
-
requestMethod
tekenreeks
Het type HTTP-verzoek (bijv.
GET) dat is gekoppeld aan het downloadverzoek. -
url
tekenreeks
De aangevraagde download-URL.
-
toestaan
ongeldig
Sta het verzoek om rechten toe.
De functie
allowziet er zo uit:() => {...} -
deny
ongeldig
Weiger het verzoek om rechten. Dit is het standaardgedrag als
allowniet wordt aangeroepen.De functie
denyziet er zo uit:() => {...}
ExitReason
Tekenreeks die de reden voor de afsluiting aangeeft.
Enum
"normal"
"abnormal"
"crashed"
'killed'
"oom killed"
"oom"
'kan niet worden gestart'
"integrity failure"
FileSystemPermissionRequest
Het type request-object dat bij een filesystem permissionrequest DOM-gebeurtenis hoort.
Eigenschappen
-
url
tekenreeks
De URL van het frame dat toegang tot het lokale bestandssysteem aanvraagt.
-
toestaan
ongeldig
Sta het verzoek om rechten toe.
De functie
allowziet er zo uit:() => {...} -
deny
ongeldig
Weiger het verzoek om rechten.
De functie
denyziet er zo uit:() => {...}
FindCallbackResults
Bevat alle resultaten van het zoekverzoek.
Eigenschappen
-
activeMatchOrdinal
getal
Het rangtelwoord van de huidige overeenkomst.
-
geannuleerd
booleaans
Geeft aan of dit zoekverzoek is geannuleerd.
-
numberOfMatches
getal
Het aantal keren dat
searchTextis gevonden op de pagina. -
selectionRect
Beschrijft een rechthoek rond de actieve overeenkomst in schermcoördinaten.
FindOptions
Opties voor het zoekverzoek.
Eigenschappen
-
achteruit
booleaans optioneel
Markering om overeenkomsten in omgekeerde volgorde te vinden. De standaardwaarde is
false. -
matchCase
booleaans optioneel
Markeren om overeen te komen met hoofdlettergevoeligheid. De standaardwaarde is
false.
FullscreenPermissionRequest
Het type request-object dat bij een fullscreen permissionrequest DOM-gebeurtenis hoort.
Eigenschappen
-
oorsprong
tekenreeks
De oorsprong van het frame in de
webviewdie het verzoek voor volledig scherm heeft gestart. -
toestaan
ongeldig
Sta het verzoek om rechten toe.
De functie
allowziet er zo uit:() => {...} -
deny
ongeldig
Weiger het verzoek om rechten.
De functie
denyziet er zo uit:() => {...}
GeolocationPermissionRequest
Het type request-object dat bij een geolocation permissionrequest DOM-gebeurtenis hoort.
Eigenschappen
-
url
tekenreeks
De URL van het frame dat toegang tot geolocatiegegevens aanvraagt.
-
toestaan
ongeldig
Sta het verzoek om rechten toe.
De functie
allowziet er zo uit:() => {...} -
deny
ongeldig
Weiger het verzoek om rechten. Dit is het standaardgedrag als
allowniet wordt aangeroepen.De functie
denyziet er zo uit:() => {...}
HidPermissionRequest
Het type request-object dat bij een hid permissionrequest DOM-gebeurtenis hoort.
Eigenschappen
-
url
tekenreeks
De URL van het frame dat toegang vraagt tot de HID API.
-
toestaan
ongeldig
Sta het verzoek om rechten toe.
De functie
allowziet er zo uit:() => {...} -
deny
ongeldig
Weiger het verzoek om rechten. Dit is het standaardgedrag als
allowniet wordt aangeroepen.De functie
denyziet er zo 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 die moet worden geïnjecteerd.
Waarschuwing: Wees voorzichtig met de parameter
code. Onjuist gebruik kan je app blootstellen aan 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 moet worden geïnjecteerd in overeenkomende pagina's.
-
bestanden
string[] optioneel
De lijst met JavaScript- of CSS-bestanden die moeten worden geïnjecteerd in overeenkomende pagina's. Deze worden geïnjecteerd in de volgorde waarin ze in deze array verschijnen.
LoadAbortReason
Tekenreeks die aangeeft welk type afbreking heeft plaatsgevonden. We kunnen niet garanderen dat deze tekenreeks compatibel blijft met eerdere versies. U mag de content niet parseren en er niet op basis van handelen. Het is ook mogelijk dat er in sommige gevallen een fout wordt gerapporteerd die hier niet wordt vermeld.
Enum
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"
LoadPluginPermissionRequest
Het type request-object dat bij een loadplugin permissionrequest DOM-gebeurtenis hoort.
Eigenschappen
-
identifier
tekenreeks
De ID-tekenreeks van de plug-in.
-
name
tekenreeks
De weergavenaam van de plug-in.
-
toestaan
ongeldig
Sta het verzoek om rechten toe. Dit is het standaardgedrag als
denyniet wordt aangeroepen.De functie
allowziet er zo uit:() => {...} -
deny
ongeldig
Weiger het verzoek om rechten.
De functie
denyziet er zo uit:() => {...}
MediaPermissionRequest
Het type request-object dat bij een media permissionrequest DOM-gebeurtenis hoort.
Eigenschappen
-
url
tekenreeks
De URL van het frame dat toegang tot gebruikersmedia vraagt.
-
toestaan
ongeldig
Sta het verzoek om rechten toe.
De functie
allowziet er zo uit:() => {...} -
deny
ongeldig
Weiger het verzoek om rechten. Dit is het standaardgedrag als
allowniet wordt aangeroepen.De functie
denyziet er zo uit:() => {...}
NewWindow
Interface gekoppeld aan newwindow DOM-gebeurtenissen.
Eigenschappen
-
bijvoegen
ongeldig
Koppel de gevraagde doelpagina aan een bestaand
webview-element.De functie
attachziet er zo uit:(webview: object) => {...}
-
webview
object
Het element
webviewwaaraan de doelpagina moet worden gekoppeld.
-
-
verwijderen
ongeldig
Annuleer het verzoek voor een nieuw venster.
De functie
discardziet er zo uit:() => {...}
PermissionType
Het type recht dat wordt aangevraagd.
Enum
"media"
"geolocation"
pointerLock
"download"
"loadplugin"
"filesystem"
"fullscreen"
hid
PointerLockPermissionRequest
Het type request-object dat bij een pointerLock permissionrequest DOM-gebeurtenis hoort.
Eigenschappen
-
lastUnlockedBySelf
booleaans
Of het aanvragende frame de meest recente client was die de aanwijzervergrendeling had.
-
url
tekenreeks
De URL van het frame dat cursorvergrendeling aanvraagt.
-
userGesture
booleaans
Of de aanwijzervergrendeling is aangevraagd als gevolg van een invoergebaar van de gebruiker.
-
toestaan
ongeldig
Sta het verzoek om rechten toe.
De functie
allowziet er zo uit:() => {...} -
deny
ongeldig
Weiger het verzoek om rechten. Dit is het standaardgedrag als
allowniet wordt aangeroepen.De functie
denyziet er zo uit:() => {...}
SelectionRect
Beschrijft een rechthoek in schermcoördinaten.
De semantiek van de insluiting is vergelijkbaar met een matrix. Dat wil zeggen dat de coördinaat (left, top) wordt beschouwd als ingesloten door de rechthoek, maar de coördinaat (left + width, top) niet.
Eigenschappen
-
hoogte
getal
Hoogte van de rechthoek.
-
links
getal
Afstand van de linkerrand van het scherm tot de linkerrand van de rechthoek.
-
boven
getal
De afstand van de bovenrand van het scherm tot de bovenrand van de rechthoek.
-
breedte
getal
Breedte van de rechthoek.
StopFindingAction
Bepaalt wat er met de actieve overeenkomst moet gebeuren nadat de zoeksessie is beëindigd. clear wist de markering van de actieve overeenkomst, keep houdt de actieve overeenkomst gemarkeerd en activate houdt de actieve overeenkomst gemarkeerd en simuleert een gebruikersklik op die overeenkomst. De standaardactie is keep.
Enum
'clear'
"keep"
activeren
WebRequestEventInterface
Interface die toegang biedt tot webRequest-gebeurtenissen op de gastpagina. Ga naar de API voor de extensie chrome.webRequest voor meer informatie over de levenscyclus van webRequest en gerelateerde concepten. Opmerking: De gebeurtenis chrome.webRequest.onActionIgnored wordt niet ondersteund voor webweergaven.
De volgende voorbeeldcode blokkeert alle gastverzoeken voor URL's die overeenkomen met *://www.evil.com/*. Hieraan kun je zien hoe het gebruik verschilt van de webRequest API voor extensies:
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. Ga naar declarativeWebRequest voor API-informatie.
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" 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 indeling van het nieuwe venster.
Enum
"ignore"
"save_to_disk"
"current_tab"
"new_background_tab"
"new_foreground_tab"
"new_window"
"new_popup"
ZoomMode
Bepaalt hoe zoomen wordt afgehandeld in de webview.
Enum
per-origin
Zoomwijzigingen blijven behouden in de oorsprong van de ingezoomde pagina, d.w.z. alle andere webweergaven in dezelfde partitie die naar dezelfde oorsprong worden genavigeerd, worden ook ingezoomd. Bovendien worden per-origin zoomwijzigingen opgeslagen met de oorsprong. Dit betekent dat als je naar andere pagina's met dezelfde oorsprong navigeert, ze allemaal worden gezoomd met dezelfde zoomfactor.
per-view
Zoomwijzigingen worden alleen van kracht in deze webweergave en zoomwijzigingen in andere webweergaven hebben geen invloed op het zoomen van deze webweergave. Ook worden per-view zoomwijzigingen gereset bij navigatie. Als je door een webweergave navigeert, worden pagina's altijd geladen met de zoomfactoren per oorsprong (binnen het bereik van de partitie).
"disabled"
Zet alle zoomfuncties in de webweergave uit. De content wordt teruggezet naar het standaard zoomniveau en alle pogingen om het zoomniveau te wijzigen, worden genegeerd.
Eigenschappen
contentWindow
Objectreferentie die kan worden gebruikt om berichten op de gastpagina te posten.
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 webview. Je kunt kiezen op welke typen objecten je 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 injectie van contentscripts toe aan de webview. Als de webview naar een pagina gaat die overeenkomt met een of meer regels, worden de bijbehorende scripts geïnjecteerd. Je kunt programmatisch regels toevoegen of bestaande regels updaten.
In het volgende voorbeeld worden 2 regels toegevoegd 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 addContentScripts uitstellen totdat je scripts moet injecteren.
In het volgende voorbeeld ziet u 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 is genavigeerd (bijvoorbeeld foo.com) en webview.addContentScripts aanroept om 'myRule' toe te voegen, moet je wachten op de volgende navigatie om de scripts te injecteren. Als je een onmiddellijke injectie wilt, doet executeScript het juiste.
Regels blijven behouden, zelfs als het gastproces crasht of wordt beëindigd, of als de webview een nieuwe bovenliggende map krijgt.
Ga naar de documentatie over contentscripts voor meer informatie.
Parameters
-
contentScriptList
Details van de contentscripts die je wilt toevoegen.
back()
chrome.webviewTag.back(
callback?: function,
): void
Navigeert indien mogelijk één geschiedenisitem terug. Gelijk aan go(-1).
Parameters
-
callback
functie optioneel
Chrome 44+De parameter
callbackziet er zo uit:(success: boolean) => void
-
geslaagd
booleaans
Geeft aan of de navigatie is geslaagd.
-
canGoBack()
chrome.webviewTag.canGoBack(): boolean
Geeft aan of het mogelijk is om terug te navigeren door de geschiedenis. De status van deze functie wordt gecachet en geüpdatet vóór elke loadcommit. De beste plek om deze aan te roepen is dus op loadcommit.
Retourzendingen
-
booleaans
canGoForward()
chrome.webviewTag.canGoForward(): boolean
Geeft aan of het mogelijk is om vooruit te navigeren door de geschiedenis. De status van deze functie wordt gecachet en geüpdatet vóór elke loadcommit. De beste plek om deze aan te roepen is dus op loadcommit.
Retourzendingen
-
booleaans
captureVisibleRegion()
chrome.webviewTag.captureVisibleRegion(
options?: ImageDetails,
callback: function,
): void
Legt het zichtbare gebied van de webweergave vast.
Parameters
-
opties
ImageDetails optioneel
-
callback
functie
De parameter
callbackziet er zo uit:(dataUrl: string) => void
-
dataUrl
tekenreeks
Een gegevens-URL die een afbeelding van het zichtbare gebied van het vastgelegde tabblad codeert. Kan worden toegewezen aan de eigenschap 'src' van een HTML-afbeeldingselement voor weergave.
-
clearData()
chrome.webviewTag.clearData(
options: ClearDataOptions,
types: ClearDataTypeSet,
callback?: function,
): void
Wist browsegegevens voor de partitie webview.
Parameters
-
opties
Opties die bepalen welke gegevens moeten worden gewist.
-
typen
De typen gegevens die moeten worden gewist.
-
callback
functie optioneel
De parameter
callbackziet er zo uit:() => void
executeScript()
chrome.webviewTag.executeScript(
details: InjectDetails,
callback?: function,
): void
Injecteert JavaScript-code in de gastpagina.
De volgende voorbeeldcode gebruikt 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 script dat moet worden uitgevoerd.
-
callback
functie optioneel
De parameter
callbackziet er zo 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 verzoek voor zoeken op pagina.
Parameters
-
searchText
tekenreeks
De tekenreeks die je op de pagina wilt vinden.
-
opties
FindOptions optioneel
Opties voor het zoekverzoek.
-
callback
functie optioneel
De parameter
callbackziet er zo uit:(results?: FindCallbackResults) => void
-
resultaten
FindCallbackResults optioneel
Bevat alle resultaten van het zoekverzoek.
resultskan worden weggelaten als deze niet wordt gebruikt in de hoofdtekst van de callbackfunctie, bijvoorbeeld als de callback alleen wordt gebruikt om te bepalen wanneer het zoekverzoek is afgerond.
-
forward()
chrome.webviewTag.forward(
callback?: function,
): void
Gaat indien mogelijk één geschiedenisitem vooruit. Gelijk aan go(1).
Parameters
-
callback
functie optioneel
Chrome 44+De parameter
callbackziet er zo uit:(success: boolean) => void
-
geslaagd
booleaans
Geeft aan of de navigatie is geslaagd.
-
getAudioState()
chrome.webviewTag.getAudioState(
callback: function,
): void
Vraagt de audiostatus op.
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:(audible: boolean) => void
-
audible
booleaans
-
getProcessId()
chrome.webviewTag.getProcessId(): number
Retourneert de interne proces-ID van Chrome voor het huidige proces van de webpagina van de gast, zodat insluiters weten hoeveel gasten worden beïnvloed als het proces wordt beëindigd. 2 gasten delen alleen een proces als ze bij dezelfde app horen en dezelfde ID voor opslagpartitie hebben. De aanroep is synchroon en retourneert het gecachte idee van de insluiter van de huidige proces-ID. De proces-ID is niet hetzelfde als de proces-ID van het besturingssysteem.
Retourzendingen
-
getal
getUserAgent()
chrome.webviewTag.getUserAgent(): string
Retourneert de tekenreeks voor de user-agent die de webview gebruikt voor paginaverzoeken van gasten.
Retourzendingen
-
tekenreeks
getZoom()
chrome.webviewTag.getZoom(
callback: function,
): void
Haalt de huidige zoomfactor op.
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:(zoomFactor: number) => void
-
zoomFactor
getal
De huidige zoomfactor.
-
getZoomMode()
chrome.webviewTag.getZoomMode(
callback: function,
): void
Haalt de huidige zoommodus op.
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:(ZoomMode: ZoomMode) => void
-
ZoomMode
De huidige zoommodus van de
webview.
-
go()
chrome.webviewTag.go(
relativeIndex: number,
callback?: function,
): void
Navigeert naar een geschiedenisitem met een geschiedenisindex die relatief is aan de huidige navigatie. Als de gevraagde navigatie onmogelijk is, heeft deze methode geen effect.
Parameters
-
relativeIndex
getal
Relatieve geschiedenisindex waarnaar de
webviewmoet worden genavigeerd. Een waarde van2navigeert bijvoorbeeld 2 geschiedenisitems vooruit als dat mogelijk is. Een waarde van-3navigeert 3 items terug. -
callback
functie optioneel
De parameter
callbackziet er zo uit:(success: boolean) => void
-
geslaagd
booleaans
Geeft aan of de navigatie is geslaagd.
-
insertCSS()
chrome.webviewTag.insertCSS(
details: InjectDetails,
callback?: function,
): void
Injecteert CSS in de gastpagina.
Parameters
-
details
Details van de CSS die u wilt invoegen.
-
callback
functie optioneel
De parameter
callbackziet er zo uit:() => void
isAudioMuted()
chrome.webviewTag.isAudioMuted(
callback: function,
): void
Vraagt of de audio is gedempt.
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:(muted: boolean) => void
-
gedempt
booleaans
-
isSpatialNavigationEnabled()
chrome.webviewTag.isSpatialNavigationEnabled(
callback: function,
): void
Vraagt of ruimtelijke navigatie aanstaat voor de webweergave.
Parameters
-
functie
De parameter
callbackziet er zo uit:(enabled: boolean) => void
-
booleaans
-
isUserAgentOverridden()
chrome.webviewTag.isUserAgentOverridden(): void
Geeft aan of de user-agent-tekenreeks van de webview is overschreven door webviewTag.setUserAgentOverride.
loadDataWithBaseUrl()
chrome.webviewTag.loadDataWithBaseUrl(
dataUrl: string,
baseUrl: string,
virtualUrl?: string,
): void
Laadt een gegevens-URL met een opgegeven basis-URL die wordt gebruikt voor relatieve links. Je kunt ook een virtuele URL invoeren die aan de gebruiker wordt getoond in plaats van de gegevens-URL.
Parameters
-
dataUrl
tekenreeks
De gegevens-URL die moet worden geladen.
-
baseUrl
tekenreeks
De basis-URL die wordt gebruikt voor relatieve links.
-
virtualUrl
tekenreeks optioneel
De URL die aan de gebruiker wordt getoond (in de adresbalk).
print()
chrome.webviewTag.print(): void
Drukt de content van de webview af. Dit is hetzelfde als de gescripte afdrukfunctie aanroepen vanuit de webview zelf.
reload()
chrome.webviewTag.reload(): void
Laadt de huidige pagina op het hoogste niveau opnieuw.
removeContentScripts()
chrome.webviewTag.removeContentScripts(
scriptNameList?: string[],
): void
Verwijdert contentscripts uit een webview.
In het volgende voorbeeld wordt 'myRule' verwijderd, die eerder is toegevoegd.
webview.removeContentScripts(['myRule']);
U kunt alle regels verwijderen door het volgende aan te roepen:
webview.removeContentScripts();
Parameters
-
scriptNameList
string[] optioneel
Een lijst met namen van contentscripts die worden verwijderd. Als de lijst leeg is, worden alle contentscripts die aan de
webviewzijn toegevoegd, verwijderd.
setAudioMuted()
chrome.webviewTag.setAudioMuted(
mute: boolean,
): void
Stelt de dempingsstatus van de webweergave in.
Parameters
-
geluid uitzetten
booleaans
Waarde voor audio dempen
setSpatialNavigationEnabled()
chrome.webviewTag.setSpatialNavigationEnabled(
enabled: boolean,
): void
Stelt de status van ruimtelijke navigatie van de webweergave in.
Parameters
-
booleaans
Statuswaarde voor ruimtelijke navigatie.
setUserAgentOverride()
chrome.webviewTag.setUserAgentOverride(
userAgent: string,
): void
De tekenreeks voor de user-agent overschrijven die de webview gebruikt voor verzoeken voor gastpagina's. Als je de instelling overschrijft, zijn de waarden van de User-Agent Client Hint-header en de waarden die worden geretourneerd door navigator.userAgentData leeg voor verzoeken voor gastpagina's waarop deze overschrijving wordt toegepast.
Parameters
-
userAgent
tekenreeks
De tekenreeks van de user-agent die je wilt gebruiken.
setZoom()
chrome.webviewTag.setZoom(
zoomFactor: number,
callback?: function,
): void
Hiermee wijzig je de zoomfactor van de pagina. Het bereik en de persistentie van deze wijziging worden bepaald door de huidige zoommodus van de webweergave (zie webviewTag.ZoomMode).
Parameters
-
zoomFactor
getal
De nieuwe zoomfactor.
-
callback
functie optioneel
De parameter
callbackziet er zo uit:() => void
setZoomMode()
chrome.webviewTag.setZoomMode(
ZoomMode: ZoomMode,
callback?: function,
): void
Hiermee stel je de zoommodus van de webview in.
Parameters
-
ZoomMode
Bepaalt hoe zoomen wordt afgehandeld in de
webview. -
callback
functie optioneel
De parameter
callbackziet er zo 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 (alle markeringen worden gewist) en annuleert alle lopende zoekverzoeken.
Parameters
-
actie
StopFindingAction optioneel
Bepaalt wat er met de actieve overeenkomst moet gebeuren nadat de zoeksessie is beëindigd.
clearwist de markering van de actieve overeenkomst,keephoudt de actieve overeenkomst gemarkeerd enactivatehoudt de actieve overeenkomst gemarkeerd en simuleert een gebruikersklik op die overeenkomst. De standaardactie iskeep.
terminate()
chrome.webviewTag.terminate(): void
Beëindigt het renderingproces van de webpagina voor gasten geforceerd. 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 als het gastvenster zichzelf probeert te sluiten.
In de volgende voorbeeldcode wordt de webview naar about:blank genavigeerd als de gast zichzelf probeert te sluiten.
webview.addEventListener('close', function() {
webview.src = 'about:blank';
});
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:() => void
consolemessage
chrome.webviewTag.consolemessage.addListener(
callback: function,
)
Wordt geactiveerd als het gastvenster een consolebericht registreert.
De volgende voorbeeldcode stuurt alle logboekberichten door naar de console van de insluiter, ongeacht het logboekniveau of andere eigenschappen.
webview.addEventListener('consolemessage', function(e) {
console.log('Guest page logged a message: ', e.message);
});
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:(level: number, message: string, line: number, sourceId: string) => void
-
level
getal
-
bericht
tekenreeks
-
lijn
getal
-
sourceId
tekenreeks
-
contentload
chrome.webviewTag.contentload.addListener(
callback: function,
)
Wordt geactiveerd als het gastvenster een load-gebeurtenis activeert, d.w.z. als er een nieuw document wordt geladen. Dit omvat niet paginanavigatie binnen het huidige document of asynchrone resourceladingen.
De volgende voorbeeldcode wijzigt de standaard lettergrootte van het element body van de gast nadat de pagina is geladen:
webview.addEventListener('contentload', function() {
webview.executeScript({ code: 'document.body.style.fontSize = "42px"' });
});
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:() => void
dialog
chrome.webviewTag.dialog.addListener(
callback: function,
)
Wordt geactiveerd als het gastvenster een modaal dialoogvenster probeert te openen via window.alert, window.confirm of window.prompt.
Als deze gebeurtenis wordt verwerkt, wordt het gastproces geblokkeerd totdat elke gebeurtenislistener terugkeert of het object dialog onbereikbaar wordt (als preventDefault() is aangeroepen).
Het standaardgedrag is het dialoogvenster annuleren.
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:(messageType: DialogMessageType, messageText: string, dialog: DialogController) => void
-
messageType
-
messageText
tekenreeks
-
dialoogvenster
-
exit
chrome.webviewTag.exit.addListener(
callback: function,
)
Wordt geactiveerd als het proces dat de webcontent van de gast weergeeft, is beëindigd.
De volgende voorbeeldcode toont een afscheidsbericht als de gastpagina crasht:
webview.addEventListener('exit', function(e) {
if (e.reason === 'crash') {
webview.src = 'data:text/plain,Goodbye, world!';
}
});
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:(details: object) => void
-
details
object
-
processID
getal
De interne ID van Chrome voor het proces dat is afgesloten.
-
reden
Tekenreeks die de reden voor de afsluiting aangeeft.
-
-
findupdate
chrome.webviewTag.findupdate.addListener(
callback: function,
)
Wordt geactiveerd als er nieuwe zoekresultaten beschikbaar zijn voor een actief zoekverzoek. Dit kan meerdere keren gebeuren voor één zoekverzoek als er overeenkomsten worden gevonden.
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:(searchText: string, numberOfMatches: number, activeMatchOrdinal: number, selectionRect: SelectionRect, canceled: boolean, finalUpdate: string) => void
-
searchText
tekenreeks
-
numberOfMatches
getal
-
activeMatchOrdinal
getal
-
selectionRect
-
geannuleerd
booleaans
-
finalUpdate
tekenreeks
-
loadabort
chrome.webviewTag.loadabort.addListener(
callback: function,
)
Wordt geactiveerd als een load op het hoogste niveau is afgebroken zonder te worden vastgelegd. Er wordt een foutmelding afgedrukt in de console, tenzij de gebeurtenis standaard wordt voorkomen.
Opmerking: Als het laden van een bron wordt afgebroken, wordt een loadabort-gebeurtenis uiteindelijk gevolgd door een loadstop-gebeurtenis, zelfs als alle vastgelegde laadacties sinds de laatste loadstop-gebeurtenis (indien van toepassing) zijn afgebroken.
Opmerking: Als het laden van een about-URL of een JavaScript-URL wordt afgebroken, wordt loadabort geactiveerd en wordt de webview naar about:blank genavigeerd.
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:(url: string, isTopLevel: boolean, code: number, reason: LoadAbortReason) => void
-
url
tekenreeks
-
isTopLevel
booleaans
-
code
getal
-
reden
-
loadcommit
chrome.webviewTag.loadcommit.addListener(
callback: function,
)
Geactiveerd wanneer een lading is vastgelegd. Dit omvat navigatie binnen het huidige document en het laden van documenten op subframeniveau, maar niet het laden van asynchrone bronnen.
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:(url: string, isTopLevel: boolean) => void
-
url
tekenreeks
-
isTopLevel
booleaans
-
loadredirect
chrome.webviewTag.loadredirect.addListener(
callback: function,
)
Wordt geactiveerd als een laadverzoek op het hoogste niveau is omgeleid naar een andere URL.
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:(oldUrl: string, newUrl: string, isTopLevel: boolean) => void
-
oldUrl
tekenreeks
-
newUrl
tekenreeks
-
isTopLevel
booleaans
-
loadstart
chrome.webviewTag.loadstart.addListener(
callback: function,
)
Wordt geactiveerd als het laden is begonnen.
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:(url: string, isTopLevel: boolean) => void
-
url
tekenreeks
-
isTopLevel
booleaans
-
loadstop
chrome.webviewTag.loadstop.addListener(
callback: function,
)
Wordt geactiveerd als alle laadprocessen op frameniveau op een gastpagina (inclusief alle subframes) zijn afgerond. Dit omvat navigatie binnen het huidige document en het laden van documenten op subframeniveau, maar niet het laden van asynchrone bronnen. Deze gebeurtenis wordt elke keer geactiveerd als het aantal laadacties op documentniveau overgaat van 1 (of meer) naar 0. Als een pagina die al is geladen (bijvoorbeeld loadstop is al een keer geactiveerd) maakt een nieuw iframe dat een pagina laadt. Daarna wordt een tweede loadstop geactiveerd als de iframe-pagina is geladen. Dit patroon wordt vaak waargenomen op pagina's die advertenties laden.
Opmerking: Als een vastgelegde belasting wordt afgebroken, volgt een loadstop-gebeurtenis uiteindelijk op een loadabort-gebeurtenis, zelfs als alle vastgelegde belastingen sinds de laatste loadstop-gebeurtenis (indien van toepassing) zijn afgebroken.
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:() => void
newwindow
chrome.webviewTag.newwindow.addListener(
callback: function,
)
Wordt geactiveerd als de gastpagina probeert een nieuw browservenster te openen.
Met de volgende voorbeeldcode wordt een nieuwe webview gemaakt en genavigeerd in de insluiter voor elk aangevraagd nieuw venster:
webview.addEventListener('newwindow', function(e) {
var newWebview = document.createElement('webview');
document.body.appendChild(newWebview);
e.window.attach(newWebview);
});
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:(window: NewWindow, targetUrl: string, initialWidth: number, initialHeight: number, name: string, windowOpenDisposition: WindowOpenDisposition) => void
-
venster
-
targetUrl
tekenreeks
-
initialWidth
getal
-
initialHeight
getal
-
name
tekenreeks
-
windowOpenDisposition
-
permissionrequest
chrome.webviewTag.permissionrequest.addListener(
callback: function,
)
Wordt geactiveerd als de gastpagina speciale rechten moet aanvragen bij de insluiter.
De volgende voorbeeldcode geeft de gastpagina toegang tot de webkitGetUserMedia API. Een app die deze voorbeeldcode gebruikt, moet zelf de manifestrechten audioCapture en/of videoCapture specificeren:
webview.addEventListener('permissionrequest', function(e) {
if (e.permission === 'media') {
e.request.allow();
}
});
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:(permission: PermissionType, request: object) => void
-
toestemming
-
verzoek
object
-
responsive
chrome.webviewTag.responsive.addListener(
callback: function,
)
Wordt geactiveerd als het proces dat de webcontent van de gast weergeeft, weer reageert nadat het niet meer reageerde.
De volgende voorbeeldcode laat het element webview in- of uitfaden als het responsief of niet-responsief wordt:
webview.style.webkitTransition = 'opacity 250ms';
webview.addEventListener('unresponsive', function() {
webview.style.opacity = '0.5';
});
webview.addEventListener('responsive', function() {
webview.style.opacity = '1';
});
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:(processID: number) => void
-
processID
getal
-
sizechanged
chrome.webviewTag.sizechanged.addListener(
callback: function,
)
Wordt geactiveerd als de grootte van de ingesloten webcontent is aangepast via autosize. Wordt alleen geactiveerd als autosize aanstaat.
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:(oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void
-
oldWidth
getal
-
oldHeight
getal
-
newWidth
getal
-
newHeight
getal
-
unresponsive
chrome.webviewTag.unresponsive.addListener(
callback: function,
)
Wordt geactiveerd als het proces dat de webcontent van de gast weergeeft, niet meer reageert. Deze gebeurtenis wordt één keer gegenereerd met een overeenkomende reactiegebeurtenis als de gast weer begint te reageren.
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:(processID: number) => void
-
processID
getal
-
zoomchange
chrome.webviewTag.zoomchange.addListener(
callback: function,
)
Wordt geactiveerd als de zoom van de pagina verandert.
Parameters
-
callback
functie
De parameter
callbackziet er zo uit:(oldZoomFactor: number, newZoomFactor: number) => void
-
oldZoomFactor
getal
-
newZoomFactor
getal
-