Files
persionalBrand/apps/taro/test/mask-taro.test.mjs
T
que01 9ad2776515 feat: 遮蔽产物中的 Taro 指纹
H5 预览与小程序产物会带出 taro_tmpl、taro-*-core、taro.js、--taro-button-height、
project.config.json 的 projectname 等指纹,而 Taro 4.3 没有隐藏这些名称的配置。
改为在 build:h5、build:weapp、build:preview 之后按 apps/taro/config/mask.config.json
做构建后处理:

- 同一张替换表同时作用于文件名与文本内容,重命名后引用保持同步,长度 ≥ 40 的 base64/哈希片段原样保留;
- 遮蔽后仍命中 forbidden 词表时构建失败,并把 project.config.json 的 projectname/description 中性化;
- dev:h5、dev:preview 保持原始命名,便于本地调试;改架构名只改 mask.config.json;
- 产物契约测试先用 unmask() 还原再断言,浏览器测试选择器写成 :is(<源码名>, <遮蔽名>)。

取舍与迁移见 docs/adr/0025-build-output-stack-masking.md。
2026-10-13 23:03:32 +08:00

84 lines
3.7 KiB
JavaScript

import { test } from "node:test";
import assert from "node:assert/strict";
import fs from "node:fs";
import os from "node:os";
import path from "node:path";
import { createRequire } from "node:module";
import { maskConfig, masked, unmask } from "./mask-names.mjs";
const require = createRequire(import.meta.url);
const { maskText, maskFileName, maskDirectory, findLeaks } = require("../config/mask-taro.cjs");
const replacements = maskConfig.replacements;
/** 长度超过 40 的 base64/哈希片段,遮蔽时必须原样保留。 */
const opaqueRun = `QWxhZGRpbjpvcGVuIHNlc2FtZQ${"taro"}VzYW1lQW5kUGFzc3dvcmQ`;
test("遮蔽表在测试与构建之间保持一致", () => {
for (const name of [
"taro-button-core",
"taro_tmpl",
"@tarojs/components",
"taroWindowProvider",
"--taro-button-height",
".taro-tabbar__tabbar",
])
assert.equal(masked(name), maskText(name, replacements), name);
assert.equal(masked("taro-button-core"), "appkit-button-core");
assert.equal(masked(".taro-tabbar__tabbar"), ".appkit-tabbar__tabbar");
assert.deepEqual(
Object.keys(replacements).map((from) => unmask(masked(from))),
Object.keys(replacements),
);
});
test("文本遮蔽改标识符但不损坏不透明数据段", () => {
const content = `var tmpl="taro_tmpl";var key="${opaqueRun}";const modifyTaroEvent=1;`;
const result = maskText(content, replacements);
assert.ok(result.includes('"appkit_tmpl"'));
assert.ok(result.includes(`"${opaqueRun}"`));
assert.ok(result.includes("modifyAppKitEvent"), "camelCase 标识符必须一起遮蔽");
assert.ok(!/taro/i.test(result.replace(opaqueRun, "")), "可替换区段不得残留指纹");
});
test("文件名遮蔽与内容使用同一张表", () => {
assert.equal(maskFileName("taro.js", replacements), "appkit.js");
assert.equal(maskFileName("taro-tmpl.wxml", replacements), "appkit-tmpl.wxml");
assert.equal(maskFileName("common.wxss", replacements), "common.wxss");
});
test("遮蔽产物目录:文件名、引用与 project.config.json 同步更新且无残留指纹", () => {
const directory = fs.mkdtempSync(path.join(os.tmpdir(), "mask-taro-"));
try {
fs.mkdirSync(path.join(directory, "assets"));
const binary = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x00, 0xff]);
fs.writeFileSync(path.join(directory, "assets/logo.png"), binary);
fs.writeFileSync(path.join(directory, "app.js"), 'require("./taro.js");\n');
fs.writeFileSync(path.join(directory, "taro.js"), 'var tmpl="taro_tmpl";\n');
fs.writeFileSync(path.join(directory, "taro-tmpl.wxml"), '<template name="taro_tmpl"/>\n');
fs.writeFileSync(
path.join(directory, "project.config.json"),
`${JSON.stringify({ appid: "wx-test", projectname: "personal-brand-taro" }, null, 2)}\n`,
);
const result = maskDirectory(directory, maskConfig);
assert.deepEqual(result.leaked, []);
assert.deepEqual(findLeaks(directory, maskConfig), []);
assert.ok(fs.existsSync(path.join(directory, "appkit.js")), "被引用的文件必须同步改名");
assert.ok(fs.existsSync(path.join(directory, "appkit-tmpl.wxml")));
assert.equal(
fs.readFileSync(path.join(directory, "app.js"), "utf8"),
'require("./appkit.js");\n',
);
assert.equal(fs.existsSync(path.join(directory, "taro.js")), false, "旧文件名不能残留");
const projectConfig = JSON.parse(
fs.readFileSync(path.join(directory, "project.config.json"), "utf8"),
);
assert.equal(projectConfig.projectname, maskConfig.project.projectname);
assert.equal(projectConfig.appid, "wx-test");
assert.deepEqual(fs.readFileSync(path.join(directory, "assets/logo.png")), binary);
} finally {
fs.rmSync(directory, { recursive: true, force: true });
}
});