util.isError(object)

返回上层文档

新增于: v0.6.0弃用于: v4.0.0

稳定性: 0 - 已弃用:改用 util.types.isNativeError()。

\Stability: 0 - Deprecated: Use util.types.isNativeError() instead.

object <any>
返回:<boolean>

\Returns: <boolean>

如果给定的 object 是 Error,则返回 true。否则,返回 false。

\Returns true if the given object is an Error. Otherwise, returns false.

const util = require('node:util');
util.isError(new Error());
// Returns: true
util.isError(new TypeError());
// Returns: true
util.isError({ name: 'Error', message: 'an error occurred' });
// Returns: false

此方法依赖于 Object.prototype.toString() 行为。当 object 参数操作 @@toStringTag 时,可能会得到错误的结果。

\This method relies on Object.prototype.toString() behavior. It is possible to obtain an incorrect result when the object argument manipulates @@toStringTag.

const util = require('node:util');
const obj = { name: 'Error', message: 'an error occurred' };
util.isError(obj);
// Returns: false
obj[Symbol.toStringTag] = 'Error';
util.isError(obj);
// Returns: true