Back to Content

WorkerNavigator: languages property

files/en-us/web/api/workernavigator/languages/index.md

latest1.3 KB
Original Source

{{APIRef("HTML DOM")}}{{AvailableInWorkers("worker")}}

The WorkerNavigator.languages read-only property returns an array of strings representing the user's preferred languages. The language is described using {{glossary("BCP 47 language tag", "BCP 47 language tags")}}. In the returned array they are ordered by preference with the most preferred language first.

The value of {{domxref("WorkerNavigator.language","navigator.language")}} is the first element of the returned array.

When its value changes, as the user's preferred languages are changed a {{domxref("Window.languagechange_event", "languagechange")}} event is fired on the {{domxref("WorkerGlobalScope")}} object.

The Accept-Language HTTP header in every HTTP request from the user's browser uses the same value for the navigator.languages property except for the extra qvalues (quality values) field (e.g., en-US;q=0.8).

Value

An array or strings.

Examples

You can run this insert a web worker:

js
navigator.language; // "en-US"
navigator.languages; // ["en-US", "zh-CN", "ja-JP"]

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{domxref("WorkerNavigator.language")}}
  • {{domxref("WorkerNavigator")}}
  • {{domxref("WorkerGlobalScope.languagechange_event", "languagechange")}} event