dsh-sansheng-liubu/workbench/test/panel-contract.test.mjs

69 行
2.7 KiB
JavaScript

// 前端与 Host 的接线契约:路径前缀、端点名、方法。
//
// 这一条是为"重启后才暴露"的那类错误准备的:如果 panel 里写的是 /sansheng/workbench、
// 而 Host 改了 ROUTE_PREFIX,真实宿主里所有请求都会 404,界面看起来就是"一直在读、什么都不出来"。
// 单测跑得比重启快,所以把这条约束钉在测试里。
import test from 'node:test'
import assert from 'node:assert/strict'
import { readFileSync } from 'node:fs'
import { fileURLToPath } from 'node:url'
import { dirname, join } from 'node:path'
import { ROUTE_PREFIX, listWorkbenchRoutes } from '../host/routes.mjs'
const here = dirname(fileURLToPath(import.meta.url))
const clientFile = join(here, '..', 'panel', 'lib', 'client.js')
function readClient() {
return readFileSync(clientFile, 'utf8')
}
/** 从 apiGet("x") / apiPost("x") 里取出前端真正会请求的端点名。 */
function clientEndpoints(source) {
const names = new Set()
const pattern = /api(?:Get|Post)\(\s*"([^"]+)"/g
let match = pattern.exec(source)
while (match !== null) {
names.add(match[1])
match = pattern.exec(source)
}
return [...names].sort()
}
test('panel 的 API_BASE 与 Host 的 ROUTE_PREFIX 完全一致', () => {
const source = readClient()
const match = /const\s+API_BASE\s*=\s*"([^"]+)"/.exec(source)
assert.ok(match, 'panel 里找不到 API_BASE 声明')
assert.equal(match[1], ROUTE_PREFIX, '两边前缀不一致,真实宿主里会全体 404')
})
test('panel 请求的每个端点,Host 都真的注册了', () => {
const routes = listWorkbenchRoutes()
const known = new Set(routes.map((route) => route.path.slice(ROUTE_PREFIX.length + 1)))
const requested = clientEndpoints(readClient())
assert.ok(requested.length >= 5, `只解析到 ${requested.length} 个端点,说明提取规则失效了`)
const missing = requested.filter((name) => !known.has(name))
assert.deepEqual(missing, [], `panel 请求了 Host 没有的端点:${missing.join(', ')}`)
})
test('前端会改状态的端点都是 POST,读取类都是 GET', () => {
const source = readClient()
const byMethod = new Map(listWorkbenchRoutes().map((route) => [route.path.slice(ROUTE_PREFIX.length + 1), route.method]))
const postPattern = /apiPost\(\s*"([^"]+)"/g
let match = postPattern.exec(source)
while (match !== null) {
assert.equal(byMethod.get(match[1]), 'POST', `apiPost 打了 ${match[1]},但 Host 上它不是 POST`)
match = postPattern.exec(source)
}
const getPattern = /apiGet\(\s*"([^"]+)"/g
match = getPattern.exec(source)
while (match !== null) {
assert.equal(byMethod.get(match[1]), 'GET', `apiGet 打了 ${match[1]},但 Host 上它不是 GET`)
match = getPattern.exec(source)
}
})