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.

See the Internationalization page for a guide on using this API.

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 GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
i18n
LanguageCode
detectLanguage
getAcceptLanguages
getMessage
getUILanguage

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.
Has more compatibility info.

Example extensions

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

See also