Sec-CH-UA

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.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Der HTTP Sec-CH-UA Request-Header ist ein User-Agent Client Hint, der die Marken- und signifikante Versionsinformation des User-Agents bereitstellt.

Der Sec-CH-UA Header liefert die Marke und die signifikante Version für jede brand mit dem Browser assoziierten Marke in einer kommagetrennten Liste. Der Header ermöglicht es dem Server daher, seine Antwort basierend sowohl auf freigegebenen Marken als auch auf bestimmten Anpassungen in ihren jeweiligen Versionen anzupassen.

Sec-CH-UA ist ein Low Entropy Hint. Sofern nicht durch eine Benutzeragenten-Berechtigungsrichtlinie blockiert, wird er standardmäßig gesendet, ohne dass der Server durch Senden von Accept-CH zustimmen muss.

Der Header kann „falsche“ Marken in jeder Position und mit jedem Namen enthalten. Dies ist ein Feature, das verhindern soll, dass Server unbekannte User-Agents sofort ablehnen und Benutzeragenten zwingt, über ihre Markenidentität zu lügen.

Hinweis: Der Sec-CH-UA-Full-Version-List Header ist identisch mit Sec-CH-UA, enthält jedoch die vollständige Versionsnummer anstelle der signifikanten Versionsnummer für jede Marke.

Header-Typ Request-Header, Client Hint
Verbotener Request-Header Ja (Sec- Präfix)

Syntax

Eine kommagetrennte Liste von Marken in der User-Agent Marktliste und deren zugehöriger signifikanten Versionsnummer. Die Syntax für einen einzelnen Eintrag hat folgendes Format:

http
Sec-CH-UA: "<brand>";v="<significant version>", …

Direktiven

<brand>

Eine Marke, die mit dem User-Agent verbunden ist, wie „Chromium“, „Google Chrome“ oder eine absichtlich falsche Marke wie „Not A;Brand“.

<significant version>

Die "Marketing"-Versionsnummer, die mit unterscheidbaren web-exponierten Features assoziiert ist.

Beschreibung

Eine Marke ist ein Handelsname für den User-Agent, wie: Chromium, Opera, Google Chrome, Microsoft Edge, Firefox und Safari. Ein User-Agent kann mehrere zugehörige Marken haben. Beispielsweise basieren Opera, Chrome und Edge alle auf Chromium und werden sowohl Marken im Sec-CH-UA Header bereitstellen.

Die signifikante Version ist der "Marketing"-Versionsbezeichner, der verwendet wird, um zwischen Hauptversionen der Marke zu unterscheiden. Beispielsweise hat ein Chromium-Build mit vollständiger Versionsnummer "96.0.4664.45" eine signifikante Versionsnummer von "96".

Beispiele

Verschiedene Sec-CH-UA Marken

Sec-CH-UA ist ein Low Entropy Hint. Sofern nicht explizit durch eine Benutzeragentenrichtlinie blockiert, wird er in allen Anfragen gesendet (ohne dass der Server durch Senden von Accept-CH zustimmen muss).

Zeichenfolgen von Chromium-, Chrome-, Edge- und Opera-Desktop-Browsern werden unten angezeigt. Beachten Sie, dass sie alle die Marke "Chromium" teilen, jedoch eine zusätzliche Marke haben, die ihre Herkunft anzeigt. Sie haben auch eine absichtlich falsche Markenzeichenfolge, die in beliebiger Position erscheinen und unterschiedlichen Text haben kann.

http
Sec-CH-UA: "(Not(A:Brand";v="8", "Chromium";v="98"
http
Sec-CH-UA: " Not A;Brand";v="99", "Chromium";v="96", "Google Chrome";v="96"
http
Sec-CH-UA: " Not A;Brand";v="99", "Chromium";v="96", "Microsoft Edge";v="96"
http
Sec-CH-UA: "Opera";v="81", " Not;A Brand";v="99", "Chromium";v="95"

Spezifikationen

Specification
User-Agent Client Hints
# sec-ch-ua

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch