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.