通过Error
构造器我们可以创建一个错误对象,当程序运行出错时,Error的实例对象就会被抛出。
语法
new Error([message[, fileName[, lineNumber]]])
- message
可选, 描述错误的信息, 类型为一个字符串,如果不是字符串则会调用其toString()
- fileName
可选,被创建的Error对象的fileName属性值,默认为调用Error构造器的文件名 - lineNumber
可选, 默认为调用Error构造器的文件行号
注意: fileName
和lineNumber
参数是非标准的api,使用时需要注意其兼容。
类型
除了通用的Error构造函数外, js还有6个其他类型的错误构造函数。
- EvalError
与eval()
有关, 当调用 eval() 失败时抛出。 - RangeError
数值变量或参数超出了其有效范围 - ReferenceError
一个无效的引用(eg:strict
模式下引用了一个未声明的变量等) - SyntaxError
当 JavaScript 语法错误时抛出。 - TypeError
变量或参数不属于有效类型a = {}; a.xx(); # TypeError: a.xx is not a function
- URIError
当全局的 URI 处理函数被误用时抛出。(给encodeURI()
或decodeURI()
传递的参数无效)
- URIError
另外: 还有一个非标准的错误构造函数IntervalError
: js引擎内部的错误, 如递归太多.
在Node.js中, 除了标准的js错误之外, 还有以下几类错误:
- 由底层操作系触发的系统错误,例如试图打开一个不存在的文件、试图通过一个已关闭的 socket 发送数据等。
- 由应用程序代码触发的用户自定义的错误。
- 断言错误是错误的一个特殊类别,每当 Node.js 检测到一个不应该发生的异常逻辑时触发。 这类错误通常由 assert 模块引起。
所有由 Node.js 引起的 JavaScript 错误与系统错误都继承自或实例化自标准的 JavaScript <Error> 类,且保证至少提供类中的属性。
Error实例
- 方法
Error对象本身不包含任何方法, 但是从原型上面继承了一些方法. - 属性
- Error.prototype.message
构造Error对象时的message - Error.prototype.name
名称
在Node.js或某些浏览器环境中可能会包含code, stack
等信息
错误捕获
- 使用try/catch捕获错误
try {
throw new Error("Whoops!");
} catch (e) {
alert(e.name + ": " + e.message);
}
- Node.js中,大多数的异步方法都接受一个 callback 函数,该函数会接受一个 Error 对象传入作为第一个参数。 如果第一个参数不是 null 而是一个 Error 实例,则说明发生了错误,应该进行处理。
# node
const fs = require('fs');
fs.readFile('一个不存在的文件', (err, data) => {
if (err) {
console.error('读取文件出错!', err);
return;
}
// 否则处理数据
});
- 当一个异步方法被一个 EventEmitter 对象调用时,错误会被分发到对象的 'error' 事件上。
# node
const net = require('net');
const connection = net.connect('localhost');
// 添加一个 'error' 事件句柄到一个流:
connection.on('error', (err) => {
// 如果连接被服务器重置,或无法连接,或发生任何错误,则错误会被发送到这里。
console.error(err);
});
connection.pipe(process.stdout);
- Node.js API 中有一小部分普通的异步方法仍可能使用 throw 机制抛出异常,且必须使用 try / catch 处理。 这些方法并没有一个完整的列表;请参阅各个方法的文档以确定所需的合适的错误处理机制。
Node.js中: 对于所有的 EventEmitter
对象,如果没有提供一个 'error'
事件句柄,则错误会被抛出,并造成 Node.js 进程报告一个未处理的异常且随即崩溃,除非: 适当地使用 domain
模块或已经注册了一个 [process.on('uncaughtException')
] 事件的句柄。
一些例子
- 抛出一个基本错误
throw new Error('error happened');
- 可以使用
instanceOf
识别一个特定错误
try {
foo.bar();
} catch (e) {
if (e instanceof EvalError) {
alert(e.name + ": " + e.message);
} else if (e instanceof RangeError) {
alert(e.name + ": " + e.message);
}
// ... etc
}
- 自定义异常类型
// Create a new object, that prototypally inherits from the Error constructor.
function MyError(message) {
this.name = 'MyError';
this.message = message || 'Default Message'; this.stack = (new Error()).stack;
}
MyError.prototype = Object.create(Error.prototype);
MyError.prototype.constructor = MyError;
try {
throw new MyError();
} catch (e) {
console.log(e.name); // 'MyError'
console.log(e.message); // 'Default Message'
}