CKTIS / JavaScript
URIError — Fehler bei der URI-Kodierung oder -Dekodierung
URIError ist ein integrierter JavaScript-Fehlertyp für fehlerhafte Daten bei der URI-Kodierung oder -Dekodierung. Erfahre mehr über typische Ursachen, das Erstellen des Fehlers und die gezielte Behandlung von Ausnahmen.
Version: Introduced in ECMAScript 3 (1999). URIError is an ECMAScript built-in, not a Web API.
Syntax
new URIError(message)
URIError(message)URIError ist ein standardisierter ECMAScript-Fehlertyp, der von Error erbt und keine Web-API-Schnittstelle ist. Er bezeichnet nicht jede ungültige Adresse, sondern Fehler bei URI-Kodierungs- und Dekodierungsvorgängen.
decodeURI und decodeURIComponent lösen bei fehlerhaften Prozent-Escapes wie %ZZ oder bei Bytefolgen, die kein gültiges UTF-8 darstellen, einen URIError aus. encodeURI und encodeURIComponent lösen ihn bei einem nicht gepaarten UTF-16-Surrogat aus. Die Varianten mit Component verarbeiten einzelne URI-Komponenten; die anderen Varianten berücksichtigen die Rolle reservierter Zeichen in einer vollständigen URI.
new URIError(message) erstellt ein Objekt; allein dadurch wird keine Ausnahme ausgelöst. Auch der Aufruf URIError(message) ohne new erstellt ein Objekt. Um einen eigenen Fehler auszulösen, verwende throw new URIError(message). Die Eigenschaft name ist standardmäßig "URIError"; automatisch erzeugter Text in message hängt von der Implementierung ab.
Umschließe die Dekodierung nicht vertrauenswürdiger Daten mit try...catch. Prüfe in typischem Code innerhalb eines einzelnen Realms error instanceof URIError und löse andere Ausnahmen erneut aus. Bei einem Fehler aus einem anderen Realm, etwa einem anderen Frame, kann diese Prüfung fehlschlagen. Das Beispiel dekodiert gültigen Text und behandelt eine unvollständige UTF-8-Sequenz, ohne sich auf den Meldungstext zu verlassen.
Beispiele
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);
}
}Ergebnis
hello world URIError
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.