i18n.getMessage()

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

Für einen Leitfaden zur Verwendung dieser Funktion siehe die Seite zur Internationalisierung.

Syntax

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

Parameter

messageName

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

  • Firefox gibt "" zurück und protokolliert einen Fehler.
  • Chrome gibt "" zurück und protokolliert keinen Fehler.
substitutions Optional

string oder array von string. Eine einzelne Ersetzungszeichenkette oder ein Array von Ersetzungszeichenketten.

In Chrome, wenn Sie mehr als 9 Ersetzungszeichenketten angeben, wird getMessage() undefined zurückgeben.

Rückgabewert

string. Nachricht lokalisiert für die aktuelle Spracheinstellung.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Holen Sie sich die lokalisierte Zeichenkette für "messageContent", mit der Ersetzung target.url:

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

Dies würde mit einer _locales/en/messages.json-Datei funktionieren, die folgendes 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 in der "en" Sprachversion:

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

Beispiel-Erweiterungen

Hinweis: Diese API basiert auf der chrome.i18n API von Chromium. Diese Dokumentation stammt aus i18n.json im Chromium-Code.