NavigatorUAData: getHighEntropyValues() Methode

hints

Ein Array, das die zurückzugebenden Hinweise enthält, einer oder mehrere von:

• "architecture"
• "bitness"
• "formFactor"
• "fullVersionList"
• "model"
• "platformVersion"
• "uaFullVersion" Veraltet
• "wow64"

Ein Promise, das auf ein Objekt aufgelöst wird, das einige oder alle der folgenden Werte enthält (basierend auf den angeforderten Hinweisen):

brands

Gibt ein Array von Objekten zurück, das brand und version enthält, welche die Browsermarke und ihre Version angeben (die gleichen Informationen wie von NavigatorUAData.brands bereitgestellt). Beachten Sie, dass diese Informationen in der Sec-CH-UA-Header (ein low-entropy client hint) an einen Server gesendet werden können.

mobile

Gibt true zurück, wenn der User-Agent auf einem mobilen Gerät läuft (die gleichen Informationen wie von NavigatorUAData.mobile bereitgestellt). Beachten Sie, dass diese Informationen in der Sec-CH-UA-Mobile-Header (ein low-entropy client hint) an einen Server gesendet werden können.

platform

Gibt einen String zurück, der die Plattform beschreibt, auf der der User-Agent läuft, wie "Windows" (die gleichen Informationen wie von NavigatorUAData.platform bereitgestellt). Beachten Sie, dass diese Informationen in der Sec-CH-UA-Platform-Header (ein low-entropy client hint) an einen Server gesendet werden können.

architecture

Ein String, der die Plattform-Architektur enthält. Zum Beispiel "x86". Beachten Sie, dass diese Informationen in der Sec-CH-UA-Arch-Header gesendet werden können, nachdem der Server sie explizit in der Accept-CH-Header angefordert hat.

bitness

Ein String, der die Architektur-Bitness enthält. Zum Beispiel "32" oder "64". Beachten Sie, dass diese Informationen in der Sec-CH-UA-Bitness-Header gesendet werden können, wenn der Server sie explizit in der Accept-CH-Header angefordert hat.

formFactor

Ein String, der den Formfaktor eines Geräts enthält. Zum Beispiel "Tablet" oder "VR". Beachten Sie, dass diese Informationen in der Sec-CH-UA-Form-Factors-Header gesendet werden können, wenn der Server sie explizit in der Accept-CH-Header angefordert hat.

fullVersionList

Ein Array von Objekten mit den Eigenschaften "brand" und "version", die den Browsernamen und die vollständige Version darstellen. Zum Beispiel, {"brand": "Google Chrome", "version": "103.0.5060.134"}, {"brand": "Chromium", "version": "103.0.5060.134"}. Bitte beachten Sie, dass ein Objekt absichtlich ungültige Informationen enthalten kann, um zu verhindern, dass Websites sich auf eine feste Liste von Browsern verlassen. Beachten Sie, dass diese Informationen in der Sec-CH-UA-Full-Version-List-Header gesendet werden können, wenn der Server sie explizit in der Accept-CH-Header angefordert hat.

model

Ein String, der das Modell des mobilen Geräts enthält. Zum Beispiel "Pixel 2XL". Wenn das Gerät kein mobiles Gerät ist oder das Gerätemodell nicht bekannt ist, wird model "" sein. Beachten Sie, dass diese Informationen in der Sec-CH-UA-Model-Header gesendet werden können, wenn der Server sie explizit in der Accept-CH-Header angefordert hat.

platformVersion

Ein String, der die Plattformversion enthält. Der Plattformname selbst ist immer als Low-Entropy-Hinweis platform verfügbar. Zum Beispiel "10.0". Beachten Sie, dass diese Informationen in der Sec-CH-UA-Platform-Version-Header gesendet werden können, wenn der Server sie explizit in der Accept-CH-Header angefordert hat.

uaFullVersion Veraltet

Ein String, der die vollständige Browserversion enthält. Zum Beispiel "103.0.5060.134". Veraltet zugunsten von fullVersionList. Beachten Sie, dass diese Informationen in der Sec-CH-UA-Full-Version-Header gesendet werden können, wenn der Server sie explizit in der Accept-CH-Header angefordert hat.

wow64

Ein Boolean, der anzeigt, ob das Binary des User-Agents im 32-Bit-Modus auf einem 64-Bit-Windows läuft. Beachten Sie, dass diese Informationen in der Sec-CH-UA-WoW64-Header gesendet werden können, wenn der Server sie explizit in der Accept-CH-Header angefordert hat.

NotAllowedError DOMException

Wird ausgelöst, wenn der User-Agent entscheidet, dass einer oder mehrere der angeforderten hints nicht zurückgegeben werden sollen.

Im folgenden Beispiel werden mehrere Hinweise mit der getHighEntropyValues()-Methode angefordert. Wenn das Versprechen aufgelöst wird, werden diese Informationen in der Konsole angezeigt.

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

• Diese Werte sind auch über HTTP-Request-Header verfügbar:
  • Low-entropy client hints werden automatisch gesendet:
    • Sec-CH-UA
    • Sec-CH-UA-Mobile
    • Sec-CH-UA-Platform
  • Server können anfordern, dass High-Entropy-Client-Hinweise in nachfolgenden Anfragen gesendet werden, indem sie die Accept-CH-Header verwenden:
    • Sec-CH-UA-Arch
    • Sec-CH-UA-Bitness
    • Sec-CH-UA-Full-Version
    • Sec-CH-UA-Model
    • Sec-CH-UA-Platform-Version