chrome.extensionTypes

Description

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

Types

ColorArray

En attente

Type

[nombre, nombre, nombre, nombre]

CSSOrigin

Chrome 66 ou version ultérieure

Origine du CSS injecté.

Énumération

"author"

"user"

DeleteInjectionDetails

Chrome 87 ou version ultérieure

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

Propriétés

  • allFrames

    booléen facultatif

    Si la valeur de "allFrames" est true, cela signifie que le CSS doit être supprimé de tous les cadres de la page actuelle. Par défaut, il s'agit de false et il 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

    Origine du CSS à supprimer. La valeur par défaut est "author".

  • fichier

    chaîne facultatif

    Fichier CSS à supprimer.

  • frameId

    number facultatif

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

  • matchAboutBlank

    booléen facultatif

    Si matchAboutBlank est défini sur "true", le code est également supprimé des cadres 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 ou version ultérieure

Cycle de vie du document du frame.

Énumération

"prerender"

"active"

"cached"

"pending_deletion"

ExecutionWorld

Chrome 111 ou version ultérieure

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

Chrome 106 ou version ultérieure

Type de frame.

Énumération

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

En attente

Données de pixel pour une image. Doit être un objet ImageData, par exemple à partir d'un élément canvas.

Type

ImageData

ImageDetails

Informations sur le format et la qualité 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 comporte davantage d'artefacts visuels, et le nombre d'octets nécessaires pour la stocker diminue.

ImageFormat

Chrome 44 ou version ultérieure

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é de fichier, mais pas les deux en même temps.

Propriétés

  • allFrames

    booléen facultatif

    Si la valeur de "allFrames" est true, cela signifie que le code JavaScript ou CSS doit être injecté dans tous les cadres de la page actuelle. Par défaut, il s'agit de false et il 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:Utilisez le paramètre code avec précaution. Une utilisation incorrecte de cette fonctionnalité peut exposer votre extension à des attaques par scripts intersites.

  • cssOrigin

    CSSOrigin facultatif

    Chrome 66 ou version ultérieure

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

  • fichier

    chaîne facultatif

    Fichier JavaScript ou CSS à injecter.

  • frameId

    number facultatif

    Chrome 50 et versions ultérieures

    Cadre dans lequel le script ou le CSS doit être injecté. La valeur par défaut est 0 (cadre de premier niveau).

  • matchAboutBlank

    booléen facultatif

    Si matchAboutBlank est défini sur "true", le code est également injecté dans les cadres about:blank et about:srcdoc si votre extension a accès à son document parent. Vous ne pouvez pas insérer de code dans les frames about: de niveau supérieur. Par défaut, il s'agit de false.

  • runAt

    RunAt facultatif

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

RunAt

Chrome 44 ou version ultérieure

Date la plus proche à laquelle le code JavaScript ou CSS sera injecté dans l'onglet.

Énumération

"document_start"
Le script est injecté après les fichiers de CSS, mais avant la création d'un autre DOM ou l'exécution d'un autre script.

"document_end"
Le script est injecté immédiatement après la finalisation 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 la durée de son chargement, et 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 s'exécutent toujours une fois le DOM terminé. Si un script doit absolument s'exécuter après window.onload, l'extension peut vérifier si onload s'est déjà déclenché à l'aide de la propriété document.readyState.