ts-mock-cli v0.0.3

ts-mock-cli

前端经常在后端接口联调之前需要进行mock数据，对于一个复杂的api接口数据，我们一般会写ts类型数据定义，ts-mock-cli可以通过我们写的ts文件，同时配置类型名称生成我们想要的精准mock数据

1. 安装 & 使用

pnpm add -D ts-mock-cli

Usage: tsMock [options]

Options:
  -v, --version                   当前版本
  -c, --config <configFilePath>   配置文件 { dist, list: Array<{file, typeNameList}> }>
  -h, --help                      显示命令帮助

tsMock --config example/confifg.js

2. 配置文件参考

const path = require('path')

const resolve = (dir) => path.resolve(__dirname, dir)

module.exports = {
  // 文件输出目录（绝对路径）
  dist: resolve('../example/schema-json'),

  // 配置列表
  list: [
    {
      // 文件路径（绝对路径）
      file: resolve('../example/definations/index.ts'),

      // file文件中定义的类型名称列表
      typeNameList: ['IUser', 'IUserList', 'IPagingResponseData']
    }
  ]
}

3. 生成的文件目录

├── example
  ├── schema-json
    ├── IUser.json
    ├── IUserList.json
    ├── IPagingResponseData.json

4、ts类型定义

更多用法

export interface IUser {
  /**
   * 字符串：长度限制
   * @minLength 2
   * @maxLength 10
   */
  name: string

/**

• 中文字符串：长度限制；去我而他与哦怕{2,10}这种正则实现不起作用

• @pattern (?:去|我|而|他|与|哦|怕|是|对|方|过|后|就|哭|了){2,10} */ chineseName: string

  /**

• 字符串：正则匹配手机号码

• @pattern ^1\d{10}$ */ mobile: string

  /**

• 字符串：其他内置格式

• 内置格式还有 日期date，时间time，日期时间date-time，主机名hostname，IP地址ipv4，资源标识符uri，正则regex

• @format email */ email: string

  /** 数字：设置值的范围

• @minimum 10

• @maximum 100 */ height: number

  /**

• 数字：设置值的范围，10的倍数，模拟时间戳Date.now()

• @minimum 1667394203287
• @maximum 1668431201403

• @multipleOf 10 */ timestamp: number

  /**

• 简单数组 */ numArray: Array

  /**

• 元组 */ tupleArray: string, number, boolean

  /**

• otherInfo 对象成员必须有一个是固定，否则生成的成员名及值可能都是随机 / otherInfo: { /** 字符串：正则匹配身份证号码 @pattern ^\d{15}$|^\d{17}(\d|x|X)$ / idCard: string hobby?: '音乐' | '电影' | '篮球' | '足球' | '羽毛球' /** @minimum 2 @maximum 100 */ familyMembers?: number }, }

/**

• 每页请求数
• @minItems 20
• @maxItems 20 */ export type IUserList = IUser[]

/**

• 分页响应数据 */ export interface IPagingResponseData { records: IUserList, /**
  • 总条数
  • @minimum 100
  • @maximum 100 */ total: number }

PS：如果你的ts文件中使用到了全局声明文件中的类型，可以使用[三斜线指令](https://www.tslang.cn/docs/handbook/triple-slash-directives.html)，这里有一个好处如果tsMock失败，说明ts全局声明文件存在问题，可以帮助我们发现问题