URIError

Baseline 廣泛可用 *

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

* 此特性的某些部分可能存在不同級別的支援。

URIError 物件表示全域性 URI 處理函式使用不當時發生的錯誤。

URIError 是一個可序列化物件,因此可以使用 structuredClone() 進行克隆,或者透過 postMessage()Workers 之間進行復制。

URIErrorError 的一個子類。

建構函式

URIError()

建立一個新的 URIError 物件。

例項屬性

還繼承了其父級 Error 的例項屬性。.

這些屬性定義在 URIError.prototype 上,並由所有 URIError 例項共享。

URIError.prototype.constructor

建立例項物件的建構函式。對於 URIError 例項,初始值為 URIError 建構函式。

URIError.prototype.name

表示錯誤的型別名稱。對於 URIError.prototype.name,初始值為 "URIError"

例項方法

繼承了其父級 Error 的例項方法。.

示例

捕獲 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
}

建立 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
}

規範

規範
ECMAScript® 2026 語言規範
# sec-native-error-types-used-in-this-standard-urierror

瀏覽器相容性

另見