Mock 规则

一个 mock 文件可以导出单条或多条规则。规则字段如下：

• handler: 响应内容或处理函数（必填）
• enabled: 启用/禁用该规则（默认 true）
• status: 状态码
• headers: 响应头
• delay: 延迟毫秒数

JSON / JSONC

直接返回 JSON 内容，支持注释与尾逗号：

{
  // user profile
  "id": 1,
  "name": "Ada"
}

TS/JS

导出对象或数组：

export default {
  status: 201,
  headers: { 'x-mock': 'ok' },
  handler: { ok: true },
}

提示：可以使用 defineHandler 包裹 TS/JS 规则以获得更好的类型提示：

import { defineHandler } from 'mokup'

export default defineHandler({
  status: 201,
  headers: { 'x-mock': 'ok' },
  handler: { ok: true },
})

数组导出仍使用文件路由生成路径，重复路由会提示告警。

Faker 集成

在 TS/JS 处理器中使用 @faker-js/faker 生成更真实的随机数据：

import type { RequestHandler } from 'mokup'
import { faker } from '@faker-js/faker'

const handler: RequestHandler = () => ({
  id: faker.string.uuid(),
  name: faker.person.fullName(),
  email: faker.internet.email(),
  createdAt: faker.date.recent({ days: 30 }).toISOString(),
})

export default handler

提示：也可以用 defineHandler 包裹 handler 以获得更好的类型提示：

import type { RequestHandler } from 'mokup'
import { faker } from '@faker-js/faker'
import { defineHandler } from 'mokup'

const handler: RequestHandler = () => ({
  id: faker.string.uuid(),
  name: faker.person.fullName(),
  email: faker.internet.email(),
  createdAt: faker.date.recent({ days: 30 }).toISOString(),
})

export default defineHandler(handler)

可选：通过 seed 保证可复现的数据（建议放在共享模块中统一设置一次）：

import { faker } from '@faker-js/faker'

faker.seed(123)