Mock 配置

Mock 配置用于定义单个接口的 Mock 响应行为。

基本结构

import { defineMock } from 'vite-plugin-mock-dev-server'

export default defineMock({
  url: '/api/test',
  method: 'GET',
  body: { message: 'Hello World' },
})

配置项概览

配置项	类型	必填	默认值	说明
url	string	是	-	请求路径，支持动态参数
method	Method | Method[]	否	['GET','POST']	允许的 HTTP 方法
enabled	boolean	否	true	是否启用
status	number	否	200	响应状态码
statusText	string	否	'OK'	响应状态文本
headers	Headers | Function	否	-	响应头
body	ResponseBody | Function	否	{}	响应体
response	Function	否	-	自定义响应处理
delay	number | [number, number]	否	0	响应延迟
cookies	ResponseCookies | Function	否	-	响应 Cookies
validator	Validator | Function	否	-	请求验证器
scene	string | string[]	否	-	场景标识，用于过滤
error	MockErrorConfig	否	-	错误模拟配置

多个配置

可以在一个文件中导出多个 Mock 配置：

import { defineMock } from 'vite-plugin-mock-dev-server'

export default defineMock([
  {
    url: '/api/users',
    method: 'GET',
    body: [],
  },
  {
    url: '/api/users',
    method: 'POST',
    body: { id: 1 },
  },
])

详细文档

查看 API 参考 - MockHttpItem 获取完整的配置项说明和示例。