An asynchronous test case that uses both expectAsync and done can fail because done finishes the test before the asynchronous code completes. Awaiting the result of expectAsync doesn't help if the asynchronous part takes longer than the call to done. The error being displayed when running Jasmine doesn't mention this possibility, making the developer focus on the wrong thing.

Expected Behavior

The error would also mention the possibility of calling done() before expectAsync has completed.

Current Behavior

The error only hints at forgetting to return/await expectAsync.

Possible Solution

Extend the error message with another line, e.g:

Did you forget to return or await the result of expectAsync?
Did you call done() before expectAsync had a chance to complete?

Suite that reproduces the behavior (for bugs)

describe("sample",() => {
  it('sample', async done => {
    setTimeout(() => {
      done();
    });
    await expectAsync(somethingThatTakesLongerThanSetTimeout).toBeRejected();
  });
});

Context

Combining an async test case with done() is hopefully very rare, but it happens, especially when combining XHR with events in a single test case.

Your Environment

• Version used: 3.6.0
• Environment name and version (e.g. Chrome 39, node.js 5.4): Chrome 84
• Operating System and version (desktop or mobile): Ubuntu Linux desktop
• Link to your project: N/A