chrome.types

refresh date: 2026-09-25 robots: noindex

Description

L'API chrome.types contient des déclarations de type pour Chrome.

Paramètres de Google Chrome

Le prototype ChromeSetting fournit un ensemble commun de fonctions (get(), set() et clear()) ainsi qu'un éditeur d'événements (onChange) pour les paramètres du navigateur Chrome. Les exemples de paramètres proxy montrent comment utiliser ces fonctions.

Champ d'application et cycle de vie

Chrome distingue trois types de paramètres de navigateur :

regular
Les paramètres définis dans le champ d'application regular s'appliquent aux fenêtres de navigateur standards et sont hérités par les fenêtres de navigation privée s'ils ne sont pas écrasés. Ces paramètres sont stockés sur le disque et restent en place jusqu'à ce qu'ils soient effacés par l'extension de contrôle, ou que l'extension de contrôle soit désactivée ou désinstallée.
incognito_persistent
Les paramètres définis dans le champ d'application incognito_persistent ne s'appliquent qu'aux fenêtres de navigation privée. Pour ces derniers, ils remplacent les paramètres regular. Ces paramètres sont stockés sur le disque et restent en place jusqu'à ce qu'ils soient effacés par l'extension de contrôle, ou que l'extension de contrôle soit désactivée ou désinstallée.
incognito_session_only
Les paramètres définis dans le champ d'application incognito_session_only ne s'appliquent qu'aux fenêtres de navigation privée. Pour ces éléments, ils remplacent les paramètres regular et incognito_persistent. Ces paramètres ne sont pas stockés sur le disque et sont effacés lorsque la dernière fenêtre de navigation privée est fermée. Elles ne peuvent être définies que lorsqu'au moins une fenêtre de navigation privée est ouverte.

Priorité

Chrome gère les paramètres à différents niveaux. La liste suivante décrit les couches susceptibles d'influencer les paramètres effectifs, par ordre de priorité croissant.

  1. Paramètres système fournis par le système d'exploitation
  2. Paramètres de ligne de commande
  3. Paramètres fournis par les extensions
  4. Règles

Comme l'indique la liste, les règles peuvent annuler les modifications que vous spécifiez avec votre extension. Vous pouvez utiliser la fonction get() pour déterminer si votre extension est capable de fournir un paramètre ou si ce paramètre serait remplacé.

Comme indiqué ci-dessus, Chrome permet d'utiliser des paramètres différents pour les fenêtres standards et les fenêtres de navigation privée. L'exemple suivant illustre ce comportement. Supposons qu'aucune règle ne remplace les paramètres et qu'une extension puisse définir des paramètres pour les fenêtres standards (R) et les fenêtres de navigation privée (I).

  • Si seul (R) est défini, ces paramètres s'appliquent aux fenêtres standards et de navigation privée.
  • Si seul (I) est défini, ces paramètres ne s'appliquent qu'aux fenêtres de navigation privée. Les fenêtres standards utilisent les paramètres déterminés par les couches inférieures (options de ligne de commande et paramètres système).
  • Si les deux paramètres (R) et (I) sont définis, les paramètres respectifs sont utilisés pour les fenêtres standards et de navigation privée.

Si deux extensions ou plus souhaitent définir le même paramètre sur des valeurs différentes, l'extension installée le plus récemment est prioritaire sur les autres extensions. Si l'extension installée le plus récemment ne définit que (I), les paramètres des fenêtres standards peuvent être définis par des extensions installées précédemment.

La valeur effective d'un paramètre est celle qui résulte de la prise en compte des règles de priorité. Il est utilisé par Chrome.

Types

ChromeSetting

Interface permettant d'accéder à un paramètre du navigateur Chrome. Pour consulter un exemple, voir accessibilityFeatures.

Propriétés

  • onChange

    Event<functionvoidvoid>

    Déclenché après la modification du paramètre.

    La fonction onChange.addListener se présente comme suit : 

    (callback: function) => {...}

    • callback

      fonction

      Le paramètre callback se présente comme suit : 

      (details: object) => void

      • détails

        objet

        • incognitoSpecific

          boolean facultatif

          Indique si la valeur qui a changé est spécifique à la session de navigation privée. Cette propriété ne sera présente que si l'utilisateur a activé l'extension en mode navigation privée.

        • levelOfControl

          LevelOfControl

          Niveau de contrôle du paramètre.

        • valeur

          T

          Valeur du paramètre après la modification.

  • effacer

    vide

    Promise

    Efface le paramètre et restaure la valeur par défaut.

    La fonction clear se présente comme suit : 

    (details: object, callback?: function) => {...}

    • détails

      objet

      Paramètre à effacer.

      • champ d'application

        ChromeSettingScope facultatif

        Où effacer le paramètre (par défaut : regular).

    • callback

      function facultatif

      Le paramètre callback se présente comme suit : 

      () => void

    • Renvoie

      Promise<void>

      Chrome 96 ou version ultérieure

      Appelé à la fin de l'opération d'effacement.

      Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

  • get

    vide

    Promise

    Récupère la valeur d'un paramètre.

    La fonction get se présente comme suit : 

    (details: object, callback?: function) => {...}

    • détails

      objet

      Paramètre à prendre en compte.

      • navigation privée

        boolean facultatif

        Indique si la valeur qui s'applique à la session de navigation privée doit être renvoyée (valeur par défaut : "false").

    • callback

      function facultatif

      Le paramètre callback se présente comme suit : 

      (details: object) => void

      • détails

        objet

        Détails de la valeur actuellement effective.

        • incognitoSpecific

          boolean facultatif

          Indique si la valeur effective est spécifique à la session de navigation privée. Cette propriété n'est présente que si la propriété incognito du paramètre details de get() est définie sur "true".

        • levelOfControl

          LevelOfControl

          Niveau de contrôle du paramètre.

        • valeur

          T

          Valeur du paramètre.

    • Renvoie

      Promise<object>

      Chrome 96 ou version ultérieure

      Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

  • set

    vide

    Promise

    Définit la valeur d'un paramètre.

    La fonction set se présente comme suit : 

    (details: object, callback?: function) => {...}

    • détails

      objet

      Le paramètre à modifier.

      • champ d'application

        ChromeSettingScope facultatif

        Emplacement où définir le paramètre (par défaut : standard).

      • valeur

        T

        Valeur du paramètre. Notez que chaque paramètre est associé à un type de valeur spécifique, qui est décrit avec le paramètre. Une extension ne doit pas définir une valeur d'un type différent.

    • callback

      function facultatif

      Le paramètre callback se présente comme suit : 

      () => void

    • Renvoie

      Promise<void>

      Chrome 96 ou version ultérieure

      Appelé à la fin de l'opération de définition.

      Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

ChromeSettingScope

Chrome 44 ou version ultérieure

Le champ d'application de ChromeSetting. Une

  • regular : paramètre du profil standard (qui est hérité par le profil de navigation privée s'il n'est pas remplacé ailleurs)
  • regular\_only : paramètre pour le profil standard uniquement (non hérité par le profil de navigation privée)
  • incognito\_persistent : paramètre du profil de navigation privée qui persiste après le redémarrage du navigateur (remplace les préférences standards)
  • incognito\_session\_only : paramètre du profil de navigation privée qui ne peut être défini que pendant une session de navigation privée et qui est supprimé à la fin de la session de navigation privée (remplace les préférences standards et incognito_persistent).

Énumération

"regular"

"regular_only"

"incognito_persistent"

"incognito_session_only"

LevelOfControl

Chrome 44 ou version ultérieure

Une

  • not\_controllable : ne peut être contrôlé par aucune extension
  • controlled\_by\_other\_extensions : contrôlé par des extensions de priorité supérieure
  • controllable\_by\_this\_extension : peut être contrôlé par cette extension
  • controlled\_by\_this\_extension : contrôlé par cette extension

Énumération

"not_controllable"

"controlled_by_other_extensions"

"controllable_by_this_extension"

"controlled_by_this_extension"