520

I'm working with some code where I need to test the type of an exception thrown by a function (is it TypeError, ReferenceError, etc.?).

My current testing framework is AVA and I can test it as a second argument t.throws method, like here:

it('should throw Error with message \'UNKNOWN ERROR\' when no params were passed', (t) => {
  const error = t.throws(() => {
    throwError();
  }, TypeError);

  t.is(error.message, 'UNKNOWN ERROR');
});

I started rewriting my tests in Jest and couldn't find how to easily do that. Is it even possible?

1

23 Answers 23

749

In Jest you have to pass a function into expect(function).toThrow(<blank or type of error>).

Example:

test("Test description", () => {
  const t = () => {
    throw new TypeError();
  };
  expect(t).toThrow(TypeError);
});

Or if you also want to check for error message:

test("Test description", () => {
  const t = () => {
    throw new TypeError("UNKNOWN ERROR");
  };
  expect(t).toThrow(TypeError);
  expect(t).toThrow("UNKNOWN ERROR");
});

If you need to test an existing function whether it throws with a set of arguments, you have to wrap it inside an anonymous function in expect().

Example:

test("Test description", () => {
  expect(() => {http.get(yourUrl, yourCallbackFn)}).toThrow(TypeError);
});
10
  • 11
    Good one - may I ask why the anonimous function wrapper is needed? With the wrapper it works but not without it. Sep 16, 2020 at 8:15
  • 63
    @rags2riches the anonymous function is required because expect(x).toThrow() requires x to be a reference to a function that throws. If you instead pass expect(x()).toThrow(), JavaScript will resolve x(), which would likely cause the error immediately, and most likely fail your test.
    – Scott Chow
    Sep 24, 2020 at 16:17
  • The snippet provided in the question is checking a property of the thrown exception. This answer solves only 50% of the problem. Unavoidably we will have to use a try-catch block.
    – Mason
    Feb 9, 2021 at 10:23
  • 1
    @Mason - the person asking the question wanted to check the type of error (" I need to test the type of an exception thrown by a function..."), but I think its good idea to also include check for error message for those wanting to check that.
    – PeterDanis
    Feb 9, 2021 at 13:26
  • 38
    @GerasimosRagavanis when you're testing an async function you should await expect(yourAsyncFn(...)).rejects.toThrow(...), like answered by Douglas Caina here. Sep 15, 2021 at 17:53
199

It is a little bit weird, but it works and IMHO is good readable:

it('should throw Error with message \'UNKNOWN ERROR\' when no parameters were passed', () => {
  try {
      throwError();
      // Fail test if above expression doesn't throw anything.
      expect(true).toBe(false);
  } catch (e) {
      expect(e.message).toBe("UNKNOWN ERROR");
  }
});

The Catch block catches your exception, and then you can test on your raised Error. Strange expect(true).toBe(false); is needed to fail your test if the expected Error will be not thrown. Otherwise, this line is never reachable (Error should be raised before them).

@Kenny Body suggested a better solution which improve a code quality if you use expect.assertions():

it('should throw Error with message \'UNKNOWN ERROR\' when no parameters were passed', () => {
  expect.assertions(1);
  try {
      throwError();
  } catch (e) {
      expect(e.message).toBe("UNKNOWN ERROR");
  }
});

See the original answer with more explanations: How to test the type of a thrown exception in Jest

EDIT 2022:

To use this approach and not trigger no-conditional-expect rule (if you're using eslint-plugin-jest), documentation of this rule suggest to use error wrapper:

class NoErrorThrownError extends Error {}

const getError = async <TError>(call: () => unknown): Promise<TError> => {
  try {
    await call();

    throw new NoErrorThrownError();
  } catch (error: unknown) {
    return error as TError;
  }
};

describe('when the http request fails', () => {
  it('includes the status code in the error', async () => {
    const error = await getError(async () => makeRequest(url));

    // check that the returned error wasn't that no error was thrown
    expect(error).not.toBeInstanceOf(NoErrorThrownError);
    expect(error).toHaveProperty('statusCode', 404);
  });
});

See: no-conditional-expect docs

10
  • 37
    This is a very verbose way of testing for exceptions when Jest already has the expect.toThrow() way of checking for exceptions: jestjs.io/docs/en/expect.html#tothrowerror
    – gomisha
    Jun 26, 2018 at 13:51
  • 23
    Yes, but it tests only type, not message or other content and the question was about test message, not type. Aug 9, 2018 at 22:27
  • 2
    Hah. Really like this one as my code needs to test a value of the thrown error so I need the instance. I would write the faulty expectation like expect('here').not.toBe('here'); just for the fun of it :-)
    – Valery
    Aug 16, 2018 at 12:54
  • 21
    @Valery or: expect('to be').not.toBe('to be') in Shakespeare style. Oct 28, 2018 at 12:15
  • 12
    You don't need to make a fake assertion to fail - you can simply use fail(...) :)
    – jocull
    Mar 19, 2020 at 8:38
138

I use a slightly more concise version:

expect(() => {
  // Code block that should throw error
}).toThrow(TypeError) // Or .toThrow('expectedErrorMessage')
0
95

From my (albeit limited) exposure to Jest, I have found that expect().toThrow() is suitable if you want to only test an error is thrown of a specific type:

expect(() => functionUnderTest()).toThrow(TypeError);

Or an error is thrown with a specific message:

expect(() => functionUnderTest()).toThrow('Something bad happened!');

If you try to do both, you will get a false positive. For example, if your code throws RangeError('Something bad happened!'), this test will pass:

expect(() => functionUnderTest()).toThrow(new TypeError('Something bad happened!'));

The answer by bodolsog which suggests using a try/catch is close, but rather than expecting true to be false to ensure the expect assertions in the catch are hit, you can instead use expect.assertions(2) at the start of your test where 2 is the number of expected assertions. I feel this more accurately describes the intention of the test.

A full example of testing the type and message of an error:

describe('functionUnderTest', () => {
    it('should throw a specific type of error.', () => {
        expect.assertions(2);

        try {
            functionUnderTest();
        } catch (error) {
            expect(error).toBeInstanceOf(TypeError);
            expect(error).toHaveProperty('message', 'Something bad happened!');
        }
    });
});

If functionUnderTest() does not throw an error, the assertions will be be hit, but the expect.assertions(2) will fail and the test will fail.

5
  • D'oh. I always forget about the expecting multiple assertions feature of Jest (possibly I just don't personally find it the most intutitive, but it definitely works for such cases!) Cheers!
    – kpollock
    Sep 26, 2019 at 7:27
  • 3
    expect.hasAssertions() might a better alternative when the test doesn't have any assertions outside catch, because you don't have to update the number if you add/remove assertions. May 4, 2020 at 9:44
  • Another way to test the type and message is using toThrowWithMessage(type, message) from the jest-extended project. Oct 28, 2020 at 0:50
  • The solution is otherwise good, but what if functionUnderTest passes and expections under catch block are never tested? I'd recommend moving the expects under main functions so they'd always be tested Apr 15, 2021 at 8:29
  • 1
    @IlmariKumpula That's why you have the first line which defines how many assertions you are expecting. If the functionUnderTest passes and the catch block is never entered then the expects don't get hit and the test fails because two assertions were not made.
    – Kenny Body
    Sep 6, 2021 at 15:55
66

I manage to combine some answers and end up with this:

it('should throw', async () => {
    await expect(service.methodName('[email protected]', 'unknown')).rejects.toThrow(
      HttpException,
    );
  });
2
  • 4
    Small detailed that you mentioned here and saved me a lot of headache: the await statement should be outside expect, not inside. Thanks! Dec 8, 2022 at 10:03
  • yes, I missed the "rejected"
    – Kurt Chun
    Jan 13 at 7:59
47

Modern Jest allows you to make more checks on a rejected value. For example, you could test status code of http exception:

const request = Promise.reject({statusCode: 404})
await expect(request).rejects.toMatchObject({ statusCode: 500 });

will fail with error

Error: expect(received).rejects.toMatchObject(expected)

- Expected
+ Received

  Object {
-   "statusCode": 500,
+   "statusCode": 404,
  }
2
  • Re "more checks on a rejected value": Why is that useful? Can you elaborate? Preferably by editing your answer (without "Edit", "Update", or similar). Sep 24, 2020 at 21:08
  • THANK YOU SO MUCH Nov 17, 2021 at 22:27
33

Further to Peter Danis' post, I just wanted to emphasize the part of his solution involving "[passing] a function into expect(function).toThrow(blank or type of error)".

In Jest, when you test for a case where an error should be thrown, within your expect() wrapping of the function under testing, you need to provide one additional arrow function wrapping layer in order for it to work. I.e.

Wrong (but most people's logical approach):

expect(functionUnderTesting();).toThrow(ErrorTypeOrErrorMessage);

Right:

expect(() => { functionUnderTesting(); }).toThrow(ErrorTypeOrErrorMessage);

It's very strange, but it should make the testing run successfully.

4
  • 5
    Thanks for the answer. And it's incredible how the Jest's documentation can make things difficult by hidden important infos about the functionality. Sep 24, 2020 at 18:54
  • Even shorter is expect(functionUnderTesting).toThrow(ErrorTypeOrErrorMessage) Mar 24, 2022 at 18:35
  • Don't know why but even this way it doesn't work for me. When exceptions are thrown the tests running stop just like a fatal exception error instead of catching the error and asserting. Only approach that worked was using the try catch inside the test case Sep 29, 2022 at 14:58
  • Thanks, I was wondering why it would still complain about the test failing because an exception has been thrown. Wrapping it in a lambda worked like a charm
    – Metalfreak
    Jul 14 at 7:57
28

In case you are working with Promises:

await expect(Promise.reject(new HttpException('Error message', 402)))
  .rejects.toThrowError(HttpException);
2
21

Check out toThrow method.

You must wrap the code in an additional function callback!

You should check both: the error message and its type.

For example:

// additional function wrap
const wrap = () => {
  yourCodeToTest();
};

// test error message
expect(wrap).toThrow('UNKNOWN ERROR');

// test error type
expect(wrap).toThrow(TypeError);

Because of additional callback wrap, the code will not be run immediately, so jest will be able to catch it.

You should always check the error message to be sure you are checking the correct throw case and not getting another error your code may throw.

It is also nice to check the error type, so the client code may rely on it.

1
  • 1
    This way only checks the error message if you use new TypeError("error message"), better to check twice, one checks error message, and another one checks error type.
    – Kaiwen Luo
    Apr 28 at 1:17
20

There's a way to wait an error that comes from a async function, you just have to write your code like in the example bellow

await expect(yourAsyncFunction()).rejects.toThrowError();
17

You must wrap the code of the function that you are expecting in another arrow function, otherwise the error will not be caught and the assertion will fail.

the function you want to test :

const testThrowingError = () => {
    throw new Error();
  };

the test:

describe("error function should Throw Error", () => {
  expect(() =>testThrowingError()).toThrowError();
});

resource: https://jestjs.io/docs/expect#tothrowerror

15

I haven't tried it myself, but I would suggest using Jest's toThrow assertion. So I guess your example would look something like this:

it('should throw Error with message \'UNKNOWN ERROR\' when no parameters were passed', (t) => {
  const error = t.throws(() => {
    throwError();
  }, TypeError);

  expect(t).toThrowError('UNKNOWN ERROR');
  //or
  expect(t).toThrowError(TypeError);
});

Again, I haven't test it, but I think it should work.

13

I have successfully used this

await expect(
      async () => await apiCalls()
    ).rejects.toThrow();
12

Jest has a method, toThrow(error), to test that a function throws when it is called.

So, in your case you should call it so:

expect(t).toThrowError(TypeError);

The documentation.

1
  • 1
    It wouldn't work for the case: jest.spyOn(service, 'create').mockImplementation(() => { throw new Error(); }); if the mocked method create is not async.
    – Serg
    Mar 9, 2019 at 11:47
6

The documentation is clear on how to do this. Let's say I have a function that takes two parameters and it will throw an error if one of them is null.

function concatStr(str1, str2) {
  const isStr1 = str1 === null
  const isStr2 = str2 === null
  if(isStr1 || isStr2) {
    throw "Parameters can't be null"
  }
  ... // Continue your code

Your test

describe("errors", () => {
  it("should error if any is null", () => {
    // Notice that the expect has a function that returns the function under test
    expect(() => concatStr(null, "test")).toThrow()
  })
})
4

There is also an easier way to assert against the error message. The beauty of this method is that you don't need to reconstruct the error object or to have the full error message. As long as your error contains part of the error message we can assume that it is of the correct type. i.e

 const printOnlyString = (str) => {
   if(typeof str !== "string"){
     throw Error("I can only print strings ${typeof str) given");
   }
   else {
     console.log(str);
   } 
 }

expect(() => printOnlyString(123)).toThrow(/can only print strings/)
1
  • 1
    For everyone watching this answer. Note that your function should be called as a callback! ()=>yourFunction Mar 14 at 13:18
2

I ended up writing a convenience method for our test-utils library

/**
 *  Utility method to test for a specific error class and message in Jest
 * @param {fn, expectedErrorClass, expectedErrorMessage }
 * @example   failTest({
      fn: () => {
        return new MyObject({
          param: 'stuff'
        })
      },
      expectedErrorClass: MyError,
      expectedErrorMessage: 'stuff not yet implemented'
    })
 */
  failTest: ({ fn, expectedErrorClass, expectedErrorMessage }) => {
    try {
      fn()
      expect(true).toBeFalsy()
    } catch (err) {
      let isExpectedErr = err instanceof expectedErrorClass
      expect(isExpectedErr).toBeTruthy()
      expect(err.message).toBe(expectedErrorMessage)
    }
  }
2
2

To test whether a function throws a specific error message with a specific type of error, you can use Jest's toThrow() matcher

function myFunction() {
  throw new TypeError('Something went wrong');
}

describe('myFunction', () => {
  it('should throw a TypeError with a specific error message', () => {
    expect(myFunction).toThrow(TypeError);
    expect(myFunction).toThrow(/Something went wrong/);

    //noted: this way will invoke the myFunction twice
    expect(myFunction).toBeCalledTimes(2)
  });
});

If you use expect(myFunction).toThrow(new TypeError("Something went wrong"), it only checks the error message rather than the error type, which does not meet the test purpose.

2

Jest version: 29
You have an async function that needs to be tested for throwing an error.

await expect(listener.onMessage(data, msg)).rejects.toThrow();

Assert with exact error message:

await expect(listener.onMessage(data, msg)).rejects.toThrow("Data not found!");
0

A good way is to create custom error classes and mock them. Then you can assert whatever you want.

MessedUpError.ts

type SomeCrazyErrorObject = {
  [key: string]: unknown,
}

class MessedUpError extends Error {
  private customErrorData: SomeCrazyErrorObject = {};

  constructor(err?: string, data?: SomeCrazyErrorObject) {
    super(err || 'You messed up');

    Object.entries(data ?? {}).forEach(([Key, value]) => {
      this.customErrorData[Key] = value;
    });
    Error.captureStackTrace(this, this.constructor);
  }

  logMe() {
    console.log(this.customErrorData);
  }
}

export default MessedUpError;

messedUpError.test.ts

import MessedUpError from './MessedUpError';

jest.mock('./MessedUpError', () => jest.fn().mockImplementation((...args: any[]) => ({
  constructor: args,
  log: () => {},
})));

type MessedUpErrorContructorParams = Expand<typeof MessedUpError['prototype']>
const MessedUpErrorMock = MessedUpError as unknown as jest.Mock<MessedUpError, [MessedUpErrorContructorParams]>;

const serverErrorContructorCall = (i = 0) => ({
  message: MessedUpErrorMock.mock.calls[i][0],
  ...MessedUpErrorMock.mock.calls[i][1] || {},
});

beforeEach(() => {
  MessedUpErrorMock.mockClear();
});

test('Should throw', async () => {
  try {
    await someFunctionThatShouldThrowMessedUpError();
  } catch {} finally {
    expect(MessedUpErrorMock).toHaveBeenCalledTimes(1);
    const constructorParams = serverErrorContructorCall();
    expect(constructorParams).toHaveProperty('message', 'You messed up');
    expect(constructorParams).toHaveProperty('customErrorProperty', 'someValue');
  }
});

The assertions always go inside the finally clause. This way it will always be asserted. Even if the test does not throw any errors.

0

If you want something less verbose in your tests but want to test an Error is of a class and has a certain message (or status, or any other properties), you can write a custom matcher.

We use something pretty simple, but you can extend this to include RegExp, etc.

// In jest.setup.js
expect.extend({
  toThrowErrorWithMessage: (received, errorType, message) => {
    if (!received) {
      return {
        message: () =>
          `expected error to be of type ${errorType.name} with message matching ${message}, received ${received}`,
        pass: false,
      };
    }

    if (!(received instanceof errorType)) {
      return {
        message: () => `expected error of type ${errorType} received ${received}`,
        pass: false,
      };
    }

    const validMessage = received.message && received.message.match(message);

    if (!validMessage) {
      return {
        message: () =>
          `expected error message to match "${message}", received "${received.message}"`,
        pass: false,
      };
    }

    return {
      pass: true,
      // Note: this message is for when using .not
      message: () =>
        `expected error not to be of type ${errorType.name} with message matching "${message}"`,
    };
  },
});

// In a test
expect(() => validate()).rejects.toThrowErrorWithMessage(BadRequestError, 'Oh noes')
0

Similar to the try/catch, if you are looking to catch an error for an async function one can also just append a .catch() to the function to be able to access error value: await asyncFunc().catch(e => { expect(e.toString()).toBe("Error: My error message") }) or whatever functionality you are looking to test

-2

Try:

expect(t).rejects.toThrow()
2
  • 7
    Why try? there is not try - but answer. If this is answer please elaborate more. what you adding to the existing answer?
    – dWinder
    May 16, 2019 at 17:38
  • 12
    I think @Razim was saying that you should try the solution, not use a try catch.
    – Tom
    Aug 20, 2019 at 23:05

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.