refresh date: 2026-09-25 robots: noindex
Description
L'API chrome.extensionTypes contient des déclarations de type pour les extensions Chrome.
Types
ColorArray
Type
[number, number, number, number]
Énumération
"author"
"user"
DeleteInjectionDetails
Informations sur le CSS à supprimer. Vous devez définir la propriété "code" ou "file", mais pas les deux en même temps.
Propriétés
-
allFrames
boolean facultatif
Si allFrames est défini sur
true, cela implique que le CSS doit être supprimé de tous les frames de la page actuelle. Par défaut, il s'agit defalse, et il n'est supprimé que du frame supérieur. SitrueetframeIdsont définis, le code est supprimé du frame sélectionné et de tous ses frames enfants. -
code
chaîne facultatif
Code CSS à supprimer.
-
cssOrigin
CSSOrigin facultatif
Origine du CSS à supprimer. La valeur par défaut est
"author". -
fichier
chaîne facultatif
Fichier CSS à supprimer.
-
frameId
number facultatif
Frame d'où le CSS doit être supprimé. La valeur par défaut est 0 (le frame de niveau supérieur).
-
matchAboutBlank
boolean facultatif
Si matchAboutBlank est défini sur "true", le code est également supprimé des frames about:blank et about:srcdoc si votre extension a accès à son document parent. La valeur par défaut est
false.
DocumentLifecycle
Cycle de vie du document du frame.
Énumération
"prerender"
"active"
"cached"
"pending_deletion"
ExecutionWorld
Environnement JavaScript dans lequel un script doit s'exécuter. Il peut s'agir d'un monde isolé propre à cette extension, du monde principal du DOM partagé avec le code JavaScript de la page ou d'un monde de scripts utilisateur disponible uniquement pour les scripts enregistrés avec l'API User Scripts.
Énumération
"ISOLATED"
"MAIN"
"USER_SCRIPT"
FrameType
Type de frame.
Énumération
"outermost_frame"
"fenced_frame"
"sub_frame"
ImageDataType
Données de pixels d'une image. Doit être un objet ImageData, par exemple à partir d'un élément canvas.
Type
ImageData
ImageDetails
Informations sur le format, la qualité et la zone d'une image.
Propriétés
-
format
ImageFormat facultatif
Format de l'image obtenue. La valeur par défaut est
"jpeg". -
qualité
number facultatif
Lorsque le format est
"jpeg", contrôle la qualité de l'image obtenue. Cette valeur est ignorée pour les images PNG. Plus la qualité est faible, plus l'image obtenue présente d'artefacts visuels et moins elle nécessite d'octets pour être stockée.
ImageFormat
Format d'une image.
Énumération
"jpeg"
"png"
InjectDetails
Détails du script ou du CSS à injecter. Vous devez définir la propriété "code" ou "file", mais pas les deux en même temps.
Propriétés
-
allFrames
boolean facultatif
Si allFrames est défini sur
true, cela implique que le code JavaScript ou CSS doit être injecté dans tous les cadres de la page actuelle. Par défaut, il s'agit defalse, et il n'est injecté que dans le frame supérieur. SitrueetframeIdsont définis, le code est inséré dans le frame sélectionné et tous ses frames enfants. -
code
chaîne facultatif
Code JavaScript ou CSS à injecter.
Avertissement : Soyez prudent lorsque vous utilisez le paramètre
code. Une utilisation incorrecte peut exposer votre extension à des attaques de script intersites. -
cssOrigin
CSSOrigin facultatif
Chrome 66 ou version ultérieureOrigine du CSS à injecter. Cela ne peut être spécifié que pour le CSS, pas pour le JavaScript. La valeur par défaut est
"author". -
fichier
chaîne facultatif
Fichier JavaScript ou CSS à injecter.
-
frameId
number facultatif
Chrome 50 ou version ultérieureFrame dans lequel le script ou le CSS doit être injecté. La valeur par défaut est 0 (le frame de niveau supérieur).
-
matchAboutBlank
boolean facultatif
Si matchAboutBlank est défini sur "true", le code est également injecté dans les frames about:blank et about:srcdoc si votre extension a accès à son document parent. Impossible d'insérer du code dans les frames about: de premier niveau. La valeur par défaut est
false. -
runAt
RunAt facultatif
Délai le plus court avant l'injection du code JavaScript ou CSS dans l'onglet. La valeur par défaut est "document_idle".
RunAt
Délai le plus court avant l'injection du code JavaScript ou CSS dans l'onglet.
Énumération
"document_start"
Le script est injecté après tous les fichiers CSS, mais avant la construction de tout autre DOM ou l'exécution de tout autre script.
"document_end"
Le script est injecté immédiatement après la fin du DOM, mais avant le chargement des sous-ressources telles que les images et les cadres.
"document_idle"
Le navigateur choisit un moment pour injecter le script entre "document_end" et immédiatement après le déclenchement de l'événement window.onload. Le moment exact de l'injection dépend de la complexité du document et de son temps de chargement. Il est optimisé pour la vitesse de chargement de la page. Les scripts de contenu exécutés au niveau de "document_idle" n'ont pas besoin d'écouter l'événement window.onload. Ils sont garantis de s'exécuter une fois le DOM terminé. Si un script doit absolument s'exécuter après window.onload, l'extension peut vérifier si onload a déjà été déclenché à l'aide de la propriété document.readyState.