In Jest, how do I mock a Promise of void?

Question

I'm using Jest and Typescript. I have a async function that returns nothing (void). How do I mock returning void? I tried the below

const myMockFn = jest.fn().mockImplementationOnce(() => Promise.resolve(void));
jest.mock('../config', () => ({
  setup: async () =>
  myMockFn(),
}));

but I get the compilation error

Expression expected.

related to "Promise.resolve(void)".

Should just be `Promise.resolve()` instead of `Promise.resolve(void)` — Nicholas Tower, Jun 29 '21 at 17:26

score 29 · Accepted Answer · answered Jun 29 '21 at 18:38

void used here in value position is javascript operator. It is a unary operator i.e. it accepts a single argument. Thus the error.

void as a typescript type should be used in type position to express that function return value will not be observed.

const myMockFn = jest.fn().mockImplementationOnce(() => Promise.resolve());

That's enough to mock a function with Promise<void> return type.

score 8 · Answer 2 · answered Oct 28 '22 at 02:08

You can mock a function that returns Promise<void> with:

jest.fn().mockResolvedValue(undefined)

If you try to capture the return value of a void function, you get undefined:

function foo(): void {
  console.log('foo called');
}

console.log(foo());

// foo called
// undefined

Additionally, Promise<void> appears to be the same as Promise<undefined>:

console.log(Promise.resolve());
// Promise { undefined }

console.log(Promise.resolve(undefined));
// Promise { undefined }

undefined is compatible with void and can be the resolved value:

interface Bar {
  foo(): Promise<void>;
}

describe('StackOverflow', () => {
  test('mock Promise<void>', async () => {
    const mockBar: Bar = {
      foo: jest.fn().mockResolvedValueOnce(undefined),
    };
    await mockBar.foo();
  });
});

Or to simplify the expression even further, `jest.fn().mockResolvedValue()`. — Priidu Neemre, Jan 26 '23 at 16:09

In Jest, how do I mock a Promise of void?

2 Answers2