Format de fichier manifeste pour les extensions

  • Article

Chaque extension pour Microsoft Edge a un fichier manifeste au format JSON, nommé manifest.json. Le fichier manifeste est le blueprint de votre extension. Le fichier manifeste contient des informations telles que :

  • Numéro de version de l’extension.
  • Titre de l’extension.
  • Autorisations nécessaires à l’exécution de l’extension.

Le manifeste V2 est déconseillé

Utilisez Manifest V3 pour le nouveau code. Le format des manifest.json extensions passe du manifeste V2 au manifeste V3. Les deux formats sont affichés ici. Pour migrer une extension Manifest V2 vers Manifest V3, consultez Migrer une extension de Manifest V2 vers V3.

Format de manifest.json pour les extensions

Le code suivant montre les champs pris en charge dans manifest.json pour les extensions, pour un package Manifest V3 ou V2.

Pour obtenir des informations de référence sur chaque champ, consultez Format de fichier manifeste (V3), puis cliquez sur les liens sur les champs.

{
  // Required
  "manifest_version": 3,
  "name": "My V3 Extension",
  "version": "versionString",

  // Recommended
  "action": {...},
  "default_locale": "en",
  "description": "A plain-text description",
  "icons": {...},

  // Optional
  "action": ...,
  "author": ...,
  "automation": ...,
  "background": {
    // If `background` is included, `service_ worker` is required
    "service_worker": ...
  },
  "chrome_settings_overrides": {...},
  "chrome_url_overrides": {...},
  "commands": {...},
  "content_capabilities": ...,
  "content_scripts": [{...}],
  "content_security_policy": "policyString",
  "converted_from_user_script": ...,
  "current_locale": ...,
  "declarative_net_request": ...,
  "devtools_page": "devtools.html",
  "differential_fingerprint": ...,
  "event_rules": [{...}],
  "externally_connectable": {
    "matches": ["*://*.contoso.com/*"]
  },
  "file_browser_handlers": [...],
  "file_system_provider_capabilities": {
    "configurable": true,
    "multiple_mounts": true,
    "source": "network"
  },
  "homepage_url": "http://path/to/homepage",
  "host_permissions": [...],
  "import": [{"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}],
  "incognito": "spanning, split, or not_allowed",
  "input_components": ...,
  "key": "publicKey",
  "minimum_chrome_version": "versionString",
  "nacl_modules": [...],
  "natively_connectable": ...,
  "oauth2": ...,
  "offline_enabled": true,
  "omnibox": {
    "keyword": "aString"
  },
  "optional_permissions": ["tabs"],
  "options_page": "options.html",
  "options_ui": {
    "chrome_style": true,
    "page": "options.html"
  },
  "permissions": ["..."],
  "platforms": ...,
  "replacement_web_app": ...,
  "requirements": {...},
  "sandbox": [...],
  "short_name": "Short Name",
  "side_panel": {...},
  "storage": {
    "managed_schema": "schema.json"
  },
  "system_indicator": ...,
  "tts_engine": {...},
  "update_url": "http://path/to/updateInfo.xml",
  "version_name": "aString",
  "web_accessible_resources": [...]
}

Modifications apportées à manifest.json V3 et V2

V3 V2
"manifest_version": 3, "manifest_version": 2,
"action": {...}, "browser_action": {...},
"action": {...}, "page_action": {...},
supprimé "persistent": false,
Si background est inclus, service_ worker est obligatoire Si background est inclus, service_ worker est facultatif
Séparés en deux clés différentes : "permissions": [...], "host_permissions": [...], "permissions": [...],

Remarque

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Google et utilisées conformément aux termes décrits dans la licence internationale Creative Commons Attribution 4.0. La page d’origine se trouve ici.

Licence Creative Commons Cette œuvre est concédée sous licence creative commons attribution 4.0 international.

Voir aussi