chrome.extensionTypes

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 code CSS injecté.

Énumération

"author"

"user"

DeleteInjectionDetails

Chrome 87 et versions ultérieures

Détails du CSS à supprimer. Vous devez définir la propriété "code" ou "file", 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, la valeur est false et n'est supprimée 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 facultative

    Code CSS à supprimer.

  • cssOrigin

    CSSOrigin facultatif

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

  • fichier

    chaîne facultative

    Fichier CSS à supprimer.

  • frameId

    number facultatif

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

  • 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 false.

DocumentLifecycle

Chrome 106 et versions ultérieures

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 qui est partagé avec le 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 et versions ultérieures

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

Détails 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. À 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 la propriété "code" ou "file", 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, la valeur est false et n'est injectée 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 facultative

    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 intersite.

  • cssOrigin

    CSSOrigin facultatif

    Chrome 66 et versions ultérieures

    L'origine du CSS à injecter. Cette valeur ne peut être spécifiée que pour le CSS, et non pour JavaScript. La valeur par défaut est "author".

  • fichier

    chaîne facultative

    Fichier JavaScript ou CSS à injecter.

  • frameId

    number facultatif

    Chrome 50 et versions ultérieures

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

  • 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 cadres about:-de premier niveau. Par défaut, il s'agit de false.

  • runAt

    RunAt facultatif

    Date et heure les plus proches auxquelles 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 et heure les plus proches auxquelles 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 d'un autre DOM ou l'exécution d'un 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 des pages. 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.