NavigatorUAData
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die Schnittstelle NavigatorUAData der User-Agent Client Hints API gibt Informationen über den Browser und das Betriebssystem eines Benutzers zurück.
Eine Instanz dieses Objekts wird durch den Aufruf von Navigator.userAgentData oder WorkerNavigator.userAgentData zurückgegeben. Daher hat diese Schnittstelle keinen Konstruktor.
Hinweis:
Die Begriffe hohe Entropie und niedrige Entropie beziehen sich darauf, wie viele Informationen diese Werte über den Browser preisgeben. Die als Eigenschaften zurückgegebenen Werte gelten als Werte mit niedriger Entropie, anhand derer sich ein Benutzer wahrscheinlich nicht identifizieren lässt. Mit NavigatorUAData.getHighEntropyValues() können zusätzliche Werte mit hoher Entropie angefordert werden, die möglicherweise weitere identifizierende Informationen preisgeben. Diese Werte werden daher über eine Promise abgerufen. So hat der Browser Zeit, die Zustimmung des Benutzers einzuholen oder andere Prüfungen durchzuführen.
Instanzeigenschaften
-
Gibt ein Array mit Markeninformationen zurück, das den Namen und die Version des Browsers enthält.
-
Gibt
truezurück, wenn der User-Agent auf einem mobilen Gerät ausgeführt wird. -
Gibt die Marke der Plattform zurück, auf der der User-Agent ausgeführt wird.
Instanzmethoden
-
Gibt eine
Promisezurück, die mit einem Dictionary-Objekt erfüllt wird. Dieses enthält Informationen mit niedriger Entropie sowie die angeforderten Informationen mit hoher Entropie über den Browser. -
Gibt ein JSON-serialisierbares einfaches Objekt zurück, das das
NavigatorUAData-Objekt repräsentiert. Wird vonJSON.stringify()automatisch aufgerufen.
Beispiele
Die Browsermarken abrufen
Das folgende Beispiel gibt den Wert von NavigatorUAData.brands auf der Konsole aus.
console.log(navigator.userAgentData.brands);
Werte mit hoher Entropie zurückgeben
Im folgenden Beispiel werden mit der Methode NavigatorUAData.getHighEntropyValues() mehrere Hints angefordert. Sobald die Promise erfüllt ist, werden diese Informationen auf der Konsole ausgegeben.
navigator.userAgentData
.getHighEntropyValues([
"architecture",
"model",
"platform",
"platformVersion",
"fullVersionList",
])
.then((ua) => {
console.log(ua);
});
Spezifikationen
| Spezifikation |
|---|
| User-Agent Client Hints # navigatoruadata |