1. 主页
  2. 文档
  3. 君土参考手册
  4. 标准内置对象
  5. 码错(URIError)

码错(URIError)

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

语法

启 码错([message[, fileName[, lineNumber]]])

参数

message选填。易于理解的错误描述。fileName 【非标准内联】选填。包含造成异常的代码的文件名称。lineNumber 【非标准内联】选填。造成异常的代码行号。

描述

当向全局 URI 处理函数传递一个不合法的URI时,URIError 错误会被抛出。

属性

URIError.prototype允许向一个 URIError 对象添加额外的属性。

方法

虽然全局 URIError 对象没有任何自己的方法,但是它能通过原型链继承一些方法。

码错 (URIError) 实例

属性

URIError.prototype.constructor
声明创建实例原型 (prototype) 的方法。

信息 – URIError.prototype.message
错误信息。虽然 ECMA-262 规范指出 TypeError 应该实现其自身的 message 属性,但是在 SpiderMonkey 中,该属性继承自 Error.prototype.message

名 – URIError.prototype.name
错误名称。继承自 Error

栈 – URIError.prototype.stack
堆栈跟踪记录。 继承自 Error

方法

虽然 URIError 的原型对象自身不包含任何方法,但是 URIError 的实例通过原型链(prototype chain)继承了一些方法。

示例

捕获一个 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"
}