browser_specific_settings

Type Object
Obligatoire

Habituellement, non (mais voir aussi Quand avec-vous besoin d'une ID Complémentaire?). Obligatoire avant Firefox 48 (desktop) et Firefox pour Android.

Example
"browser_specific_settings": {
  "gecko": {
    "id": "addon@example.com",
    "strict_min_version": "42.0"
  }
}

Description

La clé browser_specific_settings contient des clés qui sont spécifiques à certaines applications hôtes.

Propriétés (Gecko) Firefox

Actuellement, elle contient uniquement une clé, gecko, qui est structurée ainsi :

  • id est l'ID de l'extension. Facultatif à partir de Firefox 48, obligatoire avant Firefox 48. Voir les WebExtensions et l'ID des extensions pour voir quand vous devez spécifier un identifiant complémentaire.
  • strict_min_version : la version minimum de Gecko supportée. Les versions contenant un "*" ne sont pas valides dans ce domaine. Par défaut, c'est "42a1".
  • strict_max_version : la version maximum de Gecko supportée. Si la version de Firefox sur laquelle l'extension est en cours d'installation ou d'exécution est au-dessus de cette version, l'extension sera désactivée ou ne sera pas autorisée à être installée. Par défaut, c'est "*", qui désactive la vérification d'une version maximale.
  • update_url est lien vers un manifeste de mise à jour personnalisé. Notez que le lien doit commencer par "https". Cette clé consiste à gérer vous-même les mises à jour d'extension (c'est-à-dire pas via AMO).

Vois la liste des versions Gecko valides.

Format d'ID d'extension

L'ID d'extension doit être l'un des suivants :

  • GUID
  • Une chaîne formatée comme une adresse e-mail : extensionname@example.org

Ce dernier format est plus facile à générer et à manipuler. Sachez que l'utilisation d'une véritable adresse e-mail ici peut attirer des spams.

Par exemple :

"id": "extensionname@example.org"
"id": "{daf44bf7-a45e-4450-979c-91cf07434c3d}"

Propriétés Microsoft Edge

Avertissement : L'ajout de propriétés spécifiques à Edge au manifeste a causé une erreur avant Firefox 69 qui peut empêcher l'extension de s'installer.

Microsoft Edge stocke les paramètres spécifiques à son navigateur dans la sous-clé edge, qui possède les propriétés suivantes :

browser_action_next_to_addressbar

Propriété booléenne qui contrôle le placement de l'action du navigateur.

Exemples

Exemple avec toutes les clés possibles. Notez que vous n'incluez normalement ni une version strict_max_version ni une clé update_url.

"browser_specific_settings": {
  "gecko": {
    "id": "addon@example.com",
    "strict_min_version": "42.0",
    "strict_max_version": "50.*",
    "update_url": "https://example.com/updates.json"
  },
  "edge": {
    "browser_action_next_to_addressbar": true
  }
}

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaSafariFirefox pour Android
browser_specific_settingsChrome Aucun support NonEdge Aucun support 15 — 79Firefox Support complet 48
Support complet 48
Support complet 42
Notes Autre nom
Notes Mandatory before Firefox 48.
Autre nom Cette fonctionnalité utilise le nom non-standard : applications
Opera Aucun support NonSafari Support partiel 14
Notes
Support partiel 14
Notes
Notes Supports strict_min_version and strict_max_version in a safari block.
Firefox Android Support complet 48
Support complet 48
Support complet 42
Notes Autre nom
Notes Mandatory before Firefox 48.
Autre nom Cette fonctionnalité utilise le nom non-standard : applications

Légende

Support complet  
Support complet
Support partiel  
Support partiel
Aucun support  
Aucun support
Voir les notes d'implémentation.
Voir les notes d'implémentation.
Cette fonctionnalité utilise un nom non-standard.
Cette fonctionnalité utilise un nom non-standard.