i18n

Functions to internationalize your add-on. You can use these APIs to get localized strings from locale files packaged with your add-on, find out the browser's current language, and find out the value of its Accept-Language header.

For more details on i18n in WebExtensions, see:

Types

i18n.LanguageCode
A language tag such as "en-US" or "fr".

Functions

i18n.getAcceptLanguages()
Gets the accept-languages of the browser. This is different from the locale used by the browser. To get the locale, use i18n.getUILanguage.
i18n.getMessage()
Gets the localized string for the specified message.
i18n.getUILanguage()
Gets the UI language of the browser. This is different from i18n.getAcceptLanguages which returns the preferred user languages.
i18n.detectLanguage()
Detects the language of the provided text using the Compact Language Detector.

Browser compatibility

EdgeFirefoxChromeOpera
LanguageCode?45.0Yes33
detectLanguage?47.0Yes33
getAcceptLanguages?47.0Yes33
getMessage?45.0Yes33
getUILanguage?47.0YesNo
Firefox
LanguageCode48.0
detectLanguage48.0
getAcceptLanguages48.0
getMessage48.0
getUILanguage48.0

Chrome incompatibilities

None.

Example add-ons

Acknowledgements

This API is based on Chromium's chrome.i18n API. This documentation is derived from i18n.json in the Chromium code.

Document Tags and Contributors

 Contributors to this page: wbamberg, chrisdavidmills
 Last updated by: wbamberg,