NavigatorUAData

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental:これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

メモ: この機能はウェブワーカー内で利用可能です。

NavigatorUAData はユーザーエージェントクライアントヒント API のインターフェイスで、ユーザーのブラウザーとオペレーティングシステムに関する情報を返します。

このオブジェクトのインスタンスはNavigator.userAgentData またはWorkerNavigator.userAgentData を呼び出すことによって返されます。そのため、このインターフェイスにはコンストラクターはありません。

メモ:「高エントロピー」と「低エントロピー」という用語は、これらの値がブラウザーについて明らかにする情報の量を参照しています。プロパティとして返される値は、低エントロピーであり、ユーザーを特定する可能性が低いと判断されます。NavigatorUAData.getHighEntropyValues() によって返される値は、より多くの情報を明らかにする可能性があります。そのため、これらの値はPromise によって取得され、ブラウザーがユーザーの許可を要求したり、他のチェックを行ったりするための時間を確保することができます。

インスタンスプロパティ

NavigatorUAData.brands読取専用Experimental: ブラウザー名とバージョンを格納したブランド情報の配列を返します。
NavigatorUAData.mobile読取専用Experimental: ユーザーエージェントがモバイル端末で動作している場合はtrue を返します。
NavigatorUAData.platform読取専用Experimental: ユーザーエージェントが動作しているプラットフォームのブランドを返します。

インスタンスメソッド

NavigatorUAData.getHighEntropyValues()Experimental: ユーザーエージェントが返す高エントロピー値を格納した辞書オブジェクトで解決する Promise を返します。
NavigatorUAData.toJSON()Experimental: NavigatorUAData オブジェクトの低エントロピープロパティの JSON 表現を返すシリアライザーです。

例

ブランド名の取得

以下の例は、NavigatorUAData.brands の値をコンソールに表示するものです。

console.log(navigator.userAgentData.brands);

高エントロピー値の返却

以下の値では、NavigatorUAData.getHighEntropyValues() メソッドを使用して、多くのヒントをリクエストしています。プロミスが解決すると、この情報がコンソールに表示されます。

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