HTTP-Client-Hinweise

Ein Server muss ankündigen, dass er Client-Hinweise unterstützt, indem er den Accept-CH-Header verwendet, um die Hinweise anzugeben, die er zu erhalten wünscht. Wenn ein Client, der Client-Hinweise unterstützt, den Accept-CH-Header erhält, kann er entscheiden, einige oder alle der aufgeführten Client-Hinweis-Header in seinen nachfolgenden Anforderungen hinzuzufügen.

Zum Beispiel könnte der Client nach einem Accept-CH-Header in einer Antwort die Header Width, Downlink und Sec-CH-UA zu allen nachfolgenden Anforderungen hinzufügen.

Accept-CH: Width, Downlink, Sec-CH-UA

Dieser Ansatz ist effizient, da der Server nur die Informationen anfordert, die er sinnvoll verarbeiten kann. Er ist auch relativ "datenschutzfreundlich", da der Client entscheidet, welche Informationen er sicher mitteilen kann.

Es gibt einen kleinen Satz von Client-Hinweis-Headern mit niedriger Entropie, die von einem Client gesendet werden können, auch wenn sie nicht angefordert wurden.

<meta http-equiv="Accept-CH" content="Width, Downlink, Sec-CH-UA" />

Client-Hinweise, die bestimmen, welche Ressourcen in Antworten gesendet werden, sollten in der Regel auch im Vary-Header der betroffenen Antwort enthalten sein. Dies stellt sicher, dass für jeden unterschiedlichen Wert des Hinweis-Headers eine andere Ressource zwischengespeichert wird.

Vary: Accept, Width, ECT

Es könnte bevorzugt werden, Vary nicht anzugeben oder eine andere Strategie für Client-Hinweis-Header zu verwenden, bei denen sich der Wert häufig ändert, da dies die Ressource effektiv uncacheable macht. (Für jeden einzigartigen Wert wird ein neuer Cache-Eintrag erstellt.) Dies gilt insbesondere für Netzwerk-Client-Hinweise wie Downlink und RTT. Für weitere Informationen siehe HTTP Caching > Vary.

Ein Server gibt die Client-Hinweis-Header an, die er im Accept-CH-Antwort-Header erhalten möchte. Der Nutzeragent fügt die angeforderten Client-Hinweis-Header, oder zumindest die Teilmenge, die er mit diesem Server teilen möchte, zu allen nachfolgenden Anforderungen in der aktuellen Browsersitzung hinzu.

Mit anderen Worten, die Anforderung für eine spezifische Reihe von Hinweisen läuft nicht ab, bis der Browser heruntergefahren wird.

Ein Server kann die Reihe der Client-Hinweise, die er zu erhalten wünscht, ersetzen, indem er den Accept-CH-Antwort-Header mit einer neuen Liste erneut sendet. Um zum Beispiel keine Hinweise mehr anzufordern, würde er Accept-CH mit einer leeren Liste senden.

Client-Hinweise werden grob in Hinweis mit hoher und niedriger Entropie unterteilt. Die Hinweise mit niedriger Entropie sind diejenigen, die nicht viele Informationen preisgeben, die zum Erstellen eines Fingerabdrucks eines Nutzers verwendet werden könnten. Sie können standardmäßig bei jeder Client-Anforderung gesendet werden, unabhängig vom Accept-CH-Antwort-Header des Servers, abhängig von der Berechtigungsrichtlinie. Hinweise mit niedriger Entropie sind:

• Save-Data,
• Sec-CH-UA,
• Sec-CH-UA-Mobile, und
• Sec-CH-UA-Platform.

Hinweise mit hoher Entropie sind solche, die potenziell mehr Informationen preisgeben, die zur Erstellung eines Nutzer-Fingerabdrucks verwendet werden können, und daher so kontrolliert werden, dass der Nutzeragent entscheiden kann, ob er diese bereitstellen möchte. Die Entscheidung könnte auf Nutzerpräferenzen, einer Berechtigungsanforderung oder der Berechtigungsrichtlinie basieren. Alle Client-Hinweise, die nicht Hinweise mit niedriger Entropie sind, werden als Hinweise mit hoher Entropie betrachtet.

Ein kritischer Client-Hinweis ist einer, bei dem die Anwendung der Antwort die gerenderte Seite erheblich verändern könnte, möglicherweise auf eine störende Weise oder die Benutzbarkeit beeinträchtigt, und daher vor der Darstellung des Inhalts angewandt werden muss. Zum Beispiel wird Sec-CH-Prefers-Reduced-Motion häufig als kritischer Hinweis behandelt, da er das Verhalten von Animationen erheblich beeinflussen könnte und weil ein Nutzer, der diese Präferenz auswählt, sie eingestellt haben muss.

Ein Server kann den Critical-CH-Antwort-Header zusammen mit Accept-CH verwenden, um anzugeben, dass ein akzeptierter Client-Hinweis auch ein kritischer Client-Hinweis ist (ein Header in Critical-CH muss auch in Accept-CH erscheinen). Nutzeragenten, die eine Antwort mit Critical-CH erhalten, müssen prüfen, ob die angegebenen kritischen Header in der ursprünglichen Anforderung gesendet wurden. Falls nicht, wird der Nutzeragent die Anforderung erneut senden, anstatt die Seite darzustellen. Dieser Ansatz stellt sicher, dass die mit kritischen Client-Hinweisen gesetzten Client-Präferenzen immer verwendet werden, selbst wenn sie nicht in der ersten Anforderung enthalten sind oder sich die Serverkonfiguration ändert.

Zum Beispiel teilt in diesem Fall der Server einem Client über Accept-CH mit, dass er Sec-CH-Prefers-Reduced-Motion akzeptiert, und Critical-CH wird verwendet, um anzugeben, dass Sec-CH-Prefers-Reduced-Motion als kritischer Client-Hinweis betrachtet wird:

HTTP/1.1 200 OK
Content-Type: text/html
Accept-CH: Sec-CH-Prefers-Reduced-Motion
Vary: Sec-CH-Prefers-Reduced-Motion
Critical-CH: Sec-CH-Prefers-Reduced-Motion

Da Sec-CH-Prefers-Reduced-Motion ein kritischer Hinweis ist, der nicht in der ursprünglichen Anforderung enthalten war, wiederholt der Client die Anforderung automatisch — diesmal teilt er dem Server über Sec-CH-Prefers-Reduced-Motion mit, dass er eine Nutzerpräferenz für Animationen mit reduzierter Bewegung hat.

GET / HTTP/1.1
Host: example.com
Sec-CH-Prefers-Reduced-Motion: "reduce"

Header für Nutzeragenten (UA)-Client-Hinweise ermöglichen es einem Server, Antworten basierend auf dem Nutzeragenten (Browser), dem Betriebssystem und dem Gerät zu variieren. Eine Liste der Sec-CH-UA-*-Header finden Sie unter User agent client hints headers.

Client-Hinweise sind über die User Agent Client Hints API für JavaScript auf Webseiten verfügbar.

Client-Hinweise für Medienmerkmale der Nutzerpräferenz ermöglichen es einem Server, Antworten basierend auf den Präferenzen eines Nutzeragenten für CSS-Medienmerkmale wie Farbschema oder reduzierte Bewegung zu variieren. Header umfassen: Sec-CH-Prefers-Reduced-Motion, Sec-CH-Prefers-Color-Scheme.

Hinweise des Geräte-Clients ermöglichen es einem Server, Antworten basierend auf Geräteeigenschaften, einschließlich verfügbarem Speicher und Bildschirmmerkmalen, zu variieren. Header umfassen: Device-Memory, Width, Viewport-Width.

Netzwerk-Client-Hinweise ermöglichen es einem Server, Antworten basierend auf der Wahl des Nutzers, der Netzwerkbandbreite und der Latenz zu variieren. Header umfassen: Save-Data, Downlink, ECT, RTT.

• Client-Hints-Header
• Vary HTTP-Header
• Client-Hints-Infrastruktur
• User Agent Client Hints API
• Verbesserung der Benutzer-Privatsphäre und der Entwicklererfahrung mit User-Agent-Client-Hinweisen (developer.chrome.com)