Rohe HTTP-Header als Schlüssel-Wert-Objekt parsen

Namen werden kleingeschrieben, äußerer Leerraum wird aus Werten entfernt und wiederholte Namen wie Set-Cookie bleiben in ihrer Reihenfolge als Arrays erhalten, statt überschrieben zu werden. Jede nicht leere Zeile muss dem Aufbau Name: Value entsprechen. Andernfalls erhalten Sie eine klare Fehlermeldung und niemals ein unvollständiges Teilergebnis.

Machen Sie aus kopierten Header-Blöcken strukturierte Daten

Entwicklerwerkzeuge im Browser, Kommandozeilenprogramme, Reverse-Proxys und Serverprotokolle zeigen HTTP-Header häufig als einfache Textzeilen an. Für Menschen ist das gut lesbar, doch Code kann dieses Format nur umständlich durchsuchen, vergleichen oder speichern. Dieser Parser wandelt jede gültige Zeile im Format Name: Value in eine Eigenschaft innerhalb eines einzigen headers-Objekts um. Namen werden kleingeschrieben, weil HTTP-Feldnamen nicht zwischen Groß- und Kleinschreibung unterscheiden. Content-Type und content-type ergeben deshalb dieselbe Eigenschaft. Leerraum rund um den Wert wird entfernt, Doppelpunkte innerhalb des Werts bleiben dagegen unverändert. Das ist bei Zeitangaben, URLs, Autorisierungsschemata und anderen Werten mit zulässigen Satzzeichen wichtig. Sie können das Ergebnis direkt in eine Test-Fixture übernehmen, an ein weiteres Skript übergeben oder mit einer erwarteten Antwort vergleichen. Eine abschließende Leerzeile ist erlaubt, da sie bei kopierten HTTP-Blöcken oft den Nachrichtenkörper abtrennt. Leere oder ungültige Zeilen innerhalb des Blocks werden abgelehnt, damit eine unvollständige Auswertung nicht erfolgreich erscheint.

Bewahren Sie doppelte Header ohne Informationsverlust

Ein gewöhnliches JavaScript-Objekt speichert pro Schlüssel nur einen Wert. Ein einfacher Parser überschreibt daher frühere Werte, sobald derselbe Name erneut vorkommt. Dadurch können wichtige Protokolldaten unbemerkt verloren gehen. Diese Funktion gibt bei einem einmaligen Header eine Zeichenfolge zurück und wandelt die Eigenschaft in ein Array um, wenn derselbe Name unabhängig von der Schreibweise wiederkehrt. Weitere Vorkommen werden in ursprünglicher Reihenfolge angehängt. Die Regel gilt für Set-Cookie, Warning, Link und alle anderen wiederholten Felder, ohne Werte automatisch durch Kommas zusammenzuführen. Das ist beabsichtigt: Verschiedene Header besitzen unterschiedliche Kombinationsregeln, und insbesondere Set-Cookie darf nicht wie eine allgemeine kommagetrennte Liste behandelt werden. Ein leerer Wert ist gültig, sofern der Doppelpunkt vorhanden ist; X-Optional: wird deshalb zu einer leeren Zeichenfolge und nicht zu einem Fehler. Der Parser deutet weder Datumsangaben noch Cookies, Medientypen, Qualitätsgewichte oder Zugangsdaten. Er erhält die Feldwerte als Text, damit eine fachkundige nachgelagerte Komponente sie auswerten kann.

Erkennen Sie fehlerhafte Zeilen frühzeitig

Zuverlässiges Parsen bedeutet nicht nur korrektes Umwandeln, sondern auch konsequentes Ablehnen. Jede Zeile muss mit einem gültigen HTTP-Feldnamen beginnen, unmittelbar gefolgt von einem Doppelpunkt und dem Wert. Feldnamen dürfen die von HTTP zugelassenen Token-Zeichen enthalten, jedoch keine Leerzeichen, Tabulatoren, Klammern, Trennzeichen oder führenden Einrückungen. Veraltete gefaltete Fortsetzungszeilen werden abgelehnt, statt sie an den vorherigen Wert anzuhängen. Das verhindert mehrdeutige Ergebnisse und fördert moderne, normalisierte Eingaben. Schlägt die Prüfung fehl, nennt der Fehler die betroffene Zeile und unterscheidet zwischen einem ungültigen Paar und einem ungültigen Namen. Ein Teilobjekt wird nie zurückgegeben. Damit eignet sich die Funktion für Importabläufe und automatisierte Tests, bei denen ein halber Block gefährlicher wäre als ein Abbruch. Die Verarbeitung ist lokal und deterministisch: Es gibt keine Netzwerkanfragen, zeitabhängigen Felder, Zufallswerte oder externen Abfragen. Derselbe Text erzeugt im Browser und über die API dieselbe JSON-Struktur; der API-Grundpreis beträgt $0.002.