JestのPromisesに関して

Question

Jestの公式で次のようなコードを見かけました

test('the data is peanut butter', () => {
  return fetchData().then(data => {
    expect(data).toBe('peanut butter');
  });
});

これを元に次のような簡単なテストを作成しました.

const fetch = async (n) => {
  return n;
};

test("the res.data.id id is 3", () => {
  fetch(10).then((data) => {
    expect(data).toBe(10);
  });
})

ここで思ったので別にfetchの前にreturnをつけてもつけなくても正常にテストが動いているところです.
returnの必要性ってありますか？

Answer 1

手元の環境だと、テストを落ちるようにしてもテストは通り、これは Promise が待ち合わされていないために、 expect の行が実行されていないためです。
ちなみに1つも expect がない場合に、そのテストは Pass するので要するに空のテストと同じ動作となっています。

const fetch = async (n) => {
  return n;
};

test("the res.data.id id is 3", () => {
  fetch(10).then((data) => {
    expect(data).toBe(15); // 15 にしたら通らないはず
  });
});

test("the res.data.id id is 3", () => {
  // これと同じ意味になっている
});

  ✓ the res.data.id id is 3 (3ms)

Test Suites: 1 passed, 1 total
Tests:       1 passed, 1 total

return をつけることで Promise を待ち合わせてくれるので、

const fetch = async (n) => {
  return n;
};

test("the res.data.id id is 3", () => {
  return fetch(10).then((data) => {
    expect(data).toBe(15);
  });
});

    expect(received).toBe(expected) // Object.is equality

    Expected: 15
    Received: 10

       5 | test("the res.data.id id is 3", () => {
       6 |   return fetch(10).then((data) => {
    >  7 |     expect(data).toBe(15);
         |                  ^
       8 |   });
       9 | });
      10 | 

と正常にエラーを吐きます。 & 10とすればテストをパスします。