Frisby测试失败时Linux环境下报告异常问题求助

我在帮开发者排查Frisby.js测试的跨环境问题时，遇到过完全一致的场景——Windows下能正确显示断言失败，但Linux下却误报超时。下面是问题详情、原因分析和可行的解决方案：

问题场景 #

先看测试代码（故意设置了错误的状态码预期，用于触发失败）：

const frisby = require('frisby');
const Joi = frisby.Joi;
describe('TEST', () => {
  it ('should return a status of 200', (done) =>{
    frisby
      .get('https://jsonfeed.org/feed.json')
      .expect('status', 400) // 错误的预期值，实际返回200
      .done(done);
  });
});

不同环境的错误表现 #

Windows环境（正常）

执行jasmine-node .后，正确输出断言失败信息：

jasmine-node .
F
Failures:

1. TEST should return a status of 200
   Message: Expected 'AssertionError: HTTP status 400 !== 200 at FrisbySpec.status ([mydirpath]\expects.js:25:12) (snip)

Ubuntu 16.04环境（异常）

同样的命令，先抛出未处理Promise警告，最终报告超时：

(node:28704) UnhandledPromiseRejectionWarning: AssertionError [ERR_ASSERTION]: HTTP status 400 !== 200
at FrisbySpec.status (/home/nsco/jen_work/frisby/node_modules/frisby/src/frisby/expects.js:25:12)
...（省略部分栈信息）
F
Failures:

1. TEST should return a status of 200
   Message: timeout: timed out after 5000 msec waiting for spec to complete
   Stacktrace: undefined

环境依赖：

• frisby@2.0.11
• jasmine-node@1.14.5
• node.js@9.4.0
• Ubuntu 16.04

核心原因 #

这个问题的本质是旧版jasmine-node对Promise的处理缺陷：Frisby.js v2.x完全基于Promise实现，但jasmine-node v1.14.5在Linux环境下，无法正确捕获Promise链中的断言错误并传递给done回调。测试框架误以为测试逻辑一直没执行完成，最终触发了超时机制。

Windows环境下的正常表现其实是个“意外”，可能是Node.js旧版本的平台差异导致错误被意外捕获，但这不是可靠的行为。

解决方案 #

方案1：升级测试框架（推荐） #

jasmine-node v1.x早已停止维护，对Promise的支持非常有限。建议替换为官方的jasmine包，或者更现代的jest：

1. 卸载旧依赖：

npm uninstall jasmine-node --save-dev

2. 安装官方jasmine：

npm install jasmine --save-dev

3. 调整测试代码（遵循Frisby v2.x的最佳实践，返回Promise而非使用done）：

const frisby = require('frisby');
const Joi = frisby.Joi;
describe('TEST', () => {
  it ('should return a status of 200', () => {
    // 返回Promise，让测试框架自动处理结果
    return frisby
      .get('https://jsonfeed.org/feed.json')
      .expect('status', 400);
  });
});

4. 运行测试：

npx jasmine

此时无论Windows还是Linux，都会正确显示断言错误。

方案2：手动捕获错误（兼容旧框架） #

如果暂时无法升级框架，可以手动捕获Promise中的错误，强制传递给done回调：

const frisby = require('frisby');
const Joi = frisby.Joi;
describe('TEST', () => {
  it ('should return a status of 200', (done) =>{
    frisby
      .get('https://jsonfeed.org/feed.json')
      .expect('status', 400)
      .then(() => done()) // 成功时调用done
      .catch(err => done.fail(err)); // 捕获断言错误并传递给测试框架
  });
});

这种方式能绕过jasmine-node的Promise处理缺陷，让错误正确显示。

额外建议 #

• Node.js v9.x已经非常老旧，建议升级到LTS版本（如v16或v18），不仅能修复平台兼容性问题，还能获得更稳定的Promise支持。
• Frisby.js v2.x也已停止维护，考虑升级到v3.x（基于Jest），能获得更好的测试体验和持续的社区支持。

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