chrome.extensionTypes

refresh date: 2026-09-25 robots: noindex

Description

L'API chrome.extensionTypes contient des déclarations de type pour les extensions Chrome.

Types

ColorArray

Chrome 139 et versions ultérieures

Type

[number, number, number, number]

CSSOrigin

Chrome 66 et versions ultérieures

L'origine du CSS injecté.

Énumération

"author"

"user"

DeleteInjectionDetails

Chrome 87 et versions ultérieures

Informations sur le CSS à supprimer. Vous devez définir le code ou la propriété du fichier, mais pas les deux en même temps.

Propriétés

  • allFrames

    booléen facultatif

    Si allFrames est défini sur true, cela signifie que le CSS doit être supprimé de tous les cadres de la page actuelle. Par défaut, il est défini sur false et n'est supprimé que du frame supérieur. Si true et frameId sont 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

    L'origine du CSS à supprimer. La valeur par défaut est "author".

  • fichier

    chaîne facultatif

    Fichier CSS à supprimer.

  • frameId

    number facultatif

    Frame à partir duquel le CSS doit être supprimé. La valeur par défaut est 0 (frame de niveau supérieur).

  • matchAboutBlank

    booléen 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. Par défaut, il s'agit de la valeur false.

DocumentLifecycle

Chrome 106 ou version ultérieure

Cycle de vie du document du frame.

Énumération

"prerender"

"active"

"cached"

"pending_deletion"

ExecutionWorld

Chrome 111 et versions ultérieures

Monde 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 qui n'est disponible que pour les scripts enregistrés avec l'API User Scripts.

Énumération

"ISOLATED"

"MAIN"

"USER_SCRIPT"

FrameType

Chrome 106 ou version ultérieure

Type de frame.

Énumération

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

Chrome 139 et versions ultérieures

Données de pixels pour 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 résultante. Cette valeur est ignorée pour les images PNG. À mesure que la qualité diminue, l'image obtenue présente davantage d'artefacts visuels et le nombre d'octets nécessaires pour la stocker diminue.

ImageFormat

Chrome 44 et versions ultérieures

Format d'une image.

Énumération

"jpeg"

"png"

InjectDetails

Détails du script ou du CSS à injecter. Vous devez définir le code ou la propriété du fichier, mais pas les deux en même temps.

Propriétés

  • allFrames

    booléen facultatif

    Si allFrames est défini sur true, cela signifie que le code JavaScript ou CSS doit être injecté dans tous les cadres de la page actuelle. Par défaut, il est défini sur false et n'est injecté que dans le frame supérieur. Si true et frameId sont définis, le code est inséré dans le frame sélectionné et dans 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 rendre votre extension vulnérable aux attaques de script intersites.

  • cssOrigin

    CSSOrigin facultatif

    Chrome 66 et versions ultérieures

    L'origine du CSS à injecter. Cette option ne peut être spécifiée que pour les CSS, et non pour 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érieure

    Le frame dans lequel le script ou le CSS doivent être injectés. La valeur par défaut est 0 (frame de niveau supérieur).

  • matchAboutBlank

    booléen 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. Le code ne peut pas être inséré dans les frames about: de premier niveau. Par défaut, il s'agit de la valeur false.

  • runAt

    RunAt facultatif

    Date à laquelle le code JavaScript ou CSS sera injecté dans l'onglet. La valeur par défaut est "document_idle".

RunAt

Chrome 44 et versions ultérieures

Date à laquelle le code JavaScript ou CSS sera injecté 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 frames.

"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 du temps nécessaire à son chargement. Il est optimisé pour la vitesse de chargement de page. Les scripts de contenu exécutés à "document_idle" n'ont pas besoin d'écouter l'événement window.onload. Ils sont garantis de s'exécuter après la fin du DOM. 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.