i18n.getMessage()
Obtient la chaîne localisée pour le message spécifié.
Syntaxe
browser.i18n.getMessage(
messageName, // string
substitutions, // optional any
);
Paramètres
messageName
-
string
. Le nom du message, tel que spécifié dans le fichier messages.json. Si le message ne peut pas être trouvé dans messages.json :- Firefox renvoie "" et enregistre une erreur.
- Chrome renvoie "" et n'enregistre pas d'erreur.
substitutions
Facultatif-
string
ouarray
destring
. Une chaîne de substitution unique ou un tableau de chaînes de substitution. Dans Chrome, si vous fournissez plus de 9 chaînes de substitution,getMessage()
renvoieundefined
.
Valeur retournée
string
. Message localisé pour les paramètres régionaux en cours.
Compatibilité des navigateurs
BCD tables only load in the browser
Exemples
Obtenez la chaîne localisée pour "messageContent"
, avec target.url
substitué :
var message = browser.i18n.getMessage("messageContent", target.url);
console.log(message);
Cela fonctionnerait avec un fichier _locales/en/messages.json contenant :
{
"messageContent": {
"message": "You clicked $URL$.",
"description": "Tells the user which link they clicked.",
"placeholders": {
"url": {
"content": "$1",
"example": "https://developer.mozilla.org"
}
}
}
}
Si target.url
est "https://developer.mozilla.org", alors la valeur de message, dans la locale "en", serait :
"You clicked https://developer.mozilla.org."
Example extensions
Note :
Cette API est basée sur l'API Chromium chrome.i18n
. Cette documentation est dérivée de i18n.json
dans le code de Chromium code.
Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.