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.

js
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.

js
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

Siehe auch