NavigatorUAData
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.
Hinweis: Dieses Feature ist verfügbar in Web Workers.
Das NavigatorUAData
-Interface der User-Agent Client Hints API liefert Informationen über den Browser und das Betriebssystem eines Benutzers.
Ein Instanz dieses Objekts wird durch Aufruf von Navigator.userAgentData
oder WorkerNavigator.userAgentData
zurückgegeben. Daher hat dieses Interface keinen Konstruktor.
Hinweis: Die Begriffe hohe Entropie und niedrige Entropie beziehen sich auf die Menge an Informationen, die diese Werte über den Browser preisgeben. Die als Eigenschaften zurückgegebenen Werte gelten als niedere Entropie und sind unwahrscheinlich, einen Benutzer zu identifizieren. Die Werte, die durch NavigatorUAData.getHighEntropyValues()
zurückgegeben werden, könnten potenziell mehr Informationen offenlegen. Diese Werte werden daher über ein Promise
abgerufen, wodurch dem Browser Zeit gegeben wird, um die Erlaubnis des Nutzers einzuholen oder andere Überprüfungen vorzunehmen.
Instanzen-Eigenschaften
-
Gibt ein Array von Markeninformationen zurück, das den Browsernamen und die Version enthält.
-
Gibt
true
zurück, wenn der User-Agent auf einem mobilen Gerät läuft. -
Gibt die Plattform-Marke zurück, auf der der User-Agent läuft.
Instanzen-Methoden
-
Gibt ein
Promise
zurück, das mit einem Wörterbuchobjekt aufgelöst wird, das die vom User-Agent zurückgegebenen hohen Entropie-Werte enthält. -
Ein Serializer, der eine JSON-Darstellung der niedrigen Entropie-Eigenschaften des
NavigatorUAData
-Objekts zurückgibt.
Beispiele
Die Marken abrufen
Das folgende Beispiel gibt den Wert von NavigatorUAData.brands
in der Konsole aus.
console.log(navigator.userAgentData.brands);
Hohe Entropie-Werte zurückgeben
Im folgenden Beispiel werden eine Reihe von Hinweisen mit der Methode NavigatorUAData.getHighEntropyValues()
angefordert. Wenn das Versprechen erfüllt wird, werden diese Informationen in der Konsole ausgegeben.
navigator.userAgentData
.getHighEntropyValues([
"architecture",
"model",
"platform",
"platformVersion",
"fullVersionList",
])
.then((ua) => {
console.log(ua);
});
Spezifikationen
Specification |
---|
User-Agent Client Hints # navigatoruadata |
Browser-Kompatibilität
BCD tables only load in the browser