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
browser.i18n.getMessage(
messageName, // string
substitutions // optional any
)
Parameter
messageName
-
string
. Der Name der Nachricht, wie immessages.json
-Datei angegeben. Wenn die Nachricht nicht inmessages.json
gefunden werden kann:- Firefox gibt "" zurück und protokolliert einen Fehler.
- Chrome gibt "" zurück und protokolliert keinen Fehler.
substitutions
Optional-
string
oderarray
vonstring
. 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
:
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, wäre der Wert der Nachricht in der "en" Sprachversion:
"You clicked https://developer.mozilla.org."
Beispielerweiterungen
Hinweis:
Diese API basiert auf der chrome.i18n
API von Chromium. Diese Dokumentation stammt aus i18n.json
im Chromium-Code.