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 repräsentiert einen Fehler, wenn eine globale URI-Verarbeitungsfunktion auf falsche Weise verwendet wurde.

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

URIError ist eine Unterklasse von Error.

Konstruktor

URIError(): Erstellt ein neues URIError-Objekt.

Instanzeigenschaften

Erbt auch Instanzeigenschaften von seinem übergeordneten Objekt 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 des Fehler-Typs. Für URIError.prototype.name ist der Anfangswert "URIError".

Instanzmethoden

Erbt Instanzmethoden von seinem übergeordneten Objekt Error.

Beispiele

Einen URIError abfangen

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
}

Einen URIError erstellen

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