URIError() Konstruktor

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.

Der URIError() Konstruktor erstellt URIError Objekte.

Syntax

js
new URIError()
new URIError(message)
new URIError(message, options)
new URIError(message, fileName)
new URIError(message, fileName, lineNumber)

URIError()
URIError(message)
URIError(message, options)
URIError(message, fileName)
URIError(message, fileName, lineNumber)

Note: URIError() kann mit oder ohne new aufgerufen werden. Beides erstellt eine neue URIError Instanz.

Parameter

message Optional

Eine menschenlesbare Beschreibung des Fehlers.

options Optional

Ein Objekt, das die folgenden Eigenschaften hat:

cause Optional

Eine Eigenschaft, die die spezifische Ursache des Fehlers angibt. Beim Abfangen und erneuten Werfen eines Fehlers mit einer genaueren oder nützlicheren Fehlermeldung kann diese Eigenschaft verwendet werden, um den ursprünglichen Fehler zu übergeben.

fileName Optional

Der Name der Datei, die den Code enthält, der die Ausnahme verursacht hat.

lineNumber Optional

Die Zeilennummer des Codes, der die Ausnahme verursacht hat.

Beispiele

Abfangen eines URIError

js
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

js
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® 2025 Language Specification
# sec-nativeerror-constructors

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch