chrome.extensionTypes

Description

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

Types

CSSOrigin

Chrome 66 et versions ultérieures

Origine du code CSS injecté.

Enum

"author"

DeleteInjectionDetails

Chrome 87 et versions ultérieures

Informations sur le CSS à supprimer. Le code ou la propriété de fichier doivent être définis, mais ils ne peuvent pas être définis en même temps.

Propriétés

• allFrames

  Booléen facultatif

  Si allFrames a la valeur true, cela implique que le CSS doit être supprimé de tous les cadres de la page active. Par défaut, elle est false et n'est supprimée que du cadre supérieur. Si true et frameId sont définis, le code est supprimé du frame sélectionné et de tous ses cadres enfants.

• code

  string facultatif

  Code CSS à supprimer.

• cssOrigin

  CSSOrigin facultatif

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

• fichier

  string facultatif

  Fichier CSS à supprimer.

• frameId

  numéro facultatif

  Le frame à partir duquel le code CSS doit être supprimé. La valeur par défaut est 0 (image 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. La valeur par défaut est false.

DocumentLifecycle

Chrome 106 et versions ultérieures

Cycle de vie du document du cadre.

Enum

"active"

"cached"

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, de l'environnement 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.

Enum

"USER_SCRIPT"

FrameType

Chrome 106 et versions ultérieures

Type de frame.

Enum

"outermost_frame"

"sub_frame"

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

• quality

  numéro facultatif

  Lorsque le format est "jpeg", ce paramètre 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 contiendra davantage d'artefacts visuels, et le nombre d'octets nécessaires pour la stocker diminuera.

ImageFormat

Chrome 44 ou version ultérieure

Format d'une image.

Enum

"jpeg"

"png"

InjectDetails

Détails du script ou du CSS à injecter. Le code ou la propriété de fichier doivent être définis, mais ils ne peuvent pas être définis en même temps.

Propriétés

• allFrames

  Booléen facultatif

  Si allFrames a la valeur true, cela signifie que le code JavaScript ou CSS doit être injecté dans tous les frames de la page active. Par défaut, sa valeur est false et elle 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 tous ses cadres enfants.

• code

  string facultatif

  Code JavaScript ou CSS à injecter.

  Avertissement:Utilisez le paramètre code avec prudence. Si vous ne l'utilisez pas correctement, votre extension peut être exposée à des attaques de type script intersites.

• cssOrigin

  CSSOrigin facultatif

  Chrome 66 et versions ultérieures

  Origine du CSS à injecter. Vous ne pouvez spécifier cette valeur que pour CSS, et non pour JavaScript. La valeur par défaut est "author".

• fichier

  string facultatif

  Fichier JavaScript ou CSS à injecter.

• frameId

  numéro facultatif

  Chrome 50 et versions ultérieures

  Le frame dans lequel le script ou le CSS doit être injecté. La valeur par défaut est 0 (image 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. Impossible d'insérer du code dans les cadres about:-frames de premier niveau. La valeur par défaut est false.

• runAt

  RunAt facultatif

  Valeur 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

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

Enum

"document_start"
Le script est injecté après 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, comme les images et les cadres.

"document_idle"
Le navigateur choisit une heure d'injection du 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 de chargement. De plus, il est optimisé pour la vitesse de chargement des pages. Les scripts de contenu exécutés sur "document_idle" n'ont pas besoin d'écouter l'événement window.onload. Ils sont assurés de s'exécuter une fois le DOM terminé. Si un script doit impérativement 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.