dom / latest / navigatoruadata.html /

NavigatorUAData

The NavigatorUAData interface of the User-Agent Client Hints API returns information about the browser and operating system of a user.

An instance of this object is returned by calling Navigator.userAgentData. Therefore, this interface has no constructor.

Note: The terms high entropy and low entropy refer to the amount of information these values reveal about the browser. The values returned as properties are deemed low entropy, and unlikely to identify a user. The values returned by NavigatorUAData.getHighEntropyValues() could potentially reveal more information. These values are therefore retrieved via a Promise, allowing time for the browser to request user permission, or make other checks.

Properties

Returns an array of brand information containing the browser name and version.

Returns true if the user-agent is running on a mobile device.

Returns the platform brand the user-agent is running on.

Methods

Returns a Promise that resolves with a dictionary object containing the high entropy values the user-agent returns.

A serializer that returns a JSON representation of the low entropy properties of the NavigatorUAData object.

Examples

Getting the brands

The following example prints the value of NavigatorUAData.brands to the console.

console.log(navigator.userAgentData.brands);

Returning high entropy values

In the following value a number of hints are requested using the NavigatorUAData.getHighEntropyValues() method. When the promise resolves, this information is printed to the console.

navigator.userAgentData.getHighEntropyValues(
  ["architecture",
  "model",
  "platform",
  "platformVersion",
  "fullVersionList"])
  .then(ua => { console.log(ua) });

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
NavigatorUAData
90
90
No
No
76
No
No
See bug 921655.
90
No
64
No
15.0
brands
90
90
No
No
76
No
No
90
No
64
No
15.0
getHighEntropyValues
90
90
No
No
76
No
No
90
No
64
No
15.0
mobile
90
90
No
No
76
No
No
90
No
64
No
15.0
platform
93
93
No
No
79
No
No
93
No
66
No
17.0
toJSON
93
93
No
No
79
No
No
93
No
66
No
17.0

See also

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/NavigatorUAData