i18n.getMessage()

Ruft den lokalisierten String für die angegebene Nachricht ab.

Sehen Sie sich die Seite zur Internationalisierung für einen Leitfaden zur Verwendung dieser Funktion an.

Syntax

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

Parameter

messageName

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

  • Gibt Firefox "" zurück und loggt einen Fehler.
  • Gibt Chrome "" zurück und loggt keinen Fehler.
substitutions Optional

string oder array von string. Ein einzelner Ersetzungsstring oder ein Array von Ersetzungsstrings.

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

Rückgabewert

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

Beispiele

Holen Sie sich den lokalisierten String für "messageContent", mit Ersetzung von 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, dann wäre der Wert der Nachricht im "en" Gebietsschema:

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

Beispielerweiterungen

Browser-Kompatibilität

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