URL kodieren & dekodieren

Eine URL darf nur eine begrenzte Auswahl an ASCII-Zeichen enthalten. RFC 3986, die Spezifikation für die URI-Syntax von 2005, teilt sie in zwei Gruppen ein. Die nicht reservierten Zeichen, A–Z, a–z, 0–9 und die vier Zeichen - . _ ~, müssen nie kodiert werden. Die reservierten Zeichen haben eine Aufgabe: Die allgemeinen Trennzeichen : / ? # [ ] @ trennen Schema, Host, Pfad, Query und Fragment, und die Unter-Trennzeichen ! $ & ' ( ) * + , ; = trennen Elemente innerhalb davon, so wie & und = in einem Query-String. Alles andere sowie jedes reservierte Zeichen, das als normaler Inhalt dient, muss prozentkodiert werden.

Die Prozentkodierung schreibt ein Byte als % gefolgt von zwei Hexadezimalziffern. Text wird zuerst in UTF-8 umgewandelt: Ein Leerzeichen wird zu %20, ein é (zwei Bytes) zu %C3%A9 und ein Emoji zu vier %XX-Gruppen. Deshalb landet die Suche nach „café & bar“ als caf%C3%A9%20%26%20bar in einem Link: Das & wird kodiert, damit der Server es nicht als Beginn eines neuen Parameters liest.

encodeURIComponent ist die richtige Wahl für ein einzelnes Teilstück, etwa einen Query-Wert, ein Pfadsegment oder eine als Parameter übergebene Weiterleitungs-URL. Es maskiert alles außer den nicht reservierten Zeichen und ! ' ( ) *, die JavaScript aus historischen Gründen unverändert lässt. encodeURI (ganze URL) geht davon aus, dass die Eingabe bereits eine vollständige Adresse ist, und lässt die reservierten Zeichen unangetastet, sodass bei https://example.com/a b?q=1 nur das Leerzeichen kodiert wird. encodeURI auf einen Parameterwert anzuwenden ist ein klassischer Fehler: Ein & oder # im Wert bliebe erhalten und würde die URL zerstören.

Dekodieren kehrt beide Funktionen um. HTML-Formulare, die per GET gesendet werden, nutzen das ältere Format application/x-www-form-urlencoded, in dem ein Leerzeichen als + statt als %20 geschrieben wird. Lassen Sie dafür Treat + as a space angehakt und entfernen Sie den Haken, wenn ein echtes Pluszeichen wichtig ist, etwa in einer Telefonnummer. Enthält die Eingabe ein % ohne zwei folgende Hexadezimalziffern oder Bytes, die kein gültiges UTF-8 sind, schlägt das Dekodieren mit einer klaren Meldung fehl, statt zu raten. Enthält der Text einen Query-String, erscheinen seine Parameter dekodiert in einer Tabelle unter dem Tool. Für Binärdaten in URLs ist Base64url die übliche Alternative.