WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

encodeURI() — Kodierung eines vollständigen URI

encodeURI() kodiert Zeichen eines vollständigen URI und lässt einige Trennzeichen unverändert. Die Funktion gibt einen neuen String mit UTF-8-Prozentkodierung zurück und ist nicht für einzelne Parameterwerte gedacht.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

encodeURI(uri)

encodeURI(uri) ist eine globale ECMAScript-Funktion und keine Browser-API. Sie wandelt ihr Argument in einen String um und gibt einen neuen String zurück, in dem ausgewählte Zeichen durch %HH-Sequenzen für UTF-8-Bytes ersetzt werden. Ein Leerzeichen wird zu %20, nicht zu +.

ASCII-Buchstaben, Ziffern und -_.!~*'();/?:@&=+$,# bleiben unverändert. Die Zeichen &, = und # behalten damit ihre besondere Bedeutung, doch die Funktion erhält nicht die Struktur jedes gültigen URI. Sie prozentkodiert beispielsweise die eckigen Klammern um ein IPv6-Literal: Aus http://[::1]/ wird http://%5B::1%5D/, eine URL mit ungültigem Host. Verwende für einen einzelnen Parameterwert encodeURIComponent(), das auch &, = und # kodiert.

Wenn du mit encodeURIComponent() ein einzelnes Pfadsegment kodierst, weise Werte, die genau . oder .. lauten, vor der Kodierung zurück. Die Funktion lässt sie unverändert, sodass ein URL-Parser sie bei der Normalisierung als Punktsegmente behandeln kann, statt sie als wörtliche Pfaddaten zu erhalten. Ein Segment .. kann das vorhergehende Pfadsegment entfernen.

Die Funktion prüft weder, ob eine Adresse gültig ist, noch ob sie sicher ist. Sie kodiert % als %25; bei einer erneuten Kodierung ändern sich daher vorhandene Escape-Sequenzen: Aus %20 wird %2520. Ein ungepaartes UTF-16-Surrogat löst URIError aus; ein gültiges Surrogatpaar wird als ein Codepunkt kodiert.

Das Beispiel zeigt, welche Trennzeichen in der angegebenen URL unverändert bleiben, wie é und Leerzeichen kodiert werden und worin sich die Kodierung eines vollständigen URI von der einer einzelnen Komponente unterscheidet.

Beispiele

const uri = "https://example.com/café menu?q=tea&size=large#top";
console.log(encodeURI(uri));
console.log(encodeURIComponent("tea&size=large"));
console.log(encodeURI("%20"));

Ergebnis

https://example.com/caf%C3%A9%20menu?q=tea&size=large#top
tea%26size%3Dlarge
%2520

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen