Node.js util.inspect是否真的不会抛异常？能否构造触发报错的对象？

问题背景 #

从以下代码出发，开发者尝试在JSON.stringify失败（比如循环引用场景）后，用util.inspect序列化未知类型的输入，但不确定inspect本身是否会抛出异常，是否需要额外的try/catch：

const input: unknown; // 可能为任意类型的未知输入
try {
  // 序列化可能抛出异常（比如循环引用）
  stringified = JSON.stringify(input);
} catch (stringifyErr) {
  try {
    // 疑问：inspect本身会不会抛出异常？
    stringified = inspect(input);
  } catch (inspectErr) {
    // 会不会走到这里？是否需要这个try/catch？
  }
}

开发者尝试构造循环对象、代理包装的循环对象等场景测试，均未触发inspect的异常：

// 用代理包装循环对象
const evilObject = createEvilObject(testCircularObject);

try {
  inspect(evilObject, { depth: 2 });
} catch (err) {
  throw new Error("FAILS!"); // 从未触发
}

已知util.inspect设计为可处理循环引用，输出[Circular]占位符而非抛出异常，现需确认：

1. 默认情况下，util.inspect是否真的不会因循环引用抛出异常？
2. 是否存在能让inspect(object)抛出异常的对象？如何构造？

解答 #

1. 循环引用场景：util.inspect确实不会抛出异常 #

默认配置下，util.inspect会主动检测并处理循环引用，遇到循环结构时会输出[Circular]占位符，不会抛出异常。这是Node.js官方为避免应用崩溃设计的核心特性，无论是否用代理包装循环对象，都不会触发异常，这也是你测试未成功的原因。

2. 能让util.inspect抛出异常的对象构造方式 #

虽然util.inspect对循环引用做了防护，但在以下场景中，它仍会抛出异常：

（1）自定义方法抛出异常的对象

当对象的toString、valueOf或其他被inspect调用的自定义方法主动抛出异常时，inspect会传递该异常：

const util = require('util');

const errObj = {
  toString() {
    throw new Error('Custom toString error');
  }
};

try {
  util.inspect(errObj);
} catch (e) {
  console.log(e.message); // 输出：Custom toString error
}

（2）代理对象的陷阱方法抛出异常

如果代理的get、ownKeys等陷阱方法在inspect访问属性时抛出异常，会直接触发inspect的捕获逻辑：

const util = require('util');

const evilProxy = new Proxy({}, {
  get(target, prop) {
    if (prop === 'foo') {
      throw new Error('Proxy get trap error');
    }
    return Reflect.get(target, prop);
  }
});

try {
  util.inspect(evilProxy);
} catch (e) {
  console.log(e.message); // 输出：Proxy get trap error
}

（3）带有抛出异常的getter属性的对象

对象的getter属性在inspect尝试读取时抛出异常，会被inspect传递出来：

const util = require('util');

const getterErrObj = {
  get foo() {
    throw new Error('Getter error');
  }
};

try {
  util.inspect(getterErrObj);
} catch (e) {
  console.log(e.message); // 输出：Getter error
}

内容的提问来源于stack exchange，提问作者koalaok