i18n.getMessage()

Ruft die lokalisierte Zeichenfolge für die angegebene Nachricht ab.

Siehe die Seite Internationalization für einen Leitfaden zur Verwendung dieser Funktion.

Syntax

browser.i18n.getMessage(
  messageName,  // string
  substitutions // optional any
)

Parameter

messageName

string. Der Name der Nachricht, wie in der messages.json-Datei angegeben. Wenn die Nachricht nicht in messages.json gefunden werden kann:

Gibt Firefox "" zurück und protokolliert einen Fehler.
Gibt Chrome "" zurück und protokolliert keinen Fehler.

substitutions Optional

string oder array von string. Ein einzelner Ersetzungs-String oder ein Array von Ersetzungs-Strings.

In Chrome, wenn Sie mehr als 9 Ersetzungs-Strings bereitstellen, wird getMessage() undefined zurückgeben.

Rückgabewert

string. Nachricht, lokalisiert für das aktuelle Gebietsschema.

Browser-Kompatibilität

Beispiele

Rufen Sie die lokalisierte Zeichenfolge für "messageContent" ab, mit target.url ersetzt:

let message = browser.i18n.getMessage("messageContent", target.url);
console.log(message);

Dies würde mit einer _locales/en/messages.json-Datei funktionieren, die enthält:

json

{
  "messageContent": {
    "message": "You clicked $URL$.",
    "description": "Tells the user which link they clicked.",
    "placeholders": {
      "url": {
        "content": "$1",
        "example": "https://developer.mozilla.org"
      }
    }
  }
}

Wenn target.url "https://developer.mozilla.org" ist, wäre der Wert der Nachricht im "en"-Gebietsschema:

"You clicked https://developer.mozilla.org."

Beispielerweiterungen

Hinweis: Diese API basiert auf Chromiums chrome.i18n API. Diese Dokumentation ist abgeleitet von i18n.json im Chromium-Code.