@forsakringskassan/apimock-express

中文文档

4.4.0发布于 2026/11/06MITTypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 2.9万

用于在开发期间用 json & js 文件模拟 API 调用 .

文档目录22 节

使用量
连接
有快车
与维特
带有 Vue CLI
模拟文件和目录结构
目录
通关卡/ 全局文件
模拟配置
apimock.config
文件格式
简单格式
高级格式
实例
使用帮助
更多实例
内在模拟
基本内含模拟
混合内线和基于文件的模拟
内含有条件的反应
浏览器模式 (MSW)
浏览器模式( 手工)

@forsakringskassan/ apimock- 表达

一个用于 grunt-contrib-连接插件的中间软件,该插件用文件系统中的json-文件来嘲弄一个 REST api. 使您的客户端代码很容易独立于服务器进行开发和测试.

这原本是从连接- 相扑通过快车叉 apimock 表达式。。。 .

与原文的主要区别:

与快通和通通同时工作(不特别要求Grunt).
支持两者 .mjs/.cjs/.js/.ts/.mts 财务报告和审定财务报表 .json 嘲讽.
支持通配符作为最终路径组件.
改进和可配置的伐木.
帮助者,例如: defineMock 帮助 IDE 写作模拟.
字体支持 .
已建 Vite 插件 .

使用量

npm 安装 - save- dev @ forsakringskassan/ apimock- expression

连接

const apimock = require("@forsakringskassan/apimock-express");
const http = require("http");
const connect = require("connect");

const app = connect();

/* setup mocks */
apimock.config([
    { url: "/api/foo", dir: "tests/mock/foo" },
    { url: "/api/bar", dir: "tests/mock/bar" },
]);

/* install middleware */
app.use("/", apimock.mockRequest);

http.createServer(app).listen(3000);

有快车

const apimock = require("@forsakringskassan/apimock-express");
const express = require("express");

const app = express();

/* setup mocks */
apimock.config([
    { url: "/api/foo", dir: "tests/mock/foo" },
    { url: "/api/bar", dir: "tests/mock/bar" },
]);

/* install middleware */
app.use("/", apimock.mockRequest);

app.listen(3000);

与维特

import { defineConfig } from "vite";
import { vitePlugin as apimockPlugin } from "@forsakringskassan/apimock-express";

export default defineConfig({
    plugins: [
        apimockPlugin([
            { url: "/api/foo", dir: "tests/mock/foo" },
            { url: "/api/bar", dir: "tests/mock/bar" },
        ]),
    ],
});

带有 Vue CLI

vue.config.js

const { defineConfig } = require("@vue/cli-service");
const apimock = require("@forsakringskassan/apimock-express");

apimock.config([
    { url: "/api/foo", dir: "tests/mock/foo" },
    { url: "/api/bar", dir: "tests/mock/bar" },
]);

module.exports = defineConfig({
    devServer: {
        before(app) {
            /* install middleware */
            app.use("*", apimock.mockRequest);
        },
    },
});

模拟文件和目录结构

被嘲笑的API包括一些 .mjs/.cjs/.js/.ts/.mts 或者说 .json 在代表 API 的目录结构中的文件.

例如,采用这种配置 { "url": "/myApp/api/", "dir": "mymockdirectory" },然后阿皮莫克这样工作:

方法	请求	文件名
`GET`	`/myApp/api/users`	`mymockdirectory/users.json`
`POST`	`/myApp/api/users`	`mymockdirectory/users_post.json`
`GET`	`/myApp/api/users/1`	`mymockdirectory/users/1.json`
`PUT`	`/myApp/api/users/1`	`mymockdirectory/users/1_put.json`
`DELETE`	`/myApp/api/users/1`	`mymockdirectory/users/1_delete.json`

文件的格式可以简单或者高级格式.

在使用简单格式时,文件内容会被作为回复正文和http-status 200被返回.
在使用高级格式时,可以根据请求参数,正文参数,请求头或请求的cookie来指定不同的响应和不同的http-status.

方法	请求	文件名
`GET`	`/myApp/api/foo`	`mymockdirectory/foo/__get.json`
`POST`	`/myApp/api/foo`	`mymockdirectory/foo/__post.json`

通关卡/ 全局文件

如果文件的格式 __default.json 存在于文件夹中,如果找不到特定文件,则会使用.

模拟配置

`apimock.config`

类型 : object 或者说 array 对象

含有 apimock 配置的对象. 见下文. 如果您想要模拟不同的 URL:s 来区分目录, 也可以成为一系列对象 .

apimock.config([
    { url: "/api1/", dir: "test/api1" },
    { url: "/api2/", dir: "test/api2", delay: 500 },
]);

`url`

类型 : String

要求 : 对

您想要嘲笑的 REST - api 的url 开始 .

`dir`

类型 : String

要求 : 对

Apimock 模拟文件所在的目录 . 位置相对于当前工作目录.

`delay`

类型 : Number

要求 : 没有

默认值 : 0 个

基数延迟(以毫秒为单位),用于此url的所有请求,在模拟器回复之前.

文件格式

模拟文件可以简单或高级的形式写成JSON或JS.

如果可以获取相同的响应正文和HTTP- status 200, 请使用简单格式 .

如果您需要根据请求参数获得不同的响应或HTTP-状态,请求正文,请求头或cookie使用高级格式.

简单格式

这很简单. 文件内容将作为HTTP-status 200的回复正文返回.

mymockdirectory/users.json数字 :

[
    { "userId": 1, "name": "Fred Flintstone" },
    { "userId": 2, "name": "Barney Rubble" }
]

高级格式

如果文件中的对象有变量, apimock 将会切换到高级格式 responses 或/和变量 defaultResponse 根位为!=未定义. 如果没有一个变量被定义,那么内容就被认为是简单的格式.

mymockdirectory/users.json数字 :

{
    "responses": [
        {
            "request": {
                "cookies": {
                    "myapi": "no-users"
                }
            },
            "response": {
                "status": 200,
                "body": []
            }
        }
    ],
    "defaultResponse": {
        "status": 200,
        "body": [
            { "userId": 1, "name": "Fred Flintstone" },
            { "userId": 2, "name": "Barney Rubble" }
        ]
    }
}

默认响应

类型 : Object

要求 : 对

如果响应数组中没有任何请求匹配, 默认响应将被重现 .

默认响应. status

类型 : Number

要求 : 没有

默认值 : 200个

HTTP 状态 .

默认响应. body

类型 : Object

要求 : 对

反应体.

默认Response.delay

类型 : Number

要求 : 没有

默认值 : 0 个

模拟器出现前的延迟数以毫秒计将做出回应.

答复

类型 : Array

要求 : 没有

包含所需请求和将返回的响应的一系列对象.

答复

类型 : Object

要求 : 对

描述匹配标准.

答复、请求、参数

类型 : Object

要求 : 没有

请求中需要匹配的参数名称和值 .

回应请求机构

类型 : Object

要求 : 没有

此响应需要匹配的请求对象参数的名称和值 .

答复、要求、标题

类型 : Object

要求 : 没有

此响应需要匹配的请求头名称和值 .

回应

类型 : Object

要求 : 没有

此响应需要匹配的请求 cookie 的名称和值 .

答复

类型 : Object

要求 : 对

描述如果请求匹配将重现的响应 .

答复、答复、状况

类型 : Number

要求 : 没有

默认值 : 200个

HTTP 状态 .

答答问问题

类型 : Object

要求 : 对

反应体.

答复、答复、延迟

类型 : Number

要求 : 没有

默认值 : 0 个

模拟器出现前的延迟数以毫秒计将做出回应.

实例

取决于请求参数的不同响应:

{
    "responses": [
        {
            "request": {
                "parameters": {
                    "foo": "bar",
                    "bar": "foo"
                }
            },
            "response": {
                "status": 401,
                "body": {
                    "message": "Two parameters matches"
                }
            }
        },
        {
            "request": {
                "parameters": {
                    "foo": "bar"
                }
            },
            "response": {
                "status": 402,
                "body": {
                    "message": "One parameter matches"
                }
            }
        }
    ],
    "defaultResponse": {
        "status": 201,
        "body": {
            "message": "Nothing matches. Default response"
        }
    }
}

取决于请求机构的不同答复:

{
    "responses": [
        {
            "request": {
                "body": {
                    "user": { "firstname": "Luke", "lastname": "Skywalker" }
                }
            },
            "response": {
                "status": 403,
                "body": {
                    "message": "Two body parameters matches"
                }
            }
        },
        {
            "request": {
                "body": {
                    "foo": "bar"
                }
            },
            "response": {
                "status": 404,
                "body": {
                    "message": "One body parameter matches"
                }
            }
        }
    ],
    "defaultResponse": {
        "status": 201,
        "body": {
            "message": "Nothing matches. Default response"
        }
    }
}

请求参数和请求正文的组合

{
    "responses": [
        {
            "request": {
                "parameters": {
                    "foo": "bar"
                },
                "body": {
                    "bar": "foo"
                }
            },
            "response": {
                "status": 400,
                "body": {
                    "message": "Both parameter and body matches"
                }
            }
        }
    ],
    "defaultResponse": {
        "status": 201,
        "body": {
            "message": "Nothing matches. Default response"
        }
    }
}

不同请求标题的不同响应 :

{
    "responses": [
        {
            "request": {
                "headers": {
                    "header1": "one",
                    "header2": "two"
                }
            },
            "response": {
                "status": 401,
                "body": {
                    "message": "When the headers header1=one and header2=two"
                }
            }
        }
    ],
    "defaultResponse": {
        "status": 201,
        "body": {
            "message": "Nothing matches. Default response"
        }
    }
}

根据请求 cookie 的不同响应 :

{
    "responses": [
        {
            "request": {
                "cookies": {
                    "foo": "foo"
                }
            },
            "response": {
                "status": 400,
                "body": {
                    "message": "When cookie foo=foo"
                }
            }
        }
    ],
    "defaultResponse": {
        "status": 201,
        "body": {
            "message": "Nothing matches. Default response"
        }
    }
}

延迟回复 :

{
    "responses": [
        {
            "request": {
                "parameters": {
                    "foo": "foo"
                }
            },
            "response": {
                "status": 200,
                "body": {
                    "message": "Delayed 500 milliseconds"
                },
                "delay": 500
            }
        }
    ],
    "defaultResponse": {
        "status": 200,
        "body": {
            "message": "Delayed 1000 milliseconds"
        },
        "delay": 1000
    }
}

使用帮助

使用提供的帮助函数设置模拟往往比较简单.

这个 `createMockByCookie(...)` 帮助函数

这个 createMockByCookie(...) 帮助函数根据特定的cookie设置模拟响应. 如果使用正确,Typescript还可以帮助为饼干及其可能值提供类型安全.

import {
    createMockByCookie,
    type MockCookieValue,
} from "@forsakringskassan/apimock-express/helpers";

interface MyResponseType {
    message: string;
}

export const getSomethingMockCookie = {
    name: "api-get-something",
    values: {
        foo: "foo-200",
        bar: "bar-200",
        foobar: "foobar-500",
    },
} as const; // { ... } as const is important to get proper type safety

// The type below can also be used by consumer for getting the cookie name and its possible values
export type GetSomethingMockCookie = typeof getSomethingMockCookie;

export default createMockByCookie<
    MockCookieValue<GetSomethingMockCookie>,
    MyResponseType
>({
    meta: {
        title: "GET /something",
    },
    cookieName: getSomethingMockCookie.name,
    responses: {
        "foo-200": {
            label: "Foo (200)",
            body: { message: "yay" },
        },
        "bar-200": {
            label: "Bar (200)",
            body: { message: "nay" },
        },
        "foobar-500": {
            label: "Foo (500)",
            status: 500,
        },
    },
    defaultResponse: {
        label: "Default (200)",
        body: { message: "default" },
    },
});

内在模拟

Inline 模拟让您直接在代码中定义模拟响应,而不是创建文件夹结构.

URL 和 HTTP 方法在内部声明 meta 而不是从文件路径导出.

基本内含模拟

import apimock from "@forsakringskassan/apimock-express";
import { defineMock } from "@forsakringskassan/apimock-express/helpers";

const mock = defineMock({
    meta: {
        url: "/api/users",
        method: "GET",
    },
    defaultResponse: {
        status: 200,
        body: [
            { userId: 1, name: "Fred Flintstone" },
            { userId: 2, name: "Barney Rubble" },
        ],
    },
});

apimock.config([mock]);

`meta.url`

类型 : String

要求 : 对

此模拟应答的 URL 前缀。与基于文件的模拟不同,URL必须在这里明确设置.

内置模拟 URL 支持使用冒号前缀的路径参数. 对于实例, /api/users/:userId 匹配 /api/users/123。每个参数捕获一个非空路段, 当选择一个响应。所有其他 URL 片段必须精确匹配 .

const mock = defineMock({
    meta: {
        url: "/api/users/:userId",
        method: "GET",
    },
    defaultResponse(request) {
        return {
            status: 200,
            body: { message: `user ${request.parameters.userId} response` },
        };
    },
});

`meta.method`

类型 : String (单位:千美元)"GET" | "POST" | "PUT" | "DELETE"(中文(简体) )

要求 : 没有

HTTP方法可以匹配. 省去模型时,会响应任何方法的要求.

混合内线和基于文件的模拟

内置模拟和基于文件的模拟可以合并

apimock.config([
    { url: "/api/foo", dir: "tests/mock/foo" },
    defineMock({
        meta: { url: "/api/bar", method: "GET" },
        defaultResponse: { body: { bar: true } },
    }),
]);

当一个请求既匹配了内在模拟,又匹配了基于文件的模拟,则内在模拟优先.

内含有条件的反应

Inline 模拟支持与基于文件的模拟相同的高级响应匹配——在请求参数,标题,饼干或正文上匹配:

const mock = defineMock({
    meta: {
        url: "/api/users",
        method: "POST",
    },
    responses: [
        {
            request: { body: { name: "" } },
            response: { status: 400, body: { error: "Name is required" } },
        },
    ],
    defaultResponse: {
        status: 201,
        body: { userId: 3, name: "New User" },
    },
});

浏览器模式 (MSW)

@forsakringskassan/apimock-express 有可选支持 MSW (西班牙语)数字 :

import { setupWorker } from "@forsakringskassan/apimock-express/browser";

await setupWorker("/mock-service-worker.js", [
    {
        meta: {
            url: "/private/foo/basic",
            method: "GET",
        },
        defaultResponse: {
            body: {
                foo: "bar",
            },
        },
    },
]);

这个 /mock-service-worker.js 参数应该是 msw/mockServiceWorker.js 剧本.

浏览器模式( 手工)

匹配请求帮助器让您运行 API 完全在浏览器中模拟 . 它接受一系列模拟定义( 用定义Mock 创建) 和本地获取 Request 对象,并返回模拟的获取 Response 表现得像一个真正的反应.

import { matchRequest } from "@forsakringskassan/apimock-express/browser";
import { defineMock } from "@forsakringskassan/apimock-express/helpers";

// Create basic mock
const mock = defineMock({
    meta: {
        url: "/private/foo/basic",
        method: "GET",
    },
    defaultResponse: {
        body: {
            foo: "bar",
        },
    },
});

const req = new Request("/private/foo/basic", { method: "GET" });
const fetchResponse = await matchRequest([mock], req);

console.log(fetchResponse.status); // => 200
console.log(await fetchResponse.json()); // => {"foo": "bar"}

版本与发布记录

@forsakringskassan/apimock-express 共发布 52 个版本，首次发布于 2024/03/06；过去 12 个月发布了 18 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。

版本	发布日期	距今
`4.4.0`latest	2026/11/06	9 天前
`4.3.0`	2026/10/23	23 天前
`4.2.1`	2026/09/25	1 个月前
`4.2.0`	2026/09/24	1 个月前
`4.1.0`	2026/09/11	2 个月前
`4.0.0`	2026/09/09	2 个月前

关于 @forsakringskassan/apimock-express 的常见问题

@forsakringskassan/apimock-express 是什么？

用于在开发期间用 json & js 文件模拟 API 调用 .

如何安装 @forsakringskassan/apimock-express？

在项目目录运行 npm install @forsakringskassan/apimock-express，或使用 pnpm add / yarn add / bun add。

@forsakringskassan/apimock-express 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

@forsakringskassan/apimock-express 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require() 都可以使用，打包工具会自动选择合适的版本。

@forsakringskassan/apimock-express 需要什么版本的 Node.js？

package.json 的 engines 字段要求 Node.js ^22 || >= 24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

@forsakringskassan/apimock-express 可以商用吗？

@forsakringskassan/apimock-express 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

@forsakringskassan/apimock-express 的下载量有多少？

根据 npm 官方下载统计，@forsakringskassan/apimock-express 在 2026/10/16 – 2026/11/14 这 30 天内被下载 28,667 次，日均约 956 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@forsakringskassan/apimock-express 还在维护吗？

最新版本 4.4.0 发布于 2026/11/06（9 天前）；至今共发布 52 个版本，其中过去 12 个月发布了 18 个；首次发布于 2024/03/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

npm install @forsakringskassan/apimock-express

pnpmpnpm add @forsakringskassan/apimock-express
yarnyarn add @forsakringskassan/apimock-express
bunbun add @forsakringskassan/apimock-express

peer 依赖msw ^2.0.0 || ^3.0.0可选vite ^6.4.0 || ^7.0.0 || ^8.0.0可选

npm 7+ 与 pnpm 8+ 会自动安装必需的 peer 依赖，Yarn 需手动安装。

在你的项目目录中运行此命令。

近 30 天下载

28,667

约 2.9万次日均 956 次

统计周期 2026/10/16 – 2026/11/14
数据来自 npm 官方下载统计，今天更新

最新版本4.4.0发布于 9 天前

开源许可MIT宽松许可

包体积144 kB13 个文件 · 解压后

运行依赖0 个另有 2 个 peer 依赖

模块格式ESM + CJS

TypeScript自带类型

Node.js^22 || >= 24

发布版本52 个近 12 个月 18 个

首次发布2024/03/062 年前

元数据更新2026/11/06

每一个软件包背后，
都有分享与创造的人。

@forsakringskassan/apimock-express

@forsakringskassan/ apimock- 表达

使用量

连接

有快车

与维特

带有 Vue CLI

模拟文件和目录结构

目录

通关卡/ 全局文件

模拟配置

apimock.config

url

dir

delay

文件格式

简单格式

高级格式

默认响应

默认响应. status

默认响应. body

默认Response.delay

答复

答复

答复、请求、参数

回应 请求 机构

答复、要求、标题

回应

答复

答复、答复、状况

答 答 问 问 题

答复、答复、延迟

实例

使用帮助

这个 createMockByCookie(...) 帮助函数

更多实例

内在模拟

基本内含模拟

meta.url

meta.method

混合内线和基于文件的模拟

内含有条件的反应

浏览器模式 (MSW)

浏览器模式( 手工)

版本与发布记录

关于 @forsakringskassan/apimock-express 的常见问题

@forsakringskassan/apimock-express 是什么？

如何安装 @forsakringskassan/apimock-express？

@forsakringskassan/apimock-express 支持 TypeScript 吗？

@forsakringskassan/apimock-express 支持 ESM 还是 CommonJS？

@forsakringskassan/apimock-express 需要什么版本的 Node.js？

@forsakringskassan/apimock-express 可以商用吗？

@forsakringskassan/apimock-express 的下载量有多少？

@forsakringskassan/apimock-express 还在维护吗？

`apimock.config`

`url`

`dir`

`delay`

回应请求机构

答答问问题

这个 `createMockByCookie(...)` 帮助函数

`meta.url`

`meta.method`