NavigatorUAData.getHighEntropyValues()

The getHighEntropyValues() method of the NavigatorUAData interface is a Promise that resolves with a dictionary object containing the high entropy values the user-agent returns.

Syntax

NavigatorUAData.getHighEntropyValues(hints);

Parameters

hints

An array containing the hints to be returned, one or more of:

• "architecture"
• "bitness"
• "model"
• "platformVersion"
• "uaFullVersion"

Return value

An object containing some or all of the following values, based on the hints requested:

architecture

A string containing the platform architecture. For example, "x86".

bitness

A string containing the architecture bitness. For example, "64".

model

A string containing the device model. For example, "Pixel 2XL".

platformVersion

A string containing the platform version. For example, "10.0".

uaFullVersion

A string containing the full browser version. For example, "91.0.4472.124".

Exceptions

A DOMException NotAllowedError

Thrown if the user-agent decides that one or more of the hints requested should not be returned.

Examples

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

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

Specifications

Browser compatibility