NavigatorLanguage

Jump to:

Properties
Methods
Specifications
Browser compatibility
See also

NavigatorLanguage contains methods and properties related to the language of the navigator.

There is no object of type NavigatorLanguage, but other interfaces, like Navigator or WorkerNavigator, implement it.

Properties

The NavigatorLanguage interface doesn't inherit any property.

NavigatorLanguage.language Read only: Returns a DOMString representing the preferred language of the user, usually the language of the browser UI. The null value is returned when this is unknown.
NavigatorLanguage.languages Read only: Returns an array of DOMString representing the languages known to the user, by order of preference.

Methods

The NavigatorLanguage interface neither implements, nor inherit any method.

Specifications

Specification	Status	Comment
HTML Living Standard The definition of 'NavigatorLanguage' in that specification.	Living Standard	Since the HTML5 snapshot, the `languages` property has been added.
HTML5 The definition of 'NavigatorLanguage' in that specification.	Recommendation	Initial specification; snapshot of an early versionHTML Living Standard.

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Edge Mobile	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
Basic support	Chrome Full support Yes	Edge ?	Firefox Full support Yes	IE Full support Yes	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes	Chrome Android Full support Yes	Edge Mobile ?	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android ?
Support on `WorkerNavigator`	Chrome ?	Edge ?	Firefox Full support 35	IE No support No	Opera ?	Safari No support No	WebView Android ?	Chrome Android ?	Edge Mobile ?	Firefox Android Full support 35	Opera Android ?	Safari iOS No support No	Samsung Internet Android ?
`language`	Chrome Full support Yes Notes Full support Yes Notes Notes Returns the browser UI language, not the value of the `Accept-Language` HTTP header.	Edge Full support Yes	Firefox Full support 1 Notes Full support 1 Notes Notes Prior to Firefox 4 this property's value was also part of the user agent string, as reported by `navigator.userAgent`. Full support 5 Notes Notes Starting in Firefox 5.0 this property's value is based on the value of the `Accept-Language` HTTP header.	IE Full support 11 Notes Full support 11 Notes Notes Closest available (non-standard) properties are `userLanguage` and `browserLanguage`.	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes Notes Full support Yes Notes Notes Returns the browser UI language, not the value of the `Accept-Language` HTTP header.	Chrome Android Full support Yes Notes Full support Yes Notes Notes Returns the browser UI language, not the value of the `Accept-Language` HTTP header.	Edge Mobile Full support Yes	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android ?
`languages` Experimental	Chrome Full support 32 Notes Full support 32 Notes Notes In Chrome, `navigator.language` is the language of the browser UI, and is not guaranteed to be equal to `navigator.languages[0]`.	Edge Full support Yes	Firefox Full support 32 Notes Full support 32 Notes Notes In Firefox, the `navigator.languages` property's value is taken from the `intl.accept_languages` preference.	IE Full support 11 Notes Full support 11 Notes Notes Closest available (non-standard) properties are `userLanguage` and `browserLanguage`.	Opera Full support 24	Safari Full support 11	WebView Android Full support 4.4.3 Notes Full support 4.4.3 Notes Notes In Chrome, `navigator.language` is the language of the browser UI, and is not guaranteed to be equal to `navigator.languages[0]`.	Chrome Android Full support 32 Notes Full support 32 Notes Notes In Chrome, `navigator.language` is the language of the browser UI, and is not guaranteed to be equal to `navigator.languages[0]`.	Edge Mobile Full support Yes	Firefox Android Full support 4 Notes Full support 4 Notes Notes In Firefox, the `navigator.languages` property's value is taken from the `intl.accept_languages` preference.	Opera Android Full support 24	Safari iOS Full support Yes	Samsung Internet Android ?

Legend

Full support: Full support
No support: No support
Compatibility unknown: Compatibility unknown
Experimental. Expect behavior to change in the future.: Experimental. Expect behavior to change in the future.
See implementation notes.: See implementation notes.

Document Tags and Contributors

Tags:

Contributors to this page: fscholz, teoli, realityking

Last updated by: fscholz, Apr 13, 2018, 3:17:32 AM