75 lines
3.2 KiB
JavaScript
75 lines
3.2 KiB
JavaScript
|
// 契约：小程序 WXML 必须结构自洽（可被编译）
|
|||
|
|
//
|
|||
|
|
// 由来（2026-09-19）：微信开发者工具报
|
|||
|
|
// [ WXML 文件编译错误] ./pages/service-history/service-history.wxml
|
|||
|
|
// get tag end without start, near `</`
|
|||
|
|
// 而当时 UI 契约门禁 14/14 全绿 —— 说明既有门禁全是「源码结构/内容断言」，
|
|||
|
|
// **没有一条会真的去编译或解析 WXML**。两个页面（service-history、service-program）
|
|||
|
|
// 因此各带一个多余 `</view>` 进入仓库且长期无人发现。
|
|||
|
|
//
|
|||
|
|
// 本守卫补上这一层：按引号状态机解析标签配对，任何多余闭合/错配/未闭合直接判红。
|
|||
|
|
//
|
|||
|
|
// 自检（防止守卫自己变哑）：内置 3 组样例，正向 1 组 + 反向 2 组。
|
|||
|
|
// 正向样例**故意在属性值里放了 `>`**（`"{{a > 0}}"`）—— 早期用懒惰正则实现时，
|
|||
|
|
// 这里会被误判为结构错误（假阳性），把 messages.wxml 这种合法文件报成坏文件。
|
|||
|
|
// 把该样例固化进守卫，等于把「假阳性」这个坑钉在门禁里。
|
|||
|
|
|
|||
|
|
import assert from 'node:assert/strict'
|
|||
|
|
import { readFileSync } from 'node:fs'
|
|||
|
|
import { relative, resolve } from 'node:path'
|
|||
|
|
import { checkWxml, walkWxml } from '../scripts/lib/wxml-structure.mjs'
|
|||
|
|
|
|||
|
|
const root = resolve(import.meta.dirname, '..')
|
|||
|
|
|
|||
|
|
// ── 1. 扫描器自检 ────────────────────────────────────────────────
|
|||
|
|
const selfCheckCases = [
|
|||
|
|
{
|
|||
|
|
name: '正向：属性值内含 `>` 比较运算符（早期正则实现的假阳性来源）',
|
|||
|
|
src: '<view class="a"><ui-section-header title="x" subtitle="{{unreadTotal > 0 ? 1 : 0}}" /><text>{{n >= 3}}</text></view>',
|
|||
|
|
expectErrors: 0,
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
name: '反向：多余的闭合标签',
|
|||
|
|
src: '<view class="a"><text>x</text></view></view>',
|
|||
|
|
expectErrors: 1,
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
name: '反向：标签未闭合',
|
|||
|
|
src: '<view class="a"><text>x</text>',
|
|||
|
|
expectErrors: 1,
|
|||
|
|
},
|
|||
|
|
]
|
|||
|
|
|
|||
|
|
for (const c of selfCheckCases) {
|
|||
|
|
const errors = checkWxml(c.src)
|
|||
|
|
assert.equal(
|
|||
|
|
errors.length,
|
|||
|
|
c.expectErrors,
|
|||
|
|
`扫描器自检失败 —— ${c.name}\n期望 ${c.expectErrors} 条错误，实得 ${errors.length} 条：\n${errors.join('\n')}`,
|
|||
|
|
)
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ── 2. 全量扫描小程序页面 ────────────────────────────────────────
|
|||
|
|
// WXML_SCAN_ROOT 仅用于「负向注入自证」：把扫错文件的门禁指向一个临时目录，
|
|||
|
|
// 确认它真的会变红。默认扫仓库内 miniapp/。
|
|||
|
|
const scanRoot = resolve(root, process.env.WXML_SCAN_ROOT ?? 'miniapp')
|
|||
|
|
const files = walkWxml(scanRoot)
|
|||
|
|
|
|||
|
|
assert.ok(files.length > 0, `未在 ${scanRoot} 下找到任何 .wxml —— 扫描清单可能失配，拒绝报绿`)
|
|||
|
|
|
|||
|
|
const broken = []
|
|||
|
|
for (const file of files) {
|
|||
|
|
const errors = checkWxml(readFileSync(file, 'utf8'))
|
|||
|
|
if (errors.length) {
|
|||
|
|
broken.push(`${relative(root, file).replace(/\\/g, '/')}\n ${errors.join('\n ')}`)
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
assert.deepEqual(
|
|||
|
|
broken,
|
|||
|
|
[],
|
|||
|
|
`以下 WXML 结构不自洽，微信开发者工具会编译失败：\n${broken.join('\n')}`,
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
console.log(`WXML structure contracts passed（${files.length} 个文件）`)
|