Aller au contenu principal

Support des extensions Chrome

Electron supports a subset of the Chrome Extensions API, primarily to support DevTools extensions and Chromium-internal extensions, but it also happens to support some other extension capabilities.

[!NOTE] Electron does not support arbitrary Chrome extensions from the store, and it is a non-goal of the Electron project to be perfectly compatible with Chrome's implementation of Extensions.

Chargement des extensions​

Electron ne prend en charge que les extensions non empaquetées (i.e les fichiers .crx ne sont pas acceptés). Les extensions sont installées par-session. Pour charger une extension, vous devez utiliser ses.extensions.loadExtension:

const { session } = require('electron')

session.defaultSession.loadExtension('path/to/unpacked/extension').then(({ id }) => {
  // ...
})

Les extensions chargées ne seront pas automatiquement mémorisées après une sorties ; si vous n'appelez pas loadExtension lorsque l'application s'exécute, l'extension ne sera pas chargée.

Notez que le chargement d'extensions n'est pris en charge que dans les sessions persistantes. Tenter de charger une extension dans une session en mémoire générera une erreur.

See the session documentation for more information about loading, unloading, and querying active extensions.

APIs d'extensions prises en charge​

Nous prenons en charge les API d'extensions suivantes, avec cependant quelques mises en garde. D'autres APIs peuvent être également prises en charge mais sont provisoires et peuvent être supprimées si non listées ci-dessous.

Supported Manifest Keys​

  • nom
  • version
  • author
  • permissions
  • content_scripts
  • default_locale
  • devtools_page
  • short_name
  • host_permissions (Manifest V3)
  • manifest_version
  • background (Manifest V2)
  • minimum_chrome_version

Voir le Format de fichier des manifests pour plus d'informations sur l'utilisation des clés.

chrome.devtools.inspectedWindow​

Toutes les fonctionnalités de cette API sont prises en charge.

Pour plus d'informations voir la documentation officielle.

chrome.devtools.network​

Toutes les fonctionnalités de cette API sont prises en charge.

Pour plus d'informations voir la documentation officielle.

chrome.devtools.panels​

Toutes les fonctionnalités de cette API sont prises en charge.

Pour plus d'informations voir la documentation officielle.

chrome.extension​

Les propriétés suivantes de chrome.extension sont prises en charge :

  • chrome.extension.lastError

Les méthodes suivantes de chrome.extension sont prises en charge :

  • chrome.extension.getURL
  • chrome.extension.getBackgroundPage

Pour plus d'informations voir la documentation officielle.

chrome.management​

Les méthodes suivantes de chrome.management sont prises en charge :

  • chrome.management.getAll
  • chrome.management.get
  • chrome.management.getSelf
  • chrome.management.getPermissionWarningsById
  • chrome.management.getPermissionWarningsByManifest

Les événements suivants de chrome.management sont pris en charge :

  • chrome.management.onEnabled
  • chrome.management.onDisabled

Pour plus d'informations voir la documentation officielle.

chrome.runtime​

Les propriétés suivantes de chrome.runtime sont prises en charge :

  • chrome.runtime.lastError
  • chrome.runtime.id

Les méthodes suivantes de chrome.runtime sont prises en charge :

  • chrome.runtime.getBackgroundPage
  • chrome.runtime.getManifest
  • chrome.runtime.getPlatformInfo
  • chrome.runtime.getURL
  • chrome.runtime.connect
  • chrome.runtime.sendMessage
  • chrome.runtime.reload

Les événements suivants de chrome.runtime sont pris en charge :

  • chrome.runtime.onStartup
  • chrome.runtime.onInstalled
  • chrome.runtime.onSuspend
  • chrome.runtime.onSuspendCanceled
  • chrome.runtime.onConnect
  • chrome.runtime.onMessage

Pour plus d'informations voir la documentation officielle.

chrome.scripting​

Toutes les fonctionnalités de cette API sont prises en charge.

Pour plus d'informations voir la documentation officielle.

chrome.storage​

Les méthodes suivantes de chrome.storage sont prises en charge :

  • chrome.storage.local

chrome.storage.sync et chrome.storage.managed ne **sont pas ** supportées.

Pour plus d'informations voir la documentation officielle.

chrome.tabs​

Les méthodes suivantes de chrome.tabs sont prises en charge :

  • chrome.tabs.sendMessage
  • chrome.tabs.reload
  • chrome.tabs.executeScript
  • chrome.tabs.query (prise en charge partielle)
    • propriétés prises en charge : url, title, audible, active, muted.
  • chrome.tabs.update (prise en charge partielle)
    • propriétés prises en charge : url, muted.

[!NOTE] In Chrome, passing -1 as a tab ID signifies the "currently active tab". Comme ce concept n'existe pas avec Electron le passage d'un ID d'onglet -1 n’est pas pris en charge et entraînera une erreur.

Pour plus d'informations voir la documentation officielle.

chrome.webRequest​

Toutes les fonctionnalités de cette API sont prises en charge.

[!NOTE] Electron's webRequest module takes precedence over chrome.webRequest if there are conflicting handlers.

Pour plus d'informations voir la documentation officielle.