简体中文
框架适配器
Mokup 的服务端适配器把同一个 Fetch runtime 暴露给 Next.js、Nuxt/Nitro 和 Astro。适配器不依赖框架包,因此可以直接用于应用、测试和自定义运行时,Mock 文件也不需要改写。
Next.js App Router
在 route module 中直接导出方法:
ts
// app/api/[...path]/route.ts
import { createNextRouteHandler } from '@mokup/server/next'
const routes = createNextRouteHandler({
manifest: { version: 1, routes: [] }, // 替换为生成的 .mokup manifest
onNotFound: 'response',
})
export const { GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS } = routesResolver 接收标准 Request,完整的 Next route context 位于 context.context.next。routes.use、routes.resetHandlers、routes.events、routes.selectScenario 和 routes.close 与其他适配器共享同一套控制 API。
Pages Router API route 可以使用 createNextApiHandler:
ts
import { createNextApiHandler } from '@mokup/server/next'
export default createNextApiHandler({ manifest })Nuxt 和 Nitro
createNuxtHandler 同时支持 Fetch event 和 Node Nitro event:
ts
// server/api/[...path].ts
import { createNuxtHandler } from '@mokup/server/nuxt'
export default createNuxtHandler({ manifest, onNotFound: 'response' })Nitro 提供 event.request 时适配器使用它;Node 部署则回退到 event.node.req/event.node.res。原始 event 位于 context.context.nuxt。
Astro
Astro endpoint 可以直接导出方法表:
ts
// src/pages/api/[...path].ts
import { createAstroEndpoint } from '@mokup/server/astro'
export const { GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS } = createAstroEndpoint({
manifest,
onNotFound: 'response',
})原始 Astro endpoint context 位于 context.context.astro,请求匹配仍使用原始 Fetch Request。
Runtime 与 fallback
三个适配器在没有命中 Mock 路由时默认返回明确的 404。宿主框架提供下游 fallback 时可以设置 onNotFound: 'next';如果 route module 没有下游处理器,Mokup 完成后仍会返回 404。每次工厂调用都会创建独立 session,适合并行测试。