index.md

---

title: i18n.getAcceptLanguages()
slug: Mozilla/Add-ons/WebExtensions/API/i18n/getAcceptLanguages
page-type: webextension-api-function
tags:
  - API
  - Add-ons
  - Extensions
  - Method
  - Non-standard
  - Reference
  - WebExtensions
  - getAcceptLanguages
  - i18n
browser-compat: webextensions.api.i18n.getAcceptLanguages

---

{{AddonSidebar()}}

Gets the accept-languages of the browser. This is different from the locale used by the browser. To get the locale, use {{WebExtAPIRef('i18n.getUILanguage')}}.

This is an asynchronous function that returns a Promise.

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

Syntax

let gettingAcceptLanguages = browser.i18n.getAcceptLanguages()

Parameters

None.

Return value

A Promise that will be fulfilled with an array of {{WebExtAPIRef('i18n.LanguageCode')}} objects.

Browser compatibility

{{Compat}}

Examples

function onGot(languages) {
  console.log(languages);
  //e.g. Array [ "en-US", "en" ]
}

let gettingAcceptLanguages = browser.i18n.getAcceptLanguages();
gettingAcceptLanguages.then(onGot);

{{WebExtExamples}}

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