Beschrijving
De chrome.extensionTypes
API bevat typedeclaraties voor Chrome-extensies.
Soorten
Enum
"auteur" "gebruiker"
DeleteInjectionDetails
Details van de CSS die moet worden verwijderd. De code of de bestandseigenschap moet worden ingesteld, maar beide mogen niet tegelijkertijd worden ingesteld.
Eigenschappen
- alleFrames
Booleaans optioneel
Als allFrames
true
is, betekent dit dat de CSS uit alle frames van de huidige pagina moet worden verwijderd. Standaard is ditfalse
en wordt het alleen uit het bovenste frame verwijderd. Alstrue
enframeId
zijn ingesteld, wordt de code verwijderd uit het geselecteerde frame en alle onderliggende frames. - code
tekenreeks optioneel
CSS-code om te verwijderen.
- cssHerkomst
CSSOrigin optioneel
De oorsprong van de CSS die moet worden verwijderd. Standaard ingesteld op
"author"
. - bestand
tekenreeks optioneel
CSS-bestand om te verwijderen.
- frameId
nummer optioneel
Het frame waaruit de CSS moet worden verwijderd. Standaard ingesteld op 0 (het frame op het hoogste niveau).
- matchOverBlank
Booleaans optioneel
Als matchAboutBlank waar is, wordt de code ook verwijderd uit de frames about:blank en about:srcdoc als uw extensie toegang heeft tot het bovenliggende document. Standaard is dit
false
.
DocumentLifecycle
De documentlevenscyclus van het frame.
Enum
"vooraf renderen" "actief" "gecacht" "In afwachting van verwijdering"
ExecutionWorld
De JavaScript-wereld waarin een script kan worden uitgevoerd. Dit kan een geïsoleerde wereld zijn die uniek is voor deze extensie, de hoofdwereld van de DOM die wordt gedeeld met het JavaScript van de pagina, of een gebruikersscriptwereld die alleen beschikbaar is voor scripts die zijn geregistreerd bij de User Scripts API.
Enum
"GEÏSOLEERD" "VOORNAAMST" "USER_SCRIPT"
FrameType
Het type kozijn.
Enum
"buitenste_frame" "omheind_frame" "subframe"
ImageDetails
Details over het formaat en de kwaliteit van een afbeelding.
Eigenschappen
- formaat
ImageFormat optioneel
Het formaat van de resulterende afbeelding. De standaardinstelling is
"jpeg"
. - kwaliteit
nummer optioneel
Wanneer het formaat
"jpeg"
is, bepaalt dit de kwaliteit van de resulterende afbeelding. Deze waarde wordt genegeerd voor PNG-afbeeldingen. Naarmate de kwaliteit afneemt, zal het resulterende beeld meer visuele artefacten vertonen en zal het aantal bytes dat nodig is om het op te slaan afnemen.
ImageFormat
Het formaat van een afbeelding.
Enum
"jpeg" "png"
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
- alleFrames
Booleaans optioneel
Als allFrames
true
is, betekent dit dat JavaScript of CSS in alle frames van de huidige pagina moet worden geïnjecteerd. Standaard is ditfalse
en wordt het alleen in het bovenframe geïnjecteerd. Alstrue
enframeId
zijn ingesteld, wordt de code ingevoegd in het geselecteerde frame en alle onderliggende frames. - 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 extensie vatbaar zijn voor cross-site scripting- aanvallen - cssHerkomst
CSSOrigin optioneel
Chroom 66+De oorsprong van de CSS om te injecteren. Dit mag alleen worden gespecificeerd voor CSS, niet voor JavaScript. Standaard ingesteld op
"author"
. - bestand
tekenreeks optioneel
JavaScript- of CSS-bestand om te injecteren.
- frameId
nummer optioneel
Chroom 50+Het frame waarin het script of CSS moet worden geïnjecteerd. Standaard ingesteld op 0 (het frame op het hoogste niveau).
- matchOverBlank
Booleaans optioneel
Als matchAboutBlank waar is, wordt de code ook in de frames about:blank en about:srcdoc geïnjecteerd als uw extensie toegang heeft tot het bovenliggende document. Code kan niet op het hoogste niveau worden ingevoegd over:-frames. Standaard is dit
false
. - draaien op
RunAt optioneel
Het snelste dat JavaScript of CSS in het tabblad wordt geïnjecteerd. Standaard ingesteld op "document_idle".
RunAt
Het snelste dat JavaScript of CSS in het tabblad wordt geïnjecteerd.
Enum
"document_start" "document_einde" "document_idle"
Script wordt geïnjecteerd na alle bestanden uit CSS, maar voordat een ander DOM wordt geconstrueerd of een ander script wordt uitgevoerd.
Het script wordt onmiddellijk geïnjecteerd nadat de DOM is voltooid, maar voordat subbronnen zoals afbeeldingen en frames zijn geladen.
De browser kiest een tijdstip om het script te injecteren tussen "document_end" en onmiddellijk nadat de gebeurtenis window.onload
wordt geactiveerd. Het exacte moment van injectie hangt af van hoe complex het document is en hoe lang het duurt om te laden, en is geoptimaliseerd voor de laadsnelheid van de pagina. Inhoudsscripts die worden uitgevoerd op "document_idle" hoeven niet te luisteren naar de gebeurtenis window.onload
; ze zijn gegarandeerd actief nadat de DOM is voltooid. Als een script zeker moet worden uitgevoerd na window.onload
, kan de extensie controleren of onload
al is geactiveerd door de eigenschap document.readyState
te gebruiken.