CKTIS / JavaScript
URIError — fout bij URI-codering of -decodering
URIError is een ingebouwd JavaScript-fouttype dat ongeldige gegevens bij het coderen of decoderen van URI’s aangeeft. Lees meer over veelvoorkomende oorzaken, het aanmaken van de fout en het gericht afhandelen van uitzonderingen.
Versie: Introduced in ECMAScript 3 (1999). URIError is an ECMAScript built-in, not a Web API.
Syntax
new URIError(message)
URIError(message)URIError is een standaard ECMAScript-fouttype dat overerft van Error; het is geen Web API-interface. Het staat niet voor elk ongeldig adres, maar voor fouten bij URI-coderings- en decoderingsbewerkingen.
decodeURI en decodeURIComponent gooien een URIError bij ongeldige procent-escapes, zoals %ZZ, of bytereeksen die geen geldige UTF-8 coderen. encodeURI en encodeURIComponent gooien deze fout bij een niet-gepaard UTF-16-surrogaat. De varianten met Component verwerken afzonderlijke URI-componenten; de andere varianten houden rekening met de rol van gereserveerde tekens in een volledige URI.
new URIError(message) maakt een object aan; alleen dat aanmaken gooit geen uitzondering. Ook de aanroep URIError(message) zonder new maakt een object aan. Gebruik throw new URIError(message) om zelf een fout te gooien. De eigenschap name is standaard "URIError"; de automatisch gegenereerde tekst van message hangt af van de implementatie.
Zet het decoderen van niet-vertrouwde gegevens in een try...catch-blok. Controleer in gebruikelijke code die binnen één realm draait error instanceof URIError en gooi andere uitzonderingen opnieuw. Deze controle kan mislukken bij een fout uit een andere realm, zoals een ander frame. Het voorbeeld decodeert geldige tekst en handelt een onvolledige UTF-8-reeks af zonder afhankelijk te zijn van de meldingstekst.
Voorbeelden
for (const input of ["hello%20world", "%E0%A4"]) {
try {
console.log(decodeURIComponent(input));
} catch (error) {
if (!(error instanceof URIError)) throw error;
console.log(error.name);
}
}Resultaat
hello world 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.