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 erhalten möchte. Wenn ein Client, der Client-Hinweise unterstützt, den Accept-CH-Header erhält, kann er einige oder alle der aufgelisteten Client-Hinweis-Header in seine anschließenden Anfragen einfügen.

Zum Beispiel könnte der Client nach einem Accept-CH in einer unten stehenden Antwort die Header Width, Downlink und Sec-CH-UA zu allen nachfolgenden Anfragen 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 es dem Client überlassen bleibt zu entscheiden, welche Informationen er sicher weitergeben kann.

Es gibt eine kleine Reihe von Client-Hinweis-Headern mit geringer Entropie, die von einem Client gesendet werden können, auch wenn sie nicht angefordert werden.

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

Vary: Accept, Width, ECT

Sie möchten möglicherweise darauf verzichten, Vary anzugeben, oder eine andere Strategie für Client-Hinweis-Header verwenden, deren Wert sich häufig ändert, da dies die Ressource faktisch uncacheable macht. (Für jeden eindeutigen Wert wird ein neuer Cache-Eintrag erstellt.) Dies gilt insbesondere für Netzwerk-Client-Hinweise wie Downlink und RTT. Weitere Informationen finden Sie unter HTTP-Caching > Vary.

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

Mit anderen Worten, die Anfrage nach einer bestimmten Reihe von Hinweisen läuft nicht ab, bis der Browser heruntergefahren wird.

Ein Server kann die Menge der Client-Hinweise, die er erhalten möchte, durch erneutes Senden des Accept-CH-Antwort-Headers mit einer neuen Liste ersetzen. Um zum Beispiel keine Hinweise mehr anzufordern, würde er Accept-CH mit einer leeren Liste senden.

Client-Hinweise werden im Allgemeinen in solche mit hoher und niedriger Entropie unterteilt. Hinweise mit niedriger Entropie sind solche, die nicht viele Informationen preisgeben, die für die Erstellung eines Fingerabdrucks eines Benutzers verwendet werden könnten. Sie können standardmäßig bei jeder Client-Anfrage 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 für die Erstellung eines Benutzers Fingerabdruck verwendet werden könnten, und daher so gesteuert werden, dass der Benutzeragent eine Entscheidung treffen kann, ob er sie bereitstellt. Die Entscheidung könnte auf Benutzerpräferenzen, einer Berechtigungsanforderung oder der Berechtigungsrichtlinie basieren. Alle Client-Hinweise, die keine 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 ändern könnte, potenziell auf eine Weise, die störend ist oder die Benutzerfreundlichkeit beeinträchtigt, und die daher vor der Inhaltsdarstellung angewendet werden muss. Zum Beispiel wird Sec-CH-Prefers-Reduced-Motion oft als kritischer Hinweis behandelt, da er das Verhalten von Animationen stark beeinflussen könnte und weil ein Benutzer, der diese Präferenz wählt, sie gesetzt 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 enthalten sein). Benutzeragenten, die eine Antwort mit Critical-CH empfangen, müssen prüfen, ob die angegebenen kritischen Header in der ursprünglichen Anfrage gesendet wurden. Falls nicht, wird der Benutzeragent die Anfrage erneut ausführen, anstatt die Seite darzustellen. Diese Vorgehensweise stellt sicher, dass die durch kritische Client-Hinweise gesetzten Benutzereinstellungen immer verwendet werden, auch wenn sie in der ersten Anfrage nicht enthalten waren oder sich die Serverkonfiguration ändert.

Zum Beispiel informiert der Server in diesem Fall einen Client über Accept-CH, 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 in der ursprünglichen Anfrage nicht enthalten war, führt der Client die Anfrage automatisch erneut aus - diesmal teilt er dem Server über Sec-CH-Prefers-Reduced-Motion mit, dass er eine Benutzerpräferenz für reduzierte Bewegungsanimationen hat.

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

Benutzeragenten (UA) Client-Hinweis-Header erlauben es einem Server, Antworten basierend auf dem Benutzeragent (Browser), Betriebssystem und Gerät zu variieren. Eine Liste der Sec-CH-UA-*-Header finden Sie unter Benutzeragenten-Client-Hinweis-Header.

Client-Hinweise sind für JavaScript auf Webseiten über die Benutzeragenten-Client-Hinweis-API verfügbar.

Benutzerpräferenz-Medienfeatures-Client-Hinweise erlauben es einem Server, Antworten basierend auf den Vorlieben eines Benutzeragenten für CSS-Medienfeatures wie Farbgebung oder reduzierte Bewegung zu variieren. Header beinhalten: Sec-CH-Prefers-Reduced-Motion, Sec-CH-Prefers-Color-Scheme.

Geräte-Client-Hinweise ermöglichen es einem Server, Antworten basierend auf den Geräteeigenschaften, einschließlich verfügbarem Speicher und Bildschirm-Eigenschaften, zu variieren. Header beinhalten: Device-Memory, Width, Viewport-Width.

Netzwerk-Client-Hinweise erlauben es einem Server, Antworten basierend auf der Wahl des Benutzers, der Netzwerkbandbreite und der Latenz zu variieren. Header beinhalten: Save-Data, Downlink, ECT, RTT.

• Client-Hints-Header
• Vary HTTP-Header
• Client-Hints-Infrastruktur
• Benutzeragenten-Client-Hinweis-API
• Verbesserung der Benutzerprivatsphäre und der Entwicklererfahrung mit Benutzeragenten-Client-Hinweisen (developer.chrome.com)