Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

contextualIdentities.getSupportedIcons()

Gibt die vom Browser unterstützten Symbole für kontextuelle Identitäten zurück.

Für Firefox 153 und später sollten Sie diese Methode verwenden, anstatt Symbolnamen in Ihrer Erweiterung fest zu codieren. Auch wenn sich die unterstützten Symbole seit der Einführung von kontextuellen Identitäten nicht geändert haben, stellt die Verwendung dieser Methode sicher, dass Ihre Erweiterung mit jeglichen Änderungen kompatibel bleibt.

Diese Symbolnamen werden unterstützt:

  • "briefcase"
  • "cart"
  • "chill"
  • "circle"
  • "dollar"
  • "fence"
  • "fingerprint"
  • "food"
  • "fruit"
  • "gift"
  • "pet"
  • "tree"
  • "vacation"

Syntax

js
let icons = browser.contextualIdentities.getSupportedIcons()

Parameter

Keine.

Rückgabewert

Ein Promise, das mit einem Array von Objekten erfüllt wird, eines für jedes unterstützte Symbol. Jedes Objekt hat folgende Eigenschaften:

icon

string. Der Name des Symbols (zum Beispiel, "fingerprint"). Dies ist der Wert, der in der icon-Eigenschaft von contextualIdentities.ContextualIdentity verwendet wird.

iconUrl

string. Eine resource://-URL, die auf die SVG-Datei des Symbols verweist (zum Beispiel, "resource://usercontext-content/fingerprint.svg").

Wenn das Feature für kontextuelle Identitäten nicht aktiviert ist, wird das Versprechen mit einer Fehlermeldung zurückgewiesen.

Beispiele

Rufen Sie alle unterstützten Symbole ab und protokollieren Sie deren Namen und URLs:

js
function onGot(icons) {
  for (const { icon, iconUrl } of icons) {
    console.log(`${icon}: ${iconUrl}`);
  }
}

function onError(error) {
  console.error(error);
}

browser.contextualIdentities.getSupportedIcons().then(onGot, onError);

Browser-Kompatibilität