i18n.getMessage()

Syntax

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:

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:

{
  "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

• menu-accesskey-visible
• menu-demo
• notify-link-clicks-i18n

Browser-Kompatibilität