WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

decodeURI — eine URI dekodieren

decodeURI dekodiert Prozent-Escapes in URI-Text und erhält dabei kodierte Trennzeichen wie %2F. Erfahre, worin sich die Funktion von decodeURIComponent unterscheidet und wie sie fehlerhafte Eingaben behandelt.

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

decodeURI(encodedURI)

decodeURI(encodedURI) ist eine globale ECMAScript-Funktion zum Dekodieren vollständiger URIs. Zuerst wandelt sie ihr Argument in einen String um und gibt dann einen neuen String zurück: %HH-Sequenzen, die UTF-8-Bytes darstellen, werden in die entsprechenden Unicode-Zeichen umgewandelt. Die Eingabe wird nicht verändert, und Browser-APIs sind nicht erforderlich.

Die Funktion erhält Prozent-Escapes für ;/?:@&=+$,#, einschließlich der Groß- und Kleinschreibung der Hexadezimalziffern. Daher wird %20 zu einem Leerzeichen, %2F bleibt jedoch %2F. Auch ein wörtliches + bleibt unverändert: Die Funktion dekodiert nicht die Formular-Konvention, bei der Leerzeichen durch + dargestellt werden.

decodeURIComponent ist für einzelne URI-Komponenten gedacht und dekodiert auch kodierte Trennzeichen, zum Beispiel %2F zu /. Verwende die Funktion nicht unbedacht für eine vollständige URI, da sich dadurch die Grenzen der Komponenten ändern können. decodeURI ist kein Parser und kein Validator für die gesamte Adresse.

Ein fehlerhaftes Prozent-Escape wie %ZZ oder eine unvollständige beziehungsweise ungültige UTF-8-Kodierung löst URIError aus, statt ein Teilergebnis zurückzugeben. Behandle diesen Fall bei externen Eingaben mit try...catch. Dekodiere nur die erforderliche Kodierungsebene: Ein weiterer Aufruf kann das Ergebnis erneut verändern; beispielsweise wird %2520 zuerst zu %20 und danach zu einem Leerzeichen.

Beispiele

const encoded = '/caf%C3%A9%20menu?q=a%2Fb+c';
console.log(decodeURI(encoded));
console.log(decodeURIComponent(encoded));

try {
  decodeURI('%E0%A4');
} catch (error) {
  console.log(error.name);
}

Ergebnis

/café menu?q=a%2Fb+c
/café menu?q=a/b+c
URIError

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