i18n
Functions to internationalize your extension. You can use these APIs to get localized strings from locale files packaged with your extension, find out the browser's current language, and find out the value of its Accept-Language header.
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
Report problems with this compatibility data on GitHubwebextensions-desktop | webextensions-mobile | |||||
---|---|---|---|---|---|---|
LanguageCode | ChromeFull support47 | EdgeFull support14 | FirefoxFull support45 | OperaFull support34 | SafariNo supportNo | Firefox for AndroidFull support48 |
detectLanguage | ChromeFull support47 | EdgeFull support79 | FirefoxFull support47 | OperaFull support34 | SafariNo supportNo | Firefox for AndroidFull support48 |
getAcceptLanguages | ChromeFull support47 | EdgeFull support14 | FirefoxFull support47 | OperaFull support34 | SafariFull support14 | Firefox for AndroidFull support48 |
getMessage | ChromeFull support17 | EdgeFull support14
| FirefoxFull support45
| OperaFull support15 | SafariFull support14 | Firefox for AndroidFull support48 |
getUILanguage | ChromeFull support35 | EdgeFull support14 | FirefoxFull support47
| OperaFull supportYes | SafariFull support14 | Firefox for AndroidFull support48 |
Legend
- Full support
- Full support
- No support
- No support
- See implementation notes.
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Example extensions
Acknowledgements
This API is based on Chromium's chrome.i18n
API. This documentation is derived from i18n.json
in the Chromium code.
Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.
See also
- Internationalization: a guide to using the WebExtension i18n system.
- Locale-Specific Message reference: extensions supply locale-specific strings in files called
messages.json
. This page describes the format ofmessages.json
.