mock-service-cli 4.5.1 → 4.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -7
- package/dist/meta.json +1803 -417
- package/dist/runtime.js +37 -27
- package/docs/static-server.config.example.json +44 -9
- package/package.json +3 -6
package/README.md
CHANGED
|
@@ -76,8 +76,9 @@ npx mock-service-cli [options] [path]
|
|
|
76
76
|
| `-D` 或 `--web-dir` | 启用 Web 服务器，指定 web 目录（SPA 应用） | - |
|
|
77
77
|
| `-P` 或 `--web-port` | Web 服务器端口 | 9090 |
|
|
78
78
|
| `-b` 或 `--web-baseurl` | 指定 SPA Web 服务器的公共路径 | - |
|
|
79
|
-
| `-R` 或 `--static-server` |
|
|
80
|
-
| `--
|
|
79
|
+
| `-R` 或 `--static-server` | 启用单目录静态服务器，指定静态资源目录 | - |
|
|
80
|
+
| `--spa-fallback <path>` | 单目录模式显式启用 SPA 回退 | - |
|
|
81
|
+
| `--static-config <file>` | 使用自包含 JSON 配置启动静态服务器 | - |
|
|
81
82
|
| `-w` 或 `--open` | 自动打开 API 概览页、文件浏览器页 | false |
|
|
82
83
|
| `-e` 或 `--explorer` | 启用文件浏览器服务器，指定要浏览的目录 | ./ |
|
|
83
84
|
| `--edit` | 启用文件浏览器的新建、重命名、删除和上传操作 | false |
|
|
@@ -108,16 +109,21 @@ mock-service-cli -f ./mock.js
|
|
|
108
109
|
# 启动静态服务器
|
|
109
110
|
mock-service-cli -R ./public
|
|
110
111
|
|
|
111
|
-
#
|
|
112
|
-
mock-service-cli -R ./public --
|
|
112
|
+
# 单目录模式启用 SPA 回退
|
|
113
|
+
mock-service-cli -R ./public --spa-fallback /index.html
|
|
114
|
+
|
|
115
|
+
# 使用自包含配置（不需要目录参数）
|
|
116
|
+
mock-service-cli -R --static-config ./static-server.json
|
|
117
|
+
mock-service-cli --static-config ./static-server.json
|
|
113
118
|
```
|
|
114
119
|
|
|
115
120
|
静态服务器会监听资源变化并向 HTML 页面注入热更新客户端：CSS 文件更新时替换样式表，其余变更刷新页面。
|
|
116
121
|
默认不打开浏览器；在配置中设置 `"open": true` 或提供页面路径即可打开。完整配置字段和示例见
|
|
117
122
|
[`docs/static-server.config.example.json`](./docs/static-server.config.example.json)：支持忽略规则、SPA 回退、挂载目录、代理、HTTPS、CORS、响应头和自定义浏览器命令。
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
123
|
+
配置文件只在顶层保留服务器级字段。所有应用都放在 `mounts` 中，并可独立设置 `directory`、`spaFallback`、`proxy`、`cors`、`headers`、`requestHeaders` 和 `secure`。mount 未设置 `path` 时默认挂载到 `/`；`directory` 可省略，但该应用必须配置至少一条代理。代理键使用完整公开路径，例如 `/api/app`。
|
|
124
|
+
`headers` 是发送给客户端的响应头。`requestHeaders` 是发送给该应用全部代理上游的请求头；也可放在单个 `proxy` 规则中，覆盖或追加 mount 级请求头。代理规则使用 `{ "target": "http://...", "rewrite": true }`；`rewrite` 为 true 时只移除匹配的完整代理前缀并保留剩余路径和 query string。应用级 `secure` 控制其代理 HTTPS 目标的证书校验，默认 `false`。配置模式不接受 `--proxy-options`、`--rewrite` 或 `--spa-fallback`。
|
|
125
|
+
未设置 `spaFallback` 时，应用目录会显示可点击的目录索引；可直接访问其中的 HTML 文件。mount 未命中的路由不会继续进入其他应用的 SPA fallback。
|
|
126
|
+
设置了 `spaFallback` 的应用可选配置 `accessLog.success` 与 `accessLog.failure` 文件路径。服务将把每次访问以 JSON Lines 写入对应文件：2xx/3xx 写入 success，4xx/5xx 写入 failure；路径相对配置文件解析。启动后控制台会突出显示每条代理所属的应用、公开前缀、目标和 rewrite 状态。
|
|
121
127
|
|
|
122
128
|
### Web 服务器 (SPA)
|
|
123
129
|
|