i18n

Fonctions permettant d'internationaliser votre extension. Vous pouvez utiliser ces API pour obtenir des chaînes localisées à partir de fichiers locaux conditionnés avec votre extension, connaître la langue actuelle du navigateur et en connaître la valeur de son En-tete "Accept-Language".

Pour plus de détails sur l'utilisation de i18n pour votre extension, voir :

Types

i18n.LanguageCode
Une balise de langue telle que "en-US" ou "fr".

Fonctions

i18n.getAcceptLanguages()
Obtient les accept-languages du navigateur. Ceci est différent des paramètres régionaux utilisés par le navigateur. Pour obtenir les paramètres régionaux, utilisez  i18n.getUILanguage.
i18n.getMessage()
Obtient la chaîne localisée pour le message spécifié.
i18n.getUILanguage()
Obtient la langue de l'interface utilisateur du navigateur. Ceci est différent de  i18n.getAcceptLanguages qui renvoie les langues utilisateur préférées.
i18n.detectLanguage()
Détecte la langue du texte fourni en utilisant le détecteur de langue compact.

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaSafariFirefox pour Android
LanguageCodeChrome Support complet 47Edge Support complet 14Firefox Support complet 45Opera Support complet 34Safari Aucun support NonFirefox Android Support complet 48
detectLanguageChrome Support complet 47Edge Support complet 79Firefox Support complet 47Opera Support complet 34Safari Aucun support NonFirefox Android Support complet 48
getAcceptLanguagesChrome Support complet 47Edge Support complet 14Firefox Support complet 47Opera Support complet 34Safari Support complet 14Firefox Android Support complet 48
getMessageChrome Support complet 17Edge Support complet 14
Notes
Support complet 14
Notes
Notes Throws an exception instead returning an empty string if the message does not exist.
Notes Expects substitutions to be strings, while other browsers allow any value which is then converted to a string.
Firefox Support complet 45
Notes
Support complet 45
Notes
Notes 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.
Opera Support complet 15Safari Support complet 14Firefox Android Support complet 48
getUILanguageChrome Support complet 35Edge Support complet 14Firefox Support complet 47
Notes
Support complet 47
Notes
Notes Firefox 55 and earlier returns a language tag that's seperated with the underscore character instead of hyphen, see bug 1374552.
Opera Support complet OuiSafari Support complet 14Firefox Android Support complet 48

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Voir les notes d'implémentation.
Voir les notes d'implémentation.

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.

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.