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 ne pas enregistrer une erreur.
substitutionsFacultatif
string ou array de string. 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() renvoie undefined.

Valeur retournée

string. Message localisé pour les paramètres régionaux en cours.

Compatibilité du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
Support simple17141 24534815

1. Throws an exception instead returning an empty string if the message does not exist.

2. Expects substitutions to be strings, while other browsers allow any value which is then converted to a string.

3. Firefox 47 and earlier returns "??" instead of "" if the message is not found in _locales, bug 1258199 changed this act to match Chrome, landed on Firefox 48.

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

Remerciements :

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.

Étiquettes et contributeurs liés au document

Contributeurs à cette page : hellosct1
Dernière mise à jour par : hellosct1,