CKTIS / JavaScript
encodeURIComponent — een URI-component coderen
encodeURIComponent codeert één URI-component, zoals de waarde van een queryparameter. De functie zet speciale en niet-ASCII-tekens om in percentreeksen die UTF-8-bytes voorstellen.
Versie: 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) is een globale ECMAScript-functie en geen API die alleen in browsers beschikbaar is. De functie zet het argument om in een tekenreeks en geeft een gecodeerde tekenreeks terug. Gebruik haar voor één afzonderlijke waarde, niet voor een heel adres.
De letters A–Z, a–z, de cijfers 0–9 en - _ . ! ~ * ' ( ) blijven ongewijzigd. Andere tekens worden UTF-8-bytes, geschreven als %HH. Een spatie wordt %20, niet +; een letterlijk + wordt %2B.
In tegenstelling tot encodeURI codeert de functie ook scheidingstekens zoals &, =, /, ? en #. Na codering fungeren die tekens niet als scheidingstekens wanneer je een URI samenstelt. Apostrofs en haakjes blijven daarentegen ongewijzigd en kunnen in bepaalde URI-syntaxis nog steeds als scheidingstekens dienen, bijvoorbeeld in OData-URL’s. Het is echter geen HTML-escaping of adresvalidatie. Als je het resultaat opnieuw codeert, wordt % omgezet in %25.
decodeURIComponent maakt de codering van geldige gegevens ongedaan. Een ongepaard UTF-16-surrogaat in het argument van encodeURIComponent veroorzaakt een URIError; de functie vervangt het niet automatisch. Het voorbeeld laat zien hoe een Unicode-teken, een spatie en scheidingstekens worden gecodeerd, en controleert daarna of dit omkeerbaar is.
Voorbeelden
const value = "ż &+/";
const encoded = encodeURIComponent(value);
console.log(encoded);
console.log(decodeURIComponent(encoded) === value);Resultaat
%C5%BC%20%26%2B%2F true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.