URIError

URIError 对象用来表示以一种错误的方式使用全局 URI 处理函数而产生的错误。

URIError 是 可序列化对象，所以可以使用 structuredClone() 克隆它，或者在 Worker 间使用 postMessage() 拷贝这个对象。

构造函数

URIError() (en-US)

创建一个新的 URIError 对象。

实例属性

URIError.prototype.message

错误消息。继承自 Error。

URIError.prototype.name

错误名称。继承自 Error。

URIError.prototype.cause

导致错误的原因。继承自 Error。

URIError.prototype.fileName

引发此错误的文件的路径。继承自 Error。

URIError.prototype.lineNumber

引发此错误的代码所在的文件的行号。继承自 Error。

URIError.prototype.columnNumber

引发此错误的代码在文件中所在行的列号。继承自 Error。

URIError.prototype.stack

堆栈跟踪。继承自 Error。

示例

捕获一个 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.fileName)             // "Scratchpad/1"
  console.log(e.lineNumber)           // 2
  console.log(e.columnNumber)         // 2
  console.log(e.stack)                // "@Scratchpad/2:2:3\n"
}

创建一个 URIError

try {
  throw new URIError('Hello', 'someFile.js', 10)
} catch (e) {
  console.log(e instanceof URIError)  // true
  console.log(e.message)              // "Hello"
  console.log(e.name)                 // "URIError"
  console.log(e.fileName)             // "someFile.js"
  console.log(e.lineNumber)           // 10
  console.log(e.columnNumber)         // 0
  console.log(e.stack)                // "@Scratchpad/2:2:9\n"
}

规范

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

浏览器兼容性

BCD tables only load in the browser

参见