HTTP Sec-CH-UA-Full-Version Header

Der HTTP-Header Sec-CH-UA-Full-Version ist ein High-Entropy Request-Header aus den User Agent Client Hints, der die vollständige Browser-Version im Format Major.Minor.Patch übermittelt. Dieser Header ist deprecated und wurde durch Sec-CH-UA-Full-Version-List ersetzt, sollte aber für Legacy-Support noch unterstützt werden.

Typ

Request-Header

Syntax

Der Header gibt die vollständige Versionsnummer als Quoted String an.

http
Sec-CH-UA-Full-Version: "120.0.6099.109"

Direktiven

Die Direktiven definieren die vollständige Browser-Version mit allen Komponenten.

"Major.Minor.Build.Patch"
Vollständige Versionsnummer mit allen Komponenten. Beispiel: "120.0.6099.109" für Chrome 120. Format variiert zwischen Browsern, typisch 3-4 numerische Komponenten.
"" (Empty String)
Leerer String wenn Browser keine detaillierte Version preisgeben möchte. Privacy-bewusste Implementierungen können Informationen reduzieren.

Beispiele

Nachfolgend finden Sie praktische Anwendungsbeispiele für den Sec-CH-UA-Full-Version-Header.

Beispiel 1 Chrome Bugfix Version Detection

http
GET /api/check HTTP/1.1
Host: support.example.com
Sec-CH-UA: "Google Chrome";v="120"
Sec-CH-UA-Full-Version: "120.0.6099.109"

Server erhält vollständige Version zur Prüfung, ob spezifischer Bugfix in Build 6099.109 vorhanden ist für Known-Issue-Workarounds.

Beispiel 2 Analytics und Telemetry

http
POST /telemetry HTTP/1.1
Host: analytics.example.com
Sec-CH-UA-Full-Version: "120.0.6099.71"
Content-Type: application/json

{"event": "page_crash", "version": "120.0.6099.71"}

Crash-Reports enthalten exakte Version für Bug-Tracking. Team kann prüfen, ob Issue in späterem Patch-Release bereits gefixt wurde.

Beispiel 3 Migration zu Full-Version-List

http
HTTP/1.1 200 OK
Accept-CH: Sec-CH-UA-Full-Version-List
Deprecation: true
Sunset: Sun, 01 Jan 2026 00:00:00 GMT

<!-- Migrate to Sec-CH-UA-Full-Version-List -->

Server fordert moderneren Full-Version-List Header an und signalisiert via Deprecation-Header, dass Full-Version nicht mehr lange unterstützt wird.

Version Detection Flow

Full Version Client Hint Ablauf

Vorteile für die Systemarchitektur

  • Granulare Bug-Detection: Patch-Level Version erlaubt Workarounds für spezifische Bugs, die nur in bestimmten Builds existieren
  • Security Vulnerability Tracking: CVE-Advisories referenzieren oft exakte Versionen, ermöglicht proaktive Nutzer-Warnings bei bekannten Schwachstellen
  • Regression Analysis: A/B-Tests können performance-Unterschiede zwischen Minor-Versionen identifizieren und Regressions-Ursachen eingrenzen

Spezifikation

User-Agent Client Hints – WICG Draft (Deprecated) https://wicg.github.io/ua-client-hints/

Weitere Spezifikationen

Sec-CH-UA Header, Accept-CH Header