Der HTTPAccept-LanguageAnforderungsheader gibt die natürliche Sprache und das Gebietsschema an, die der Client bevorzugt. Der Server verwendet dieInhaltsaushandlung, um einen der Vorschläge auszuwählen und teilt dem Client die Auswahl mit demContent-Language Antwortheader mit. Browser legen die erforderlichen Werte für diesen Header entsprechend ihrer aktiven Benutzeroberflächensprache fest. Benutzer können auch zusätzliche bevorzugte Sprachen über die Browsereinstellungen konfigurieren.

DerAccept-Language-Header listet im Allgemeinen die gleichen Gebietsschemas wie dienavigator.languages-Eigenschaft auf, mit abnehmendenq-Werten (Qualitätswerte). Einige Browser, wie Chrome und Safari, fügen imAccept-Language-Header Nur-Sprache-Fallback-Tags hinzu. Zum Beispielen-US,en;q=0.9,zh-CN;q=0.8,zh;q=0.7, wennnavigator.languages["en-US", "zh-CN"] ist. Aus Datenschutzgründen (zur Reduzierung vonFingerprinting) können sowohlAccept-Language als auchnavigator.languages nicht die vollständige Liste der Benutzerpräferenzen enthalten. Zum Beispiel wird in Safari (immer) und im Chrome-Inkognito-Modus nur eine Sprache aufgelistet.

Dieser Header dient als Hinweis, wenn der Server die Zielsprache des Inhalts nicht anders bestimmen kann (z. B. wenn eine spezifische URL verwendet wird, die von einer expliziten Benutzerentscheidung abhängt). Der Server sollte niemals eine explizite Sprachauswahl des Benutzers außer Kraft setzen. Der Inhalt vonAccept-Language liegt oft außerhalb der Kontrolle des Benutzers (z. B. beim Reisen). Ein Benutzer möchte möglicherweise auch eine Seite in einer anderen Sprache besuchen als der Sprache der Benutzeroberfläche.

Der Server kann einen406 Not Acceptable Fehlercode zurücksenden, wenn er den Inhalt in keiner passenden Sprache bereitstellen kann, aber dies wird selten implementiert. Server ignorieren oft denAccept-Language-Header in solchen Fällen und senden stattdessen eine erfolgreiche Antwort mit der am besten geeigneten Ressource für ein besseres Benutzererlebnis.

* Werte können nur0-9,A-Z,a-z, Leerzeichen oder die Zeichen*,-.;= sein.

Syntax

Accept-Language: <language>Accept-Language: *// Multiple types, weighted with the quality value syntax:Accept-Language: fr-CH, fr;q=0.9, en;q=0.8, de;q=0.7, *;q=0.5

Direktiven

<language>

Ein Sprach-Tag (manchmal als "Gebietsschema-Bezeichner" bezeichnet). Dies besteht aus einem 2-3 Buchstaben umfassenden Basis-Sprach-Tag, das eine Sprache angibt, gefolgt von optionalen zusätzlichen Untertags, die durch- getrennt sind. Die häufigsten zusätzlichen Informationen sind die Länder- oder Regionsvarianten (wieen-US oderfr-CA) oder die Art des verwendeten Alphabets (wiesr-Latn). Andere Varianten, wie der Typ der Orthographie (de-DE-1996), werden im Kontext dieses Headers normalerweise nicht verwendet.

* (Wildcard)

Jede Sprache, die von keiner anderen imAccept-Language-Feld vorhandenen Sprache abgedeckt wird.

;q= (q-Faktor-Gewichtung)

Jeder Wert, der in einer Reihenfolge der Präferenz mittels eines relativenQualitätswertes ausgedrückt wird, wird alsGewichtung bezeichnet. Der Qualitätswert hat standardmäßig1.

Beispiele

Verwendung von Accept-Language-Headern

Die folgende Anfrage hat eine Präferenz für Deutsch, indem die Basissprachede verwendet wird:

Accept-Language: de

Verwendung von Qualitätswerten in Accept-Language

Die folgende Anfrage zeigt eine stärkere Präferenz für Dänisch an, akzeptiert aber Britisches Englisch und andere Arten von Englisch mit niedrigerer Priorität:

Accept-Language: da, en-gb;q=0.8, en;q=0.7

Spezifikationen

Browser-Kompatibilität

Siehe auch

• HTTPInhaltsaushandlung
• Ein Header mit dem Ergebnis der Inhaltsaushandlung:Content-Language
• Andere ähnliche Header:TE,Accept-Encoding,Accept