NavigatorUAData

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

注意:此功能在 Web Workers 中可用。

NavigatorUAData 介面是 User-Agent Client Hints API 的一部分,用於返回有關使用者瀏覽器和作業系統的資訊。

透過呼叫 Navigator.userAgentDataWorkerNavigator.userAgentData 可以獲得此物件的例項。因此,此介面沒有建構函式。

注意:術語高熵低熵指的是這些值在多大程度上揭示了有關瀏覽器資訊。作為屬性返回的值被認為是低熵的,不太可能用於識別使用者。透過 NavigatorUAData.getHighEntropyValues() 返回的值可能包含更多資訊。因此,這些值透過 Promise 檢索,以便瀏覽器有時間請求使用者許可或進行其他檢查。

例項屬性

返回一個包含瀏覽器名稱和版本的品牌資訊陣列。

如果使用者代理正在移動裝置上執行,則返回 true

返回使用者代理正在執行的平臺品牌。

例項方法

返回一個 Promise,該 Promise 解析為一個字典物件,包含使用者代理返回的高熵值。

一個序列化器,它返回 NavigatorUAData 物件低熵屬性的 JSON 表示。

示例

獲取品牌

下面的示例將 NavigatorUAData.brands 的值列印到控制檯。

js
console.log(navigator.userAgentData.brands);

返回高熵值

在下面的示例中,使用 NavigatorUAData.getHighEntropyValues() 方法請求了許多提示。當 Promise 解析後,這些資訊將被列印到控制檯。

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

規範

規範
使用者代理客戶端提示
# navigatoruadata

瀏覽器相容性

另見