docs(tests): explain legacy canvas and workspace unit coverage
This commit is contained in:
@@ -1,3 +1,7 @@
|
||||
/**
|
||||
* 本地图标目录/分片和共享 ResourceLoader 测试。直接读仓库生成资产,校验本地哈希和引用,不访问图标 CDN。
|
||||
* loader 的活跃并发与缓存容量受限,不能据此推断待处理队列本身有长度上限。
|
||||
*/
|
||||
import { test } from "node:test";
|
||||
import assert from "node:assert/strict";
|
||||
import { readFile } from "node:fs/promises";
|
||||
@@ -8,10 +12,12 @@ import { iconAsset, validateIconShard } from "../src/lib/canvas-icon-loader.ts";
|
||||
import { decodeCanvas, emptyCanvas, makeCanvasNode } from "../src/lib/canvas.ts";
|
||||
import { createResourceLoader } from "../src/lib/resource-loader.ts";
|
||||
|
||||
// 核对目录数量、ID 唯一性、分片文件哈希/体积/合法 SVG 数据、每个图标和分类存在;选取三个 ID 再验证旧快照往返。
|
||||
test("all Lucide and experimental Tabler IDs map to valid local shards and survive snapshots", async () => {
|
||||
assert.equal(catalog.filter((icon) => icon.source === "lucide").length, 2313);
|
||||
assert.equal(catalog.filter((icon) => icon.source === "tabler").length, 24);
|
||||
assert.equal(new Set(catalog.map((icon) => icon.name)).size, catalog.length);
|
||||
// 按 manifest 逐分片读取本地 JSON;文件名哈希取 trimEnd 后文本的 SHA-256 前 12 位,单片小于 20000 字节。
|
||||
const loaded = new Map();
|
||||
for (const asset of Object.values(manifest.assets)) {
|
||||
const content = await readFile(`public${manifest.root}/${asset}`, "utf8");
|
||||
@@ -30,13 +36,16 @@ test("all Lucide and experimental Tabler IDs map to valid local shards and survi
|
||||
}
|
||||
});
|
||||
|
||||
// 对 script、onload、外部 paint URL 和 use/href 的样例逐个拒绝;这是数据校验例,不是完整浏览器 SVG 安全审计。
|
||||
test("icon data rejects executable shapes, events and external paint references", () => {
|
||||
for (const node of [["script", {}], ["path", { onload: "alert(1)" }], ["path", { fill: "url(https://example.com)" }], ["use", { href: "bad" }]]) {
|
||||
assert.throws(() => validateIconShard({ Star: [node] }));
|
||||
}
|
||||
});
|
||||
|
||||
// 让 setImmediate 推进到调度任务阶段;用于观察尚未开始、排队及已释放容量的加载。
|
||||
const tick = () => new Promise((resolve) => setImmediate(resolve));
|
||||
// request 后立即 abort,尚未进入调度时不能启动网络加载,也不能把未完成值留入缓存。
|
||||
test("an immediately unmounted icon does not start a network request", async () => {
|
||||
let calls = 0;
|
||||
const loader = createResourceLoader(async () => { calls++; return "unused"; });
|
||||
@@ -47,8 +56,10 @@ test("an immediately unmounted icon does not start a network request", async ()
|
||||
assert.equal(calls, 0); assert.equal(loader.peek("unused"), undefined);
|
||||
});
|
||||
|
||||
// 同 key a 两个订阅只加载一次,容量二时 c 等待;完成后缓存命中不新增调用,峰值为二。
|
||||
test("loader bounds concurrency, deduplicates shared shards and reuses cache", async () => {
|
||||
let active = 0, peak = 0, calls = 0;
|
||||
// 手动完成 active 加载,用于在容量为二时观察第三项等待及共享 key 去重。
|
||||
const finish = [];
|
||||
const loader = createResourceLoader(async (key) => {
|
||||
active++; peak = Math.max(peak, active); calls++;
|
||||
@@ -62,6 +73,7 @@ test("loader bounds concurrency, deduplicates shared shards and reuses cache", a
|
||||
assert.equal(await loader.request("a"), "a"); assert.equal(calls, 3); assert.equal(peak, 2);
|
||||
});
|
||||
|
||||
// 取消排队 b 后它永不启动;取消 a 的一个订阅不能中止另一个订阅共享的 active a。
|
||||
test("unused queued loads never start; a remaining subscriber keeps a shared load alive", async () => {
|
||||
const seen = []; let release;
|
||||
const loader = createResourceLoader(async (key) => { seen.push(key); if (key === "a") await new Promise((resolve) => release = resolve); return key; }, 1);
|
||||
@@ -73,6 +85,7 @@ test("unused queued loads never start; a remaining subscriber keeps a shared loa
|
||||
await rejected; assert.equal(await shared, "a"); await tick(); assert.deepEqual(seen, ["a"]);
|
||||
});
|
||||
|
||||
// active abort 后释放容量,失败 key 可重新加载;容量二的 LRU 在加入 a/b 后淘汰更早 fail,保留仍在缓存的 a。
|
||||
test("active aborts and failed requests can retry; least recently used cache is bounded", async () => {
|
||||
let fail = true;
|
||||
const loader = createResourceLoader(async (key, signal) => {
|
||||
|
||||
Reference in New Issue
Block a user