Accept-Language parsen und Sprachpräferenzen sortieren

Jeder Sprachbereich kann einen Gütewert tragen, Einträge mit gleichem Gewicht müssen ihre ursprüngliche Reihenfolge behalten und fehlerhafte Tags sind vor der Inhaltsaushandlung abzulehnen. Dieser Parser wandelt einen Headerwert in eine verlässliche Liste regionaler Präferenzen um. Er vereinheitlicht die Groß- und Kleinschreibung von Sprache, Schrift und Region, bewahrt Platzhalter, prüft Gütewerte und liefert die Auswahl absteigend sortiert für Routing, Tests, Protokolle oder die Sprachauswahl Ihrer Anwendung.

Machen Sie aus dem Header eindeutige Präferenzen

Ein Accept-Language-Header fasst mehrere Wünsche auf engem Raum zusammen. Ein Browser kann zuerst eine regionale Variante, danach die übergeordnete Sprache und zuletzt einen Platzhalter als Rückfall senden. Wird der Wert unmittelbar in jeder Routingstelle verarbeitet, entstehen leicht doppelter Code und widersprüchliche Randfallregeln. Der Parser erzeugt ein Präferenz-Array, dessen Einträge jeweils einen Sprachraum und einen numerischen Gütewert enthalten. Ohne ausdrücklichen Güteparameter gilt der Standardwert 1. Die Liste wird nach absteigender Güte sortiert; bei gleichem Gewicht bleibt die vom Absender vorgegebene Reihenfolge erhalten. Diese Stabilität ist wichtig, weil die Position dann das einzige verbleibende Präferenzsignal ist. Zudem wird die Schreibweise vereinheitlicht: Sprachen erscheinen klein, Regionen aus zwei Buchstaben groß und Schriften aus vier Buchstaben mit großem Anfang. Das Sternchen bleibt unverändert, damit Ihre Anwendung einen allgemeinen Rückfall erkennt und ihn nicht als konkreten Sprachraum behandelt.

Weisen Sie mehrdeutige oder fehlerhafte Eingaben früh ab

Der Header stammt gewöhnlich von einem Client und überschreitet damit eine Vertrauensgrenze. Stille Korrekturen können einen Tippfehler in eine unerwartete Sprachwahl verwandeln. Deshalb weist der Parser ungültige Eingaben ab, anstatt die Absicht zu erraten. Ein Sprachbereich muss mit einem alphabetischen Subtag beginnen und darf durch Bindestriche getrennte alphanumerische Subtags enthalten. Unterstriche, innere Leerzeichen, leere Subtags und Satzzeichen sind ungültig. Als Platzhalter ist nur ein alleinstehendes Sternchen zulässig. Der Güteparameter verwendet q und einen Wert von 0 bis 1 mit höchstens drei Dezimalstellen. Höhere oder negative Werte, unbekannte Parameter sowie wiederholte Semikolons lösen einen Fehler aus. Leere Einträge zwischen Kommas werden ebenfalls abgelehnt. Die festgelegte maximale Headerlänge begrenzt die Verarbeitung. So werden Fehler bereits an der API-Grenze sichtbar und ein nur teilweise gelesener Header kann keine Inhalte auswählen, die der Client nie angefordert hat.

Nutzen Sie das Ergebnis für die Sprachaushandlung

Die sortierte Ausgabe ist eine saubere Grundlage für die Zuordnungsregeln Ihrer Anwendung. Gehen Sie die Präferenzen durch und vergleichen Sie jeden Sprachraum mit Ihren verfügbaren Übersetzungen. Sie können zunächst die genaue regionale Variante suchen, anschließend etwa fr-CA auf die Basissprache zurückführen und zuletzt den Platzhalter oder den Produktstandard verwenden. Der Parser schreibt diese Regeln bewusst nicht vor: Unterstützte Sprachräume, Rückfalllogik und der Umgang mit Güte null hängen von Ihrer Anwendung ab. Die Trennung von Parsen und Auswahl macht das Verhalten in Gateways, serverseitig gerenderten Seiten, API und Analyseabläufen leichter testbar und wiederverwendbar. Falls jemand die falsche Sprache erhält, können Protokolle statt eines undurchsichtigen Headers die strukturierte Liste speichern und die Diagnose vereinfachen. Automatisierte Anfragen kosten jeweils $0.002. Die Browserversion führt dieselbe deterministische Logik lokal aus, sodass Sie Header untersuchen können, ohne deren Inhalt weiterzugeben.