~2026-15133-49: JavaScript-Unterstützung

2026-03-09T11:46:37Z

JavaScript-Unterstützung

Neue Seite

'''URL-Encoding''' ('''URL-Kodierung''', auch '''Prozentkodierung''' genannt) ist ein Mechanismus, der dazu dient, Informationen in einer [[Uniform Resource Locator|URL]] unter bestimmten Gegebenheiten zu [[Code|kodieren]]. Zur Kodierung werden nur bestimmte Zeichen des [[American Standard Code for Information Interchange|ASCII]]-Zeichensatzes verwendet.

Ohne diese Kodierung wären einige Informationen nicht in einer URL darstellbar. Beispielsweise wird ein [[Leerzeichen]] in aller Regel vom Browser als Ende der URL interpretiert, nachfolgende Zeichen würden ignoriert oder führten zu einem Fehler. Mit der URL-Kodierung kann ein Leerzeichen durch die Zeichenfolge <code>%20</code> übergeben werden. <nowiki>RFC 3986</nowiki><ref>{{RFC-Internet |RFC=3986 |Titel=Uniform Resource Identifier (URI): Generic Syntax |Datum=2005-01}}</ref> definiert einen Standard, wie eine [[Uniform Resource Identifier|URI]] (und damit auch eine URL) syntaktisch aufgebaut sein sollte und unter welchen Bedingungen die URL-Kodierung Anwendung findet.

Auch für nicht im ASCII-Zeichensatz enthaltene Zeichen wird die URL-Kodierung mit dem [[Prozentzeichen]] eingesetzt. Hier gibt es jedoch bisher nur eine Empfehlung im <nowiki>RFC 3986</nowiki>, ein verbindlicher Standard fehlt noch.

== Reservierte und nicht reservierte Zeichen ==
URLs können aus folgenden Teilen bestehen:
<pre>
https://maxmuster:geheim@www.example.com:8080/index.html?p1=A&p2=B#ressource
\___/ \_______/ \____/ \_____________/ \__/\_________/ \_______/ \_______/
| | | | | | | |
Schema Benutzer Kennwort Host Port Pfad Query Fragment
</pre>
Bestimmte Zeichen innerhalb dieses Ausdrucks kennzeichnen und trennen die einzelnen Segmente der URL und ermöglichen eine Zerlegung und Verarbeitung des Ausdrucks. Bei einem [[Hypertext Transfer Protocol|HTTP]]-Zugriff beispielsweise:

* leitet das [[Fragezeichen]] (<code>?</code>) den [[Query-String]] der URL ein,
* steht das [[Gleichheitszeichen]] (<code>=</code>) zwischen dem Namen eines Parameters und seinem Wert,
* steht das [[Et-Zeichen]] (<code>&</code>) als Trennzeichen zwischen Parametern im Query-String,
* folgt dem [[Rautezeichen]] (<code>#</code>) der Name eines [[Anker (HTML)|Dokumentenankers]] (siehe auch [[Uniform Resource Identifier#URI-Referenzen|URI-Referenzen]]).

Weitere Zeichen haben spezifische Bedeutungen im [[Pfadname|Dokumentenpfad]]. Folgende Zeichen gelten als reserviert:

* <code>: / ? # [ ] @ ! $ % & ' ( ) * + , ; =</code>

Folgende Zeichen sind nicht reserviert, besitzen also in einer URL keine vorgegebene Bedeutung:

* Buchstaben: <code>A–Z, a–z</code>
* Ziffern: <code>0–9</code>
* <code>- . _ ~</code>

== Arten ==
=== Prozentdarstellung ===
Eine URL besteht aus den genannten reservierten und nicht reservierten Zeichen. Sie darf keine anderen Zeichen enthalten. Es besteht jedoch prinzipiell der Bedarf, in URLs beliebige [[Byte]]-Folgen – also sämtliche Werte zwischen 0 und 255 – darstellen zu können. Zudem muss eine Möglichkeit existieren, reservierte Zeichen in einer URL derart schreiben zu können, dass sie ihre speziellen Bedeutungen verlieren (siehe auch [[Escape-Sequenz]]).

Die Prozentdarstellung von Zeichen trägt beiden Forderungen Rechnung. Ihr zugrunde liegt ein Kodierungsverfahren, das jedem Zeichencode eine dreistellige Zeichenkombination zuordnet, die mit dem Prozentzeichen beginnt, dem die zweiziffrige [[Hexadezimalsystem|hexadezimale]] Darstellung des Zeichencodes folgt.

Ein reserviertes Zeichen muss in einer URL in prozentkodierter Form geschrieben werden, wenn es an der Stelle, an der es sich befindet, eine besondere Bedeutung hat, diese aber im vorliegenden Kontext nicht haben soll. Nicht reservierte Zeichen können, sollten aber nicht, prozentkodiert werden. Bei anderen Zeichen (unter anderem Binärdaten) besteht meist gar keine andere Möglichkeit, als sie in einer URL in prozentkodierter Form darzustellen (Ausnahme: reserviertes Zeichen ‚<code>+</code>‘ anstelle eines [[Leerzeichen]]s im Query-String).

<div class="hintergrundfarbe1 rahmenfarbe1" style="border-style:solid; display:table; padding:1em;">
'''Beispiel:'''
Laut ASCII ist dem Zeichen ‚<code>#</code>‘ der hexadezimale Zeichencode 23 zugeordnet. Somit stellt der Ausdruck ‚<code>%23</code>‘ die prozent-kodierte Form des Zeichens ‚<code>#</code>‘ dar.

Die Interpretation von:
<pre>
http://www.example.net/index.html?session=A54C6FE2#info
</pre>
ist eindeutig. Es wurde ein URL-Parameter namens <code>session</code> definiert, dem der Wert <code>A54C6FE2</code> zugewiesen ist, sowie der Dokumentenanker namens <code>info</code> angegeben. Das Zeichen ‚<code>#</code>‘ hat in dem vorliegenden Kontext die besondere Bedeutung, dass ihm der Name eines Dokumentenankers folgt. Soll es diese Bedeutung verlieren, d. h. dem URL-Parameter <code>session</code> der Wert <code>A54C6FE2#info</code> zugewiesen werden, so muss das Zeichen ‚<code>#</code>‘ in prozent-kodierter Form in der URL stehen:
<pre>
http://www.example.net/index.html?session=A54C6FE2%23info
</pre>
</div>

In der Praxis wird dieser Mechanismus nicht immer einheitlich angewendet. Es gibt jedoch Fälle, in denen die Verwendung nötig ist, beispielsweise beim Aufruf eines Ankers über einen [[Dereferrer]]dienst.

==== Relevante ASCII-Zeichen in Prozentdarstellung ====
<div style="overflow:auto">
{| class="wikitable" style="text-align:center"
|-
| <code>[[Leerzeichen| ]]</code>
| <code>[[Ausrufezeichen|!]]</code>
| <code>[[Anführungszeichen|"]]</code>
| <code>[[Rautezeichen|#]]</code>
| <code>[[Dollarzeichen|$]]</code>
| <code>[[Prozentzeichen|%]]</code>
| <code>[[Ampersand|&]]</code>
| <code>[[Apostroph|']]</code>
| <code>[[Klammer (Zeichen)|(]]</code>
| <code>[[Klammer (Zeichen)|)]]</code>
| <code>[[Sternchen (Schriftzeichen)|<nowiki>*</nowiki>]]</code>
| <code>[[Pluszeichen|+]]</code>
| <code>[[Komma|,]]</code>
| <code>[[Viertelgeviertstrich#Bindestrich-Minus|-]]</code>
| <code>[[Punkt (Satzzeichen)|.]]</code>
| <code>[[Schrägstrich|/]]</code>
| <code>[[Doppelpunkt|:]]</code>
| <code>[[Semikolon|;]]</code>
| <code>[[Kleiner-als-Zeichen|<]]</code>
| <code>[[Gleichheitszeichen|=]]</code>
| <code>[[Größer-als-Zeichen|>]]</code>
| <code>[[Fragezeichen|?]]</code>
| <code>[[At-Zeichen|@]]</code>
| <code>[[Klammer (Zeichen)|<nowiki>[</nowiki>]]</code>
| <code>[[Backslash|<nowiki>\</nowiki>]]</code>
| <code>[[Klammer (Zeichen)|<nowiki>]</nowiki>]]</code>
| <code>[[Klammer (Zeichen)|<nowiki>{</nowiki>]]</code>
| <code>[[Senkrechter Strich|<nowiki>|</nowiki>]]</code>
| <code>[[Klammer (Zeichen)|<nowiki>}</nowiki>]]</code>
|-
| <code>%20</code>
| <code>%21</code>
| <code>%22</code>
| <code>%23</code>
| <code>%24</code>
| <code>%25</code>
| <code>%26</code>
| <code>%27</code>
| <code>%28</code>
| <code>%29</code>
| <code>%2A</code>
| <code>%2B</code>
| <code>%2C</code>
| <code>%2D</code>
| <code>%2E</code>
| <code>%2F</code>
| <code>%3A</code>
| <code>%3B</code>
| <code>%3C</code>
| <code>%3D</code>
| <code>%3E</code>
| <code>%3F</code>
| <code>%40</code>
| <code>%5B</code>
| <code>%5C</code>
| <code>%5D</code>
| <code>%7B</code>
| <code>%7C</code>
| <code>%7D</code>
|}
</div>

==== Nicht-ASCII-Zeichen ====
Auch für die Zeichen, die nicht im ASCII-Zeichensatz enthalten sind, werden die Bytes mit vorangestelltem ‚<code>%</code>‘ kodiert. Welche Bitfolge ein Zeichen jedoch darstellt, hängt von der zu benutzenden [[Zeichenkodierung]] ab. Es wird zwar vom <nowiki>RFC 3986</nowiki> empfohlen, [[UTF-8]] zur Kodierung zu benutzen, da dieses [[Unicode]]-Format für alle internationalen Zeichen benutzt werden kann, was UTF-8 zwar zur Quasi-Standardkodierung für URIs macht, aber einen expliziten Standard gibt es noch nicht. Um die URL kodieren zu können, muss man also wissen oder ahnen, welche Zeichenkodierung für die abzurufende Datei benutzt wurde oder welche Kodierung der Zielrechner benutzt. Aus diesem Grund ist es immer noch sinnvoll, nur auf Zeichen aus dem ASCII-Vorrat zurückzugreifen.

In der empfohlenen Kodierung UTF-8 wäre beispielsweise der Buchstabe „ö“ (mit dem dezimalen Unicode-Zeichenwert 246) als <code>%C3%B6</code> dargestellt. Alle Zeichenwerte über 127 werden von UTF-8 als Kombinationen von zwei oder mehr Bytes repräsentiert und dementsprechend in die Prozent-Kodierung übernommen. Die Schriftzeichen des (um [[Diakritika]] erweiterten) [[Lateinisches Alphabet|lateinischen Alphabets]] erhalten dabei alle eine Darstellung mit zwei Bytes. Mehr Bytes benötigen zum Beispiel [[CJK]]-Zeichen.

Mitunter wird immer noch [[ISO 8859-1]] (Latin-1) für die Darstellung benutzt und dessen identischer dezimaler Zeichenwert 246 direkt mit Hilfe der Prozentkodierung in die URL eingefügt. Der [[Umlaut]] „ö“ wird dann als Wert <code>%F6</code> dargestellt.

Beide Darstellungsarten übermitteln dem Server aber unterschiedliche Bitfolgen. Obwohl beide nach ihrer Art richtig kodiert sind, liefert nur eine davon die gewünschte Datei und die andere meist nur eine Fehlermeldung. Bei einigen Servern – wie zum Beispiel denen der Wikipedia – wird jedoch versucht, die Kodierung zu ermitteln, so dass dann auf die richtige Datei weitergeleitet werden kann. Wenn es mit einer Kodierung nicht klappt, sollte man eine der anderen wahrscheinlichen Varianten probieren.

===== Eindeutigkeit der Zeichendekodierung =====

Einzeln kodierte ASCII-Zeichen (zum Beispiel <code>%23</code> für <code>#</code>) werden in [[American Standard Code for Information Interchange|ASCII]], in [[UTF-8]] und in den meisten anderen gängigen Kodierungen wie ISO 8859-15 identisch kodiert.

Bei Zahlen von 128 bis 255 ist die Kodierung unsicher: Entweder handelt es sich um eine UTF-8-Kodefolge (bzw. deren Beginn) oder um eine Kodierung für einen beschränkten Zeichensatz von 256 Zeichen wie beispielsweise ISO 8859-15. Weil in UTF-8 nur bestimmte aufeinanderfolgende Kodes zulässig sind, können beschränkte Kodierungen und UTF-8 mit einer gewissen Wahrscheinlichkeit auseinandergehalten werden: <code>%C3%B6</code> wird recht sicher nach UTF-8 das Zeichen „ö“ sein (und nicht nach ISO 8859-15 die Zeichenfolge <code>Ã¶</code>).

=== Unterstützung durch JavaScript ===
Bei der Übermittlung von Web-Formulareingaben mittels der [[Hypertext Transfer Protocol#HTTP-GET|GET]]-Methode werden die Daten der URL – durch <code>?</code> separiert – prozentkodiert angefügt. Auf diesen Query-String kann in [[JavaScript]] mittels <code>window.location.search</code> zugegriffen werden. Eine Entschlüsselung prozentkodierter Inhalte ist mit den Funktionen <code>decodeURI()</code> bzw. <code>decodeURIComponent()</code> oder der <code>get</code>-Methode der Web-API <code>URLSearchParams</code> möglich. Zur Durchführung einer Prozentkodierung stehen die Funktionen <code>encodeURI()</code> bzw. <code>encodeURIComponent()</code> zur Verfügung.

=== Form-Encoding ===
Mit dem [[Multipurpose Internet Mail Extensions|MIME]]-Typ <code>application/x-www-form-urlencoded</code> können URL-kodierte Daten gekennzeichnet werden. Bei der Übermittlung von Web-Formularangaben mittels der [[Hypertext Transfer Protocol#HTTP-POST|POST]]-Methode wird dieser MIME-Typ als Inhaltstyp ([[Content-Type]]) angegeben. Aus historischen Gründen stimmt die Kodierung nicht genau mit der Kodierung in URLs überein; insbesondere wird ein Leerzeichen nicht mit ‚<code>%20</code>‘, sondern stattdessen mit einem einzelnen ‚<code>+</code>‘ kodiert.<ref>[https://www.w3.org/TR/html4/interact/forms.html#h-17.13.4.1 17.13.4 ''Form content types''.] w3.org, ''HTML 4.01 Specification'', 24. Dezember 1999.</ref>

== Weblinks ==
* {{RFC-Internet |RFC=3986 |Titel=Uniform Resource Identifier (URI): Generic Syntax |Datum=2005-01}}
* {{RFC-Internet |Autor=M. Duerst, M. Suignard |RFC=3987 |Titel=Internationalized Resource Identifiers (IRIs) |Datum=2005-01 |Kommentar=bieten eine eindeutig unterscheidbare Alternative zur Darstellung von URIs mit Unicode-Zeichen und verwenden eine erweiterte Variante der URL-Kodierung}}
* [https://www.webreload.de/url-encoding/ URL Encoding Tool.] webreload.de

== Einzelnachweise ==
<references />

{{SORTIERUNG:URLEncoding}}
[[Kategorie:URI|Url Encoding]]

URL-Encoding - Versionsgeschichte

~2026-15133-49: JavaScript-Unterstützung