CKTIS / JavaScript
decodeURI — een URI decoderen
decodeURI decodeert procent-escapes in URI-tekst en behoudt gecodeerde scheidingstekens zoals %2F. Lees waarin de functie verschilt van decodeURIComponent en hoe ongeldige invoer wordt afgehandeld.
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
decodeURI(encodedURI)decodeURI(encodedURI) is een globale ECMAScript-functie voor het decoderen van volledige URI’s. Eerst zet de functie het argument om naar een tekenreeks; daarna geeft ze een nieuwe tekenreeks terug: %HH-reeksen die UTF-8-bytes voorstellen, worden omgezet in de bijbehorende Unicode-tekens. De invoer wordt niet gewijzigd en browser-API’s zijn niet nodig.
De functie behoudt procent-escapes die staan voor ;/?:@&=+$,#, inclusief de hoofdlettergevoeligheid van de hexadecimale cijfers. Daarom wordt %20 een spatie, maar blijft %2F %2F. Ook een letterlijk + blijft ongewijzigd: de functie decodeert niet de formulierconventie waarbij spaties met + worden weergegeven.
decodeURIComponent is bedoeld voor afzonderlijke URI-componenten en decodeert ook gecodeerde scheidingstekens, bijvoorbeeld %2F naar /. Pas deze functie niet zomaar toe op een volledige URI, omdat dit de grenzen tussen componenten kan veranderen. decodeURI is geen parser of validator van het volledige adres.
Een ongeldige procent-escape, zoals %ZZ, of een onvolledige of ongeldige UTF-8-codering veroorzaakt URIError in plaats van een gedeeltelijk resultaat terug te geven. Vang dit geval bij externe invoer af met try...catch. Decodeer alleen de benodigde coderingslaag: een volgende aanroep kan het resultaat opnieuw veranderen; %2520 wordt bijvoorbeeld eerst %20 en daarna een spatie.
Voorbeelden
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);
}Resultaat
/café menu?q=a%2Fb+c /café menu?q=a/b+c URIError
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.