异步示例

    Let’s implement a module that fetches user data from an API and returns the user name.

    user.js

    In the above implementation, we expect the request.js module to return a promise. We chain a call to then to receive the user name. We chain a call to then to receive the user name.

    Now imagine an implementation of request.js that goes to the network and fetches some user data:

    request.js

    1. const http = require('http');
    3. export default function request(url) {
    4.   return new Promise(resolve => {
    5.     // This is an example of an http request, for example to fetch
    6.     // user data from an API.
    7.     // This module is being mocked in __mocks__/request.js
    8.     http.get({path: url}, response => {
    9.       let data = '';
    10.       response.on('data', _data => (data += _data));
    11.       response.on('end', () => resolve(data));
    12.     });
    13.   });
    14. }

    __mocks__/request.js

    现在我们就来编写我们的异步函数的测试

    __tests__/user-test.js

    1. jest.mock('../request');
    2. import * as user from '../user';
    5. it('works with promises', () => {
    6.   expect.assertions(1);
    7.   return user.getUserName(4).then(data => expect(data).toBe('Mark'));
    8. });

    我们调用 jest.mock('../request ') 告诉jest 使用我们手动的创建的模拟数据。 通过 resolves能更加简单地解析一个fulfilled 态的 Promise的返回值. 如果Promise是rejected态的话, 断言将会返回失败. it 断言的是将会返回一个Promise对象. You can chain as many Promises as you like and call expect at any time, as long as you return a Promise at the end.

    There is a less verbose way using resolves to unwrap the value of a fulfilled promise together with any other matcher. If the promise is rejected, the assertion will fail.

    1. // 使用async/await
    2. it('works with async/await', async () => {
    3.   expect.assertions(1);
    4.   const data = await user.getUserName(4);
    5.   expect(data).toBe('Mark');
    6. });
    8. // async/await can also be used with `.resolves`.
    9. it('works with async/await and resolves', async () => {
    10.   expect.assertions(1);
    11.   await expect(user.getUserName(5)).resolves.toBe('Paul');
    12. });

    To enable async/await in your project, install @babel/preset-env and enable the feature in your babel.config.js file.

    可以使用 .catch 方法处理错误。 请确保添加 来验证一定数量的断言被调用。 否则一个fulfilled态的Promise 不会让测试失败︰

    The.rejects helper works like the .resolves helper. 如果 Promise 被拒绝，则测试将自动失败。 如果 Promise 被拒绝，则测试将自动失败。 expect.assertions(number) is not required but recommended to verify that a certain number of are called during a test. It is otherwise easy to forget to return/await the .resolves assertions.

    1. // 用`.rejects`.来测试一个异步的错误
    2. it('tests error with rejects', () => {
    3.   expect.assertions(1);
    4.   return expect(user.getUserName(3)).rejects.toEqual({
    5.     error: 'User with 3 not found.',
    6.   });
    7. });
    9. // 或者与async/await 一起使用 `.rejects`.
    10. it('tests error with async/await and rejects', async () => {
    11.   expect.assertions(1);
    12.   await expect(user.getUserName(3)).rejects.toEqual({
    13.     error: 'User with 3 not found.',
    14.   });
    15. });
    16. it('tests error with async/await and rejects', async () => {
    17.   expect.assertions(1);
    18.   await expect(user.getUserName(3)).rejects.toEqual({
    19.     error: 'User with 3 not found.',

    The code for this example is available at examples/async.

    If you’d like to test timers, like setTimeout, take a look at the documentation.