CKTIS / JavaScript
encodeURIComponent — Kodierung einer URI-Komponente
encodeURIComponent kodiert eine einzelne URI-Komponente, etwa den Wert eines Abfrageparameters. Sonderzeichen und Nicht-ASCII-Zeichen werden in Prozentsequenzen umgewandelt, die UTF-8-Bytes darstellen.
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
encodeURIComponent(uriComponent)encodeURIComponent(uriComponent) ist eine globale ECMAScript-Funktion und keine ausschließlich im Browser verfügbare API. Sie wandelt ihr Argument in eine Zeichenfolge um und gibt eine kodierte Zeichenfolge zurück. Verwende sie für einen einzelnen Wert, nicht für eine ganze Adresse.
Unverändert bleiben die Buchstaben A–Z, a–z, die Ziffern 0–9 sowie - _ . ! ~ * ' ( ). Andere Zeichen werden zu UTF-8-Bytes, die als %HH geschrieben werden. Ein Leerzeichen wird zu %20, nicht zu +; ein wörtliches + wird zu %2B.
Anders als encodeURI kodiert die Funktion auch Trennzeichen wie &, =, /, ? und #. Dadurch wirken diese Zeichen beim Zusammensetzen einer URI nicht als Trennzeichen. Apostrophe und Klammern bleiben jedoch unverändert und können in bestimmten URI-Syntaxen weiterhin als Trennzeichen dienen, etwa in OData-URLs. Es handelt sich jedoch weder um HTML-Escaping noch um eine Adressvalidierung. Wird das Ergebnis erneut kodiert, wird % zu %25.
decodeURIComponent macht die Kodierung gültiger Daten rückgängig. Ein ungepaartes UTF-16-Surrogat im Argument von encodeURIComponent verursacht einen URIError; die Funktion ersetzt es nicht automatisch. Das Beispiel zeigt die Kodierung eines Unicode-Zeichens, eines Leerzeichens und von Trennzeichen und prüft anschließend die Umkehrbarkeit.
Beispiele
const value = "ż &+/";
const encoded = encodeURIComponent(value);
console.log(encoded);
console.log(decodeURIComponent(encoded) === value);Ergebnis
%C5%BC%20%26%2B%2F true
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.