URIError

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

Das URIError-Objekt stellt einen Fehler dar, der auftritt, wenn eine globale URI-Verwaltungsfunktion falsch verwendet wurde.

URIError ist ein serialisierbares Objekt, sodass es mit structuredClone() geklont oder zwischen Workers mit postMessage() kopiert werden kann.

URIError ist eine Unterklasse von Error.

Konstruktor

URIError(): Erstellt ein neues URIError-Objekt.

Instanzeigenschaften

Erbt auch Instanzeigenschaften von seinem Elternobjekt Error.

Diese Eigenschaften sind auf URIError.prototype definiert und werden von allen URIError-Instanzen geteilt.

URIError.prototype.constructor: Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für URIError-Instanzen ist der Anfangswert der URIError-Konstruktor.
URIError.prototype.name: Repräsentiert den Namen für den Fehlertyp. Für URIError.prototype.name ist der Anfangswert "URIError".

Instanzmethoden

Erbt Instanzmethoden von seinem Elternobjekt Error.

Beispiele

Abfangen eines URIError

try {
  decodeURIComponent("%");
} catch (e) {
  console.log(e instanceof URIError); // true
  console.log(e.message); // "malformed URI sequence"
  console.log(e.name); // "URIError"
  console.log(e.stack); // Stack of the error
}

Erstellen eines URIError

try {
  throw new URIError("Hello");
} catch (e) {
  console.log(e instanceof URIError); // true
  console.log(e.message); // "Hello"
  console.log(e.name); // "URIError"
  console.log(e.stack); // Stack of the error
}

Spezifikationen

Specification
ECMAScript® 2026 Language Specification # sec-native-error-types-used-in-this-standard-urierror