Files
crawler-plugin/admin-frontend-vue/src/router/meta.ts
T
huangzd1997 b167bb6e2b task-9(壳层/路由): 实现路由 meta 菜单 key 约定与 RouteMeta 类型增强
新增 src/types/vue-router.d.ts 模块增强(RouteMeta.title/menuKey),meta.ts 提供
metaMenuKey/命名校验,router 守卫改类型化访问去掉 as cast,AdminLayout 标题同步
去 cast;校验首批注册表 menuKey 合规。
2026-09-05 14:43:53 +08:00

35 lines
1.2 KiB
TypeScript

/** 路由 meta 菜单 key 约定(任务 9):menuKey 对应后端菜单节点 key,仅作页面级鉴权。 */
export const ADMIN_MENU_KEY_PATTERN = /^[a-z][a-z0-9_]*$/
/** 从 route.meta 读取菜单 key;缺省/非法类型回退空串(无菜单约束)。 */
export function metaMenuKey(meta: { menuKey?: unknown } | undefined): string {
const value = meta?.menuKey
return typeof value === 'string' ? value : ''
}
/** 菜单 key 是否合规(小写下划线命名)。 */
export function isValidMenuKey(key: string): boolean {
return ADMIN_MENU_KEY_PATTERN.test(key)
}
export interface MenuKeyCandidate {
path?: string
menuKey?: unknown
}
/** 校验一批页面注册的 menuKey:重复与命名格式问题返回可操作清单。 */
export function validateRouteMenuKeys(records: MenuKeyCandidate[]): string[] {
const issues: string[] = []
const seen = new Set<string>()
for (const record of records) {
const key = metaMenuKey(record)
if (!key) continue
if (seen.has(key)) issues.push(`菜单 key 重复: ${key}`)
seen.add(key)
if (!isValidMenuKey(key)) {
issues.push(`菜单 key 命名非法(须小写下划线): ${record.path || '(无路径)'} -> ${key}`)
}
}
return issues
}