Help us understand the problem. What is going on with this article?

TypeScript + Express + Jest でmockを使った簡単なユニットテストを書く

More than 1 year has passed since last update.

このドキュメントについて。

TypeScriptで書かれたExpressの簡単なファイルをJestで書いたもののメモです。
タイトルの3つの技術についての解説は行いません。

書いたコードの解説

試したかったことは、Jestのmock機能です。
TypeScript + Expressで実装された、モジュールをimportしている関数を用意します。
そのモジュールをJestの機能でmock化し、関数のユニットテストを書くサンプルです。

テスト対象コード

Expressのルーターから呼ばれるgetJson.tsです。
受け取ったreqreq.query.priceaddYen.execに渡し、返り値をJSON形式に詰めて返しています。
こちらのテストを書きます。

src/getJson.ts
import * as express from 'express'
import * as addYen from "./addYen";

export default (req: express.Request, res: express.Response, next?: express.NextFunction) => {
    const yenPrice: string = addYen.exec(req.query.price);
    res.json({ price: yenPrice });
}

テスト対象がimportしているコード

getJson.tsがimportしているaddYen.tsです。
引数に「円」を付けて返すだけの関数execを持っています。

src/addYen.ts
export function exec (req: string){
    return req + "";
}

これらを準備したら、テストコードを書きます。

テストコード

test/getJson.test.ts
import { mockReq, mockRes } from "sinon-express-mock";

// テスト対象がimportしているモジュールをモック化する
jest.mock('../src/addYen', () => ({
  exec: jest.fn(() => `100 円`),
}));

// モックを読み込み
const addYen = require('../src/addYen');

// テスト対象を読み込み
import getJson from "../src/getJson";

describe("getJson", () => {
  it("正常に処理が終了する", () => {
    // Expressのrequestオブジェクトとresponseオブジェクトをモック化
    const request = {
      query: {
        price: "100"
      }
    };
    const req = mockReq(request);
    const res = mockRes();

    // テスト対象を実行
    getJson(req, res);

    // addYen.exec()が引数request.query.priceで実行されていることを検証
    expect(addYen.exec).toBeCalledWith(request.query.price);
    // addYen.exec()が1度だけ実行されていることを検証
    expect(addYen.exec.mock.calls.length).toBe(1);
  });
});

ディレクトリ構成は以下のようになっています。

├── src
│   ├── addYen.ts
│   └── getJson.ts
├── test
│   └── getJson.test.ts

ひとまずやりたかったことはできました。

やってみての疑問

Jestの機能

今回テストコードの中で、Expressのrequestオブジェクトとresponseオブジェクトをモック化するためにsinon-express-mockをimportしましたが、Jestにそういった機能があるかは調べていませんので、もしかしたらJestだけで今回のテストコードが書けるかも、、?
supertest的なこともできるのかな?

requireとimportの違い

テストコードでのモック読み込み部分ですが、importではうまくいかなかったのですが、requireにすることで実行できました。
requireとimportについて、もっと中身を知らないと。。

test/getJson.test.ts
// モックを読み込み
// requireでは動いて、
const addYen = require('../src/addYen');
// importでは動かなかった。。
import * as addYen from '../src/addYen';

参考文献

Why do not you register as a user and use Qiita more conveniently?
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away
Comments
Sign up for free and join this conversation.
If you already have a Qiita account
Why do not you register as a user and use Qiita more conveniently?
You need to log in to use this function. Qiita can be used more conveniently after logging in.
You seem to be reading articles frequently this month. Qiita can be used more conveniently after logging in.
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away