Google Apps Script中Error对象返回客户端后instanceof校验失效问题咨询

这个问题其实是Google Apps Script（GAS）跨端通信时的常见坑——服务端的Error实例在返回客户端的过程中会被序列化为普通JSON对象，丢失了Error的原型链信息，所以客户端用instanceof Error判断会返回false。

为什么会出现这种情况？ #

在GAS服务端的catch块里，e确实是原生的Error实例，所以Logger.log(e instanceof Error)返回true没问题。但当你把e直接返回给客户端时，GAS会自动把服务端对象序列化为JSON格式传输。而JSON只能存储键值对数据，无法保存对象的原型和类信息，所以原本的Error实例会被转换成类似下面的普通对象：

{
  message: "failure",
  name: "Error",
  stack: "Error: failure\n    at testing(...)"
}

客户端拿到这个JSON解析后的对象，自然不再是Error类的实例，instanceof Error也就返回false了。

怎么解决这个问题？ #

我们可以在服务端主动把错误信息封装成自定义的结构化对象，让客户端能清晰识别并处理：

修改后的GAS服务端代码：

function isValid() { return false }
function testing() {
  try {
    if(!isValid()) {
      throw new Error("failure")
    }
    // 成功时也返回结构化对象，保持格式统一
    return { status: "success", data: "success" }
  } catch(e) {
    Logger.log(e instanceof Error) // true
    // 把错误信息封装成自定义对象返回
    return {
      status: "error",
      error: {
        message: e.message,
        name: e.name,
        stack: e.stack // 可选，如需调试可以带上栈信息
      }
    }
  }
}

客户端处理代码示例：

google.script.run
  .withSuccessHandler(response => {
    if (response.status === "error") {
      console.log("请求出错：", response.error.message);
      // 这里可以根据error.name区分错误类型，或者处理栈信息
    } else {
      console.log("请求成功：", response.data);
    }
  })
  .testing();

另一种简化方案：

如果不需要额外信息，也可以直接返回错误字符串或者只返回{error: e.message}，核心就是不要直接返回Error实例，而是转成客户端能识别的普通数据格式。

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