Funciones para internacionalizar su extensión. Es posible utilizar estas API para obtener cadenas de texto traducidas a partir de archivos de configuración regional incluidos en la extensión, conocer el idioma actual del navegador y recuperar el valor de su cabecera Accept-Language.

Para obtener más información sobre el uso de i18n en su extensión, consulte:

Tipos

i18n.LanguageCode
Una etiqueta de idioma como «en-US» o «fr».

Funciones

i18n.getAcceptLanguages()
Recupera los valores de accept-language del navegador. Esto es distinto de la configuración regional utilizada por el navegador. Para obtener la configuración regional, utilice i18n.getUILanguage.
i18n.getMessage()
Obtiene la cadena de texto traducida correspondiente al mensaje especificado.
i18n.getUILanguage()
Obtiene el idioma de la IU del navegador. Esto es distinto de i18n.getAcceptLanguages, que devuelve los idiomas preferidos del usuario.
i18n.detectLanguage()
Detecta el idioma del texto proporcionado a través de Compact Language Detector.

Compatibilidad entre navegadores

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxOperaFirefox for Android
LanguageCodeChrome Soporte completo 47Edge Soporte completo 14Firefox Soporte completo 45Opera Soporte completo 34Firefox Android Soporte completo 48
detectLanguageChrome Soporte completo 47Edge Sin soporte NoFirefox Soporte completo 47Opera Soporte completo 34Firefox Android Soporte completo 48
getAcceptLanguagesChrome Soporte completo 47Edge Soporte completo 14Firefox Soporte completo 47Opera Soporte completo 34Firefox Android Soporte completo 48
getMessageChrome Soporte completo 17Edge Soporte completo 14
Notas
Soporte completo 14
Notas
Notas Throws an exception instead returning an empty string if the message does not exist.
Notas Expects substitutions to be strings, while other browsers allow any value which is then converted to a string.
Firefox Soporte completo 45
Notas
Soporte completo 45
Notas
Notas 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 Soporte completo 15Firefox Android Soporte completo 48
getUILanguageChrome Soporte completo 35Edge Soporte completo 14Firefox Soporte completo 47Opera Soporte completo SiFirefox Android Soporte completo 48

Leyenda

Soporte completo  
Soporte completo
Sin soporte  
Sin soporte
Ver notas de implementación.
Ver notas de implementación.

Example extensions

Reconocimientos

Esta API se basa en la API chrome.i18n de Chromium. Esta documentación deriva del archivo i18n.json en el código fuente de Chromium.

Los datos de compatibilidad de Microsoft Edge son suministrados por Microsoft Corporation y se incluyen aquí según los términos de la licencia Creative Commons Atribución 3.0, versión estadounidense.

Etiquetas y colaboradores del documento

Colaboradores en esta página: fitojb, yuniers
Última actualización por: fitojb,