如何在Karma/Jasmine中捕获异步抛出的错误？

使用Promise和Observable实现的复杂业务逻辑中，当代码在类似setTimeout的异步调用栈中抛出错误时，Karma/Jasmine测试无法捕获该错误。尝试了toThrow、expectAsync、done回调、fakeAsync等多种测试写法，均未成功捕获错误。

示例代码（模拟被测逻辑）：

const getPromise = () =>
  new Promise((resolve) => {
    setTimeout(() => {
      throw new Error("a!");
    });
  });

// 测试用例均无法捕获错误
fit("use toThrow", async () => {
  expect(await getPromise()).toThrow();
});
// 输出：Error: a! thrown

fit("use expectAsync", async () => {
  await expectAsync(getPromise()).toBeRejectedWithError();
});
// 输出：Error: a! thrown

fit("use done", async (done) => {
  try {
    await getPromise();
  } catch (e) {
    expect(e).toEqual("a!");
  }
  done();
});
// 输出：Error: a! thrown

fit("use fakeAsync", fakeAsync(() => {
  expectAsync(getPromise()).toBeRejectedWithError();
}));
// 输出：Error: 1 timer(s) still in the queue.

实际被测代码未直接使用setTimeout，但包含大量RxJS代码，推测其内部使用了类似的异步调度逻辑。

示例中getPromise的错误无法被捕获的核心原因：

• Promise的执行器函数仅能捕获同步代码抛出的错误，setTimeout回调属于独立的异步调用栈，其中的throw不会被Promise的错误处理机制包裹，会直接成为全局未处理错误，测试框架无法通过Promise的reject链捕获。
• RxJS的部分操作符（如delay、timeout）内部依赖异步调度器（如asyncScheduler），若在这些异步回调中直接throw，错误同样会逃逸出Observable的error通知链，变成全局错误。

1. 修复被测代码的错误抛出逻辑 #

这是根本解决方案，确保错误进入Promise/Observable的错误处理链：

Promise场景 #

将异步回调中的throw替换为reject，让错误成为Promise的拒绝原因：

const getPromise = () =>
  new Promise((resolve, reject) => {
    setTimeout(() => {
      reject(new Error("a!")); // 用reject替代直接throw
    });
  });

RxJS场景 #

确保错误通过Observable的error通知抛出，而非直接throw：

import { of, throwError } from 'rxjs';
import { delay } from 'rxjs/operators';

// 正确写法：用throwError生成错误流
const getObs$ = () => of(null).pipe(
  delay(100),
  () => throwError(() => new Error("a!"))
);

// 若需在异步操作中抛出错误，确保在Observable回调内调用error参数
const getObsWithAsync$ = () => new Observable((subscriber) => {
  setTimeout(() => {
    subscriber.error(new Error("a!")); // 调用subscriber.error而非throw
  }, 100);
});

2. 适配测试写法（针对无法修改被测代码的场景） #

捕获全局未处理错误 #

通过监听全局error事件，捕获逃逸的异步错误：

fit("捕获异步全局错误", (done) => {
  const errorHandler = (event) => {
    expect(event.error.message).toBe("a!");
    done();
    window.removeEventListener('error', errorHandler); // 清理监听
  };
  window.addEventListener('error', errorHandler);
  
  getPromise(); // 执行被测逻辑
});

RxJS场景使用fakeAsync+tick #

用Angular的fakeAsync同步执行RxJS的异步调度任务，确保错误被Observable的error流捕获：

import { fakeAsync, tick } from '@angular/core/testing';

fit("测试RxJS异步错误", fakeAsync(() => {
  let capturedError: Error | null = null;
  getObs$().subscribe({
    error: (err) => capturedError = err
  });

  tick(100); // 推进时间，执行所有待处理的异步任务
  expect(capturedError?.message).toBe("a!");
}));

正确处理Promise拒绝的测试写法 #

当被测代码正确返回rejected Promise时，使用以下测试方式：

// 方式1：使用rejects.toThrow
fit("用rejects断言Promise拒绝", async () => {
  await expect(getPromise()).rejects.toThrow("a!");
});

// 方式2：使用expectAsync
fit("用expectAsync断言拒绝", async () => {
  await expectAsync(getPromise()).toBeRejectedWithError("a!");
});

• 严禁在Promise执行器的异步回调中直接throw，必须使用reject；RxJS中严禁在异步调度回调中直接throw，需通过subscriber.error或throwError抛出错误。
• Karma/Jasmine环境中，未处理的全局异步错误会直接导致测试失败，因此核心原则是让错误进入Promise/Observable的错误处理链，而非逃逸到全局。

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