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
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
oderarray
vonstring
. 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
Browser-Kompatibilität
Hinweis:
Diese API basiert auf der chrome.i18n
API von Chromium. Diese Dokumentation stammt aus i18n.json
im Chromium-Code.