HTTP Sec-CH-UA-Platform-Version Header

Der HTTP-Header Sec-CH-UA-Platform-Version ist ein High-Entropy Request-Header aus den User Agent Client Hints, der die genaue Version des Betriebssystems übermittelt. Er wird nur nach explizitem Opt-In via Accept-CH gesendet und ermöglicht OS-Version-spezifische Workarounds oder Feature-Detection.

Typ

Request-Header

Syntax

Der Header gibt die OS-Version als Quoted String an.

http 
Sec-CH-UA-Platform-Version: "10.0.0"
Sec-CH-UA-Platform-Version: "14.2.0"

Direktiven

Die Direktiven definieren die vollständige Betriebssystem-Version mit Major, Minor und Patch.

"Major.Minor.Patch"
Vollständige OS-Version im Format Major.Minor.Patch. Beispiel: "10.0.0" für Windows 10, "14.2.0" für macOS Sonoma 14.2. Format variiert zwischen Betriebssystemen.
"0.0.0"
Platzhalter-Version wenn präzise Version aus Privacy-Gründen nicht gesendet werden soll oder nicht verfügbar ist.

Beispiele

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

Beispiel 1 Windows 11 Build Number

http 
GET /app HTTP/1.1
Host: software.example.com
Sec-CH-UA-Platform: "Windows"
Sec-CH-UA-Platform-Version: "15.0.0"

Windows 11 (NT Version 10.0.22000+) wird als "15.0.0" gemeldet, Server kann Windows 11-spezifische Features wie Snap Layouts aktivieren.

Beispiel 2 macOS Sonoma mit Patch Level

http 
GET /support HTTP/1.1
Host: help.example.com
Sec-CH-UA-Platform: "macOS"
Sec-CH-UA-Platform-Version: "14.2.1"

macOS 14.2.1 Sonoma, Server prüft gegen Known Issues Database für spezifische Bugfixes in Patch-Release 14.2.1.

Beispiel 3 API Compatibility Check

http 
HTTP/1.1 200 OK
Accept-CH: Sec-CH-UA-Platform-Version
Vary: Sec-CH-UA-Platform-Version

<script>
  if (parseFloat(platformVersion) < 13.0) {
    alert("macOS 13 Ventura or newer required");
  }
</script>

Server fordert Platform-Version an, JavaScript prüft Minimum OS-Requirements für moderne APIs wie SharedArrayBuffer.

OS Version Detection Flow

Platform Version Client Hint Ablauf

Vorteile für die Systemarchitektur

  • OS-Specific Workarounds: Bugs in spezifischen OS-Versionen können gezielt umgangen werden ohne alle Nutzer zu beeinträchtigen
  • API Availability Detection: Moderne Browser-APIs sind oft OS-Version-abhängig, ermöglicht Polyfill-Entscheidungen
  • Security Compliance: Enterprise-Apps können veraltete OS-Versionen mit bekannten Sicherheitslücken blockieren und Update-Aufforderungen zeigen

Spezifikation

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

Weitere Spezifikationen

Sec-CH-UA Header, Accept-CH Header