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 itsAccept-Language header.
See theInternationalization page for a guide on using this API.
Types
i18n.LanguageCodeAlanguage tag such as
"en-US"or"fr".
Functions
i18n.detectLanguage()Detects the language of the provided text using theCompact Language Detector.
i18n.getMessage()Gets the localized string for the specified message.
i18n.getAcceptLanguages()Gets theaccept-languages of the browser. This is different from the locale used by the browser. To get the locale, use
i18n.getUILanguage.i18n.getUILanguage()Gets the UI language of the browser. This is different from
i18n.getAcceptLanguageswhich returns the preferred user languages.i18n.getPreferredSystemLanguages()Returns the preferred locales of the operating system.
i18n.getSystemUILanguage()Returns the current UI locale of the operating system.
Example extensions
Browser compatibility
Note:This API is based on Chromium'schrome.i18n API. This documentation is derived fromi18n.json in the Chromium code.
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.