WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

decodeURIComponent — eine URI-Komponente dekodieren

decodeURIComponent dekodiert Prozentsequenzen in einer einzelnen URI-Komponente und interpretiert die codierten Bytes als UTF-8. Die Funktion gibt Text zurück, lässt + unverändert und löst bei fehlerhafter Codierung einen URIError aus.

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

decodeURIComponent(encodedURIComponent)

decodeURIComponent(encodedURIComponent) ist eine globale ECMAScript-Funktion zum Dekodieren einer einzelnen URI-Komponente. Zuerst wandelt sie ihr Argument in eine Zeichenfolge um und ersetzt dann %HH-Sequenzen durch die entsprechenden Zeichen, wobei codierte Bytes als UTF-8 interpretiert werden. Sie gibt eine Zeichenfolge zurück, ohne das Argument zu verändern.

Anders als decodeURI dekodiert sie auch codierte reservierte Zeichen wie %26, %2F und %3D. Teile eine Adresse in Komponenten auf, bevor du deren Werte dekodierst: Ein vorzeitiges Dekodieren kann Daten in Trennzeichen verwandeln. Ein wörtliches + bleibt unverändert; die Funktion behandelt es nicht als Leerzeichen.

Unvollständige Prozentsequenzen, ungültige hexadezimale Ziffern oder ungültiges UTF-8 verursachen einen URIError. Behandle diese Ausnahme bei externen Eingaben. Dekodiere entsprechend der erwarteten Anzahl von Codierungsebenen: %252F wird nach einem Aufruf zu %2F und nach einem zweiten zu /.

Das Beispiel zeigt das Dekodieren von Unicode-Text und reservierten Zeichen, das Beibehalten von + sowie den Umgang mit fehlerhaften Eingaben. Dies ist eine ECMAScript-Sprachfunktion und keine API, die eine Browserumgebung voraussetzt.

Beispiele

const encoded = "caf%C3%A9%20%26%20tea%2Bcake";
console.log(decodeURIComponent(encoded));
console.log(decodeURIComponent("a+b"));

try {
  decodeURIComponent("%E0%A4%A");
} catch (error) {
  console.log(error.name);
}

Ergebnis

café & tea+cake
a+b
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