KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

decodeURIComponent — een URI-component decoderen

decodeURIComponent decodeert procentcoderingen in één URI-component en interpreteert de gecodeerde bytes als UTF-8. De functie geeft tekst terug, laat + ongewijzigd en veroorzaakt een URIError bij ongeldige codering.

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

decodeURIComponent(encodedURIComponent)

decodeURIComponent(encodedURIComponent) is een globale ECMAScript-functie voor het decoderen van één URI-component. Eerst zet de functie het argument om in een tekenreeks. Daarna vervangt ze %HH-coderingen door de bijbehorende tekens, waarbij de gecodeerde bytes als UTF-8 worden geïnterpreteerd. De functie geeft een tekenreeks terug en verandert het argument niet.

In tegenstelling tot decodeURI decodeert deze functie ook gecodeerde gereserveerde tekens zoals %26, %2F en %3D. Splits een adres op in componenten voordat je de waarden decodeert: te vroeg decoderen kan gegevens veranderen in scheidingstekens. Een letterlijke + blijft ongewijzigd; de functie behandelt die niet als een spatie.

Onvolledige procentcoderingen, ongeldige hexadecimale cijfers of ongeldige UTF-8 veroorzaken een URIError. Vang deze uitzondering af bij externe invoer. Decodeer op basis van het verwachte aantal coderingslagen: %252F wordt na één aanroep %2F en na een tweede /.

Het voorbeeld laat zien hoe Unicode-tekst en gereserveerde tekens worden gedecodeerd, hoe + behouden blijft en hoe ongeldige invoer wordt afgehandeld. Dit is een functie van de ECMAScript-taal, geen API waarvoor een browseromgeving nodig is.

Voorbeelden

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);
}

Resultaat

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

Bronnen