admin
c5a503580c
承 Tier1（S2+S3，已於 main 168e9e7）。本批為效能第二層＋第三層，全程獨立複驗（差分/往返/ 增量≡全量/進程隔離測速/真瀏覽器）＋4 份真人撰寫真實文檔驗收，行為保真、提速真實。 掃描層（無狀態、保行為）： - 中間發現＋S4：insidePill／isAvoided 之「逐文本節點沿祖先鏈」以 ancestorOrSelfPill／…Avoided 迭代回填記憶化（每元素恰算一次、兄弟共用祖先鏈快取），O(文本×depth)→O(元素)。實測掃描層 el.matches() 累計約降五成；深嵌套 render 進程隔離墻鐘 pre-Tier1 707ms→254ms（2.8×）。 佈局層（僅瀏覽器、正確性敏感）： - S1 gapTrim 對齊門：尾隨 margin 僅在右緣 flush 之對齊可見，唯 left／start(ltr) 之 ragged 右緣 可整批跳過，省其 O(gaps) 次同步重排。實測非兩端對齊內容 gapTrim 數千 ms→數十 ms；justify／ center／right／RTL 保留完整逐一定案、行為不變（真瀏覽器差分：justify trim 集指紋逐位相同）。 增量恢復（第三層，向下兼容 API）： - C1 持久化 Finder：跨 render 復用元素鍵快取（category／level／feature／祖先游走）。正確性靠 失效：新增 finder.invalidate(el) 清整棵子樹快取（祖先屬性變則後代快取變脏），revert 自動失效 其子樹（安全預設）。 - C3 rerender(root)＝revert+render；局部恢復（實測編輯 400 段中一段 766×、matches 1441×）。 - C2 observe/disconnect：MutationObserver 自動增量——內容/分類屬性變化重處理最近塊、新增之塊 直接 render；render/revert 期間暫停觀察，自身注入絕不自觸發。 - append 修復（IV-3 差分複驗發現、單測漏掉）：向葉塊（帶 jz-orphan）追加子塊使其轉非葉，須撤 容器陳舊 orphan——追加塊時若塊級父有 jz-orphan 直接子則改重處理該父。 測試 130→140（+S2 非葉塊、C1/C3、C2 觀察/失效/append、不自觸發）。基準設施：bench-incremental （增量恢復）、bench-layout（版面層，headless Chrome）。dist 重建。
28 lines
1.0 KiB
JavaScript
28 lines
1.0 KiB
JavaScript
// jsdom 測試輔助：建立 DOM 並把必要全域掛上，再回傳 document。
|
||
// 注入結構正確性可於 jsdom 驗證；版面（justify/擠壓量/行端）須瀏覽器目視。
|
||
|
||
import { JSDOM } from "jsdom";
|
||
|
||
/**
|
||
* 建立一個帶 body 內容之 jsdom，並把 document / NodeFilter / Node 掛到
|
||
* globalThis（dom.ts 之 createJz 用全域 document）。回傳 { dom, document }。
|
||
*/
|
||
export function setupDom(bodyHtml = "")
|
||
{
|
||
const dom = new JSDOM(
|
||
"<!doctype html><html><head></head><body>" + bodyHtml + "</body></html>",
|
||
);
|
||
globalThis.document = dom.window.document;
|
||
globalThis.NodeFilter = dom.window.NodeFilter;
|
||
globalThis.Node = dom.window.Node;
|
||
globalThis.window = dom.window;
|
||
globalThis.MutationObserver = dom.window.MutationObserver; // C2 觀察（jsdom 支持）
|
||
return { dom, document: dom.window.document };
|
||
}
|
||
|
||
/** 計算 root 下某 tag（大寫）之元素數。 */
|
||
export function countTag(root, tag)
|
||
{
|
||
return root.querySelectorAll(tag).length;
|
||
}
|