NavigatorUAData
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
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.
Das NavigatorUAData-Interface der User-Agent Client Hints API liefert Informationen über den Browser und das Betriebssystem eines Nutzers.
Eine Instanz dieses Objekts wird zurückgegeben durch Aufruf von Navigator.userAgentData oder WorkerNavigator.userAgentData. 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 niedrige Entropie, die unwahrscheinlich einen Nutzer identifizieren. Die Methode NavigatorUAData.getHighEntropyValues() kann verwendet werden, um zusätzliche hohe Entropie Werte anzufordern, die potenziell mehr identifizierende Informationen preisgeben könnten. Diese Werte werden daher über ein Promise abgerufen, wodurch dem Browser Zeit gegeben wird, um die Erlaubnis des Nutzers einzuholen oder andere Überprüfungen durchzuführen.
Instanz-Eigenschaften
-
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 läuft. -
Gibt die Plattformmarke zurück, auf der der User-Agent läuft.
Instanz-Methoden
-
Gibt ein
Promisezurück, das mit einem Wörterbuchobjekt aufgelöst wird, das Informationen mit niedriger Entropie und angeforderte Informationen mit hoher Entropie über den Browser enthält. -
Ein Serializer, der eine JSON-Darstellung der niedrigen Entropie-Eigenschaften des
NavigatorUAData-Objekts zurückgibt.
Beispiele
Abrufen der Marken
Das folgende Beispiel gibt den Wert von NavigatorUAData.brands in der Konsole aus.
console.log(navigator.userAgentData.brands);
Rückgabe von Werten mit hoher Entropie
Im folgenden Beispiel werden eine Reihe von Hinweisen mithilfe der Methode NavigatorUAData.getHighEntropyValues() angefordert. Wenn das Promise aufgelöst 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 |