NavigatorUAData
注意:此功能在 Web Workers 中可用。
NavigatorUAData 介面是 User-Agent Client Hints API 的一部分,用於返回有關使用者瀏覽器和作業系統的資訊。
透過呼叫 Navigator.userAgentData 或 WorkerNavigator.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 |
瀏覽器相容性
載入中…