TypeScript Jest 单元测试 搭建

NPM TypeScript 项目搭建

创建目录

mkdir mockprojectcd mockproject

初始化NPM项目

npm init -y

安装TypeScript

npm i -D typescript

使用VSCode 打开项目

创建TS配置文件tsconfig.json

{"compilerOptions": {"target": "es5","module": "commonjs","declaration": true,"outDir": "./lib","strict": true,"lib": ["es6"]},"include": ["src"],"exclude": ["node_modules"]
}

创建src 目录，创建文件src/index.ts 内容如下：

export const Hello = (name: string) => `Hello ${name}`;

在package.json中的scripts中添加ts的构建命令

"build": "tsc"

CTRL + ` 打开终端测试构建。

npm run build

构建完成后可以发现项目目录中多了lib 里面就是我们的Hello函数。

Jest 单元测试集成

安装依赖

npm i -D jest ts-jest @jest/globals

安装后package.json中开发依赖将会出现如下：

生成Jest配置文件

npx ts-jest config:init

jest.config.js 生成内容如下：

/** @type {import('ts-jest').JestConfigWithTsJest} **/
module.exports = {testEnvironment: "node",transform: {"^.+.tsx?$": ["ts-jest",{}],},
};

在package.json中添加单元测试命令，若原来有test命令则删除，填入一下内容。

"test": "jest"

通常会建立一个tests目录用于存放测试用例，tests中的测试用名称与被测试对象名称保持一致，但是添加上.test.ts后缀，目录结构也保持一致。

创建测试目录tests，创建测试文件tests/index.test.ts

import { describe, expect, test } from '@jest/globals';
import { Hello } from '../src/index';describe('Mock module', () => {test('Hello world', () => {expect(Hello("abc")).toBe("Hello abc");});
});

打开终端使用测试命令执行测试

npm run test

可以看到执行测试后执行我们定义的测试用例，并提示了Pass的提示。

参考文献

[1]. 掘金 . [译文]一步步构建发布一个 TypeScript NPM 包 . 小被子 . 2019.07 . https://juejin.cn/post/6844903892119977998
[2]. jest . Getting Started . 2024 . https://jestjs.io/docs/getting-started