Jest的.toThrow(TypeError)无法匹配URL构造函数抛出的TypeError

这不是你的用法错误，是Jest 29.4.2版本的一个已知问题。根源在于Jest的测试沙箱环境中，代码里引用的TypeError构造函数，和new URL()抛出的原生TypeError实例的构造函数并非同一个引用——前者是Jest沙箱模拟的版本，后者是Node.js/浏览器宿主环境原生的版本，导致Jest的匹配逻辑判定两者不相等。

解决办法 #

• 匹配错误消息：改用匹配错误的具体内容，比如正则匹配或精确匹配字符串：

  it("throws TypeError when url is invalid", () => {
    expect(() => new URL("")).toThrow(/Invalid URL/);
    // 或者精确匹配
    // expect(() => new URL("")).toThrow("Invalid URL: ");
  })
  

• 断言错误名称：手动捕获错误后断言其name属性：

  it("throws TypeError when url is invalid", () => {
    expect(() => {
      try {
        new URL("");
      } catch (err) {
        expect(err.name).toBe("TypeError");
        throw err; // 确保Jest的toThrow仍能捕获到错误
      }
    }).toThrow();
  })
  

• 升级Jest版本：该问题在Jest 29.5.0及以上版本已被修复，升级后即可正常使用.toThrow(TypeError)进行匹配。

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