mirror of
https://github.com/zhw2590582/ArtPlayer.git
synced 2026-10-13 07:46:17 -08:00
test(danmuku): [PKG-DANMUKU-02] establish failure browser and load baselines
This commit is contained in:
Harvey Zhao committed
1 parent
ccf3d6ed14
commit
d3c91af92c
14 files changed
+8508
-15
No files matched your search
@@ -0,0 +1,77 @@
|
||||
# PKG-DANMUKU-02 浏览器与负载基线
|
||||
|
||||
本记录整合先前的[受控失败子项](2026-09-13-PKG-DANMUKU-02-controlled-failures.md)：
|
||||
42项旧失败观察及父代理复跑通过，新增真实浏览器的行为、布局和负载记录。
|
||||
这里完成的是重构前基线，生产代码、类型及dist均未修改；没有把已复现缺陷当作
|
||||
候选必须保持的行为，也不代表弹幕能力或整包已经达到发布条件。
|
||||
|
||||
## 实际浏览器范围
|
||||
|
||||
使用真实npm Danmuku 5.3.0 main/legacy归档字节，每次核验SHA；真实已发布核心
|
||||
5.4.0及当前候选5.4.1。Chromium 153.0.8010.12、Firefox 155.0、Windows WebKit26.6，
|
||||
后者不是Safari真机。页面运行本地八秒视频、原生Blob Worker、实际DOM/设置操作。
|
||||
Worker子类只记录创建/消息/终止，不替换回复、算法、RAF或媒体时钟。外网被拒绝，
|
||||
同源Blob可用。共2核心×2插件格式×4场景×3引擎，48项通过、无跳过或未处理页面错误。
|
||||
|
||||
- 三种弹幕模式、同步filter与异步beforeVisible，真实居中/边界布局与Worker工作。
|
||||
- 六条同时固定弹幕的顺序、严格非重叠几何与暂停状态。
|
||||
- 原生play/pause/seek、两倍播放及四秒CSS运动时长，reset节点复用和load替换/追加。
|
||||
- 实际设置面板、异步发送去重和锁定、外挂输入框在网页全屏时移入并回位，双实例
|
||||
销毁隔离；旧版外部设置DOM残留如实记录为后续清理问题。
|
||||
|
||||
截图、原始几何、事件/Worker记录和运行输入在
|
||||
[机器报告](../baselines/danmuku-browser-validation.json)引用的不可变归档中。
|
||||
|
||||
## 初轮失败及处置
|
||||
|
||||
首轮Chromium为7通过、9失败，原spec、报告、截图和trace完整保留。
|
||||
八项来自两个错误测试假设：网页全屏会把播放器移到body，原容器选择器失效；
|
||||
旧版可能复用一个节点后又生成额外节点，不能要求最终可见节点必须是原节点。
|
||||
测试改为验证实际控件引用归属，以及原节点确实被再次使用，同时记录额外/隐藏节点。
|
||||
没有修改生产行为来满足测试。
|
||||
|
||||
另一次是**实际轨道重叠**：dense0和dense1的y都为10，宽70、高22.5，并观察到
|
||||
两次start及重复Worker消息id。截图也显示两条文字重叠。DANMUKU-TRACK-01保持开放，
|
||||
与已受控复现的双RAF/请求覆盖问题一同由04/05/07修复验收。严格非重叠断言仍保留；
|
||||
后次48通过只能说明那一轮没有触发，不能说明竞态已修复，后续运行仍可能再次报红。
|
||||
|
||||
负载首轮六项也保留：读取不存在的art.paused导致等待失败。改为原生
|
||||
art.template.$video.paused后重跑通过；这属于测试错误，不记录成生产缺陷。
|
||||
|
||||
## 300条弹幕负载观察
|
||||
|
||||
两种实际插件格式、已发布核心、三个引擎，共六个配置；各载入300个独立ID混合模式
|
||||
弹幕，确认完整队列、真实播放到至少四秒、可见输出、Worker工作和销毁。保存原始
|
||||
帧时间戳/间隔、实际DOM池与几何、可见ID及各阶段performance.memory。独立RAF
|
||||
观察者不更改插件时钟，但其自身也有测量开销。
|
||||
|
||||
初次三worker运行全部通过。WebKit帧间隔较长，因此再以单worker串行复测六个配置，
|
||||
减少并行测试争用；两份报告均保留，不能混为相同条件或增加六种功能覆盖。
|
||||
初次并行样本的可见唯一ID为51–129，DOM节点53–131；300载入成功不代表300条都
|
||||
在短窗口显示。真实排队/轨道与显示窗口仍受当前调度器影响。
|
||||
|
||||
串行六项也通过。该主机上的帧间隔中位数：Chromium两格式约16.7ms，Firefox约
|
||||
16.66ms，Windows WebKit为78/80ms；WebKit的p95为101/104ms。其样本可见51个ID、
|
||||
DOM53个节点；记录保留这个差异，不因测试通过就称流畅，也不外推为Safari设备结论。
|
||||
实际暂停时间约4.61–5.06秒，原始时间戳保留，后续比较须使用相同输入/观察方式。
|
||||
|
||||
Chromium提供堆读数，Firefox/WebKit为空；没有强制GC、跨引擎堆值比较、短样本
|
||||
泄漏结论或凭空设置性能阈值。串行结果是后续同条件对照，07仍需更长负载、重复
|
||||
装卸和资源稳定性验收。真实设备/CSP、Bilibili网络、Mask模型和最终新旧组合仍归后续。
|
||||
|
||||
## 重放、提交与下一步
|
||||
|
||||
```sh
|
||||
yarn test:danmuku
|
||||
yarn exec playwright test test/browser/danmuku-baseline.spec.js --workers=3
|
||||
yarn exec playwright test test/browser/danmuku-load-baseline.spec.js --workers=1
|
||||
```
|
||||
|
||||
固定Node24.21.0/Yarn1.22.22。受控测试接入test:unit，契约由test:baseline收集，
|
||||
浏览器文件由既有Playwright发现。没有安装依赖、修改锁文件或使用全局吞错处理。
|
||||
lint及任务/风险/契约索引校验随本次提交；本任务独立commit，无推送、标签或npm发布。
|
||||
|
||||
03接着整理加载、解析与config，保留数组同步初始化顺序、内部链式返回身份、
|
||||
追加/替换区别、逐条await emit以及live option回调接收者；优先修复网络拒绝悬挂、
|
||||
空XML、解析Worker/Blob释放、过期替换、time0和函数配置更新。轨道Worker/RAF、
|
||||
设置/heatmap和完整TS公开类型分别由04/05/06接续。
|
||||
@@ -0,0 +1,88 @@
|
||||
# PKG-DANMUKU-02 受控失败基线子项
|
||||
|
||||
本记录只交付 02 的受控测试部分，**不代表 PKG-DANMUKU-02 整体完成**。
|
||||
真实浏览器的时钟、轨道、密集/稀疏负载和可视结果由主任务另行验收。
|
||||
没有修改生产源码、声明、构建产物、共享元数据或 root scripts；没有启动服务或浏览器。
|
||||
|
||||
## 冻结输入与测试方法
|
||||
|
||||
复用 [01 发布基线](../baselines/danmuku-release.json) 与
|
||||
[不可变校验器](../scripts/danmuku-contract.mjs)，执行三个实际实现：
|
||||
|
||||
- Git `b0cfbfe3a09a84a295a257e45e4577847588d1cb` 的冻结源码，只在内存打包。
|
||||
- 真正 npm artplayer-plugin-danmuku@5.3.0 main 字节。
|
||||
- 同一发布版的 legacy 字节。
|
||||
|
||||
[test/helpers/danmuku.js](../../test/helpers/danmuku.js) 提供受控 DOM、时钟、rAF、
|
||||
timer、fetch 和 Worker transport；配置验证使用实际发布核心 5.4.0 的 validator。
|
||||
[`danmukuHistorical()`](../../test/helpers/danmuku.js) 返回 `{name,code,coreCode}` 数组；
|
||||
`danmukuEnvironment(implementation, settings)` 控制请求、帧、回应和资源观察。
|
||||
其捕获的 Bilibili Blob 内容在独立 VM 中实际执行，XML 的空输入和正常解析不是手写替身。
|
||||
框架只模拟传输/布局，不把它说成原生 Worker 或真实 DOM/播放验证。
|
||||
|
||||
[test/danmuku-failures.test.js](../../test/danmuku-failures.test.js) 每个实现有 14 个场景，
|
||||
共 42 项历史观察全部通过。测试中的“失败”指真实历史缺陷；这些断言不能用于要求候选
|
||||
保留缺陷。候选修复必须在后续任务中另加正确行为断言。
|
||||
|
||||
## 已复现观察
|
||||
|
||||
| 测试场景 | 精确结果 | 后续责任 |
|
||||
| --- | --- | --- |
|
||||
| DMK-FAIL-01 fetch rejection | fetch 原拒绝成为未处理拒绝；公开 load 不 settle，未发 :error | 03 |
|
||||
| DMK-FAIL-02 text rejection | response.text 原拒绝同样脱离公开 load/error 路径 | 03 |
|
||||
| DMK-FAIL-03 beforeVisible rejection | 异步 rAF 回调 Promise 被忽略，原错成为未处理拒绝；无 :error | 04 |
|
||||
| DMK-FAIL-04 narrow heatmap | offsetWidth=99 的默认 sampling=0 耗尽 VM 时间预算；显式 sampling=1 正常完成 | 05 |
|
||||
| DMK-FAIL-05 parser worker error | 未装错误处理；错误投递后 load 不 settle，destroy 也未终止这个 parser worker | 03/05 |
|
||||
| DMK-FAIL-06 empty XML | 实际 Blob parser 忽略空 XML 而不回消息；load 一直等待，parser worker 活着 | 03 |
|
||||
| DMK-FAIL-07 Blob URL | 真实 parser 成功后 worker terminate，但对应 URL 没有 revoke | 03/05 |
|
||||
| DMK-FAIL-08 late parser | destroy 时 parser worker 未终止；之后实际 parser 完成仍向 queue 添加并发 :loaded | 03/05 |
|
||||
| DMK-FAIL-09 out-of-order load | 两次无参数替换 load，第二次先完成，第一次晚完成将新队列覆盖为旧数据 | 03 |
|
||||
| DMK-FAIL-10 late function input | destroy 后异步输入继续入队并触发 :loaded | 03 |
|
||||
| DMK-FAIL-11 late beforeVisible | destroy 后用户 Promise 成功继续创建弹幕 DOM，尝试向已 terminate worker postMessage | 04/05 |
|
||||
| DMK-FAIL-12 late continuation | worker 消息在 destroy 前送达，await continuation 在 destroy 后将 wait 改成 ready | 04/05 |
|
||||
| DMK-FAIL-13 competing loops | play + playing 建两条循环；不同 id 的第二请求覆盖 onmessage，第一请求永不 settle | 04 |
|
||||
| DMK-FAIL-14 remaining frame | 双 start 后 pause/destroy 只取消最后一帧，另一已排定帧仍存在 | 04 |
|
||||
|
||||
DMK-FAIL-12 不依赖浏览器在 terminate 后再派发 Worker 消息：测试先完成消息投递，
|
||||
同步 destroy，再让 Promise continuation 恢复；不会夸大原生 Worker 终止语义。
|
||||
DMK-FAIL-11 的证据是 DOM 分配与 postMessage 调用尝试，不宣称原生 worker 已终止后
|
||||
仍执行代码或真的显示弹幕。测试也确认 late worker 分支没有发新的 :visible。
|
||||
|
||||
03 需要明确异步取消如何 settle 公开 load Promise、如何保持原错误通知/返回关系；
|
||||
04/05 需要单一帧循环、每请求关联、generation/销毁防护和 parser/Blob/设置的资源所有权。
|
||||
这只是后续设计边界，不在本任务提前实现或改变接口。
|
||||
|
||||
## 进程隔离与可重复证据
|
||||
|
||||
三类未处理拒绝各实现分别运行独立 Node 子进程，共 9 次，固定
|
||||
`--unhandled-rejections=strict`。只用 `uncaughtExceptionMonitor` 记录原错误、origin、
|
||||
公开 Promise settled 标记和 :error 数量，不注册吞掉错误的 unhandledRejection 或
|
||||
uncaughtException 处理器。实际进程 exit 1，monitor 记录 origin=unhandledRejection；
|
||||
不是把未处理拒绝隐藏到通过结果中。
|
||||
|
||||
热力图另有 6 次独立进程：三个 sampling=0，三个 sampling=1 对照。内部 VM 100ms
|
||||
执行预算明确产生 `ERR_SCRIPT_EXECUTION_TIMEOUT`；对照完成且没有超时。外层进程
|
||||
还有 3000ms 最终保护，外层超时本身会使测试失败，不能被算作正常观察。
|
||||
整个重放不会把零步长循环交给真实浏览器页面。
|
||||
|
||||
每次测试写独立 `refactor/.cache/danmuku02-controlled/run-*/`，保留 15 个子进程
|
||||
stdout/stderr/status JSON。最终目录、文件 SHA、脚本 SHA、命令与汇总见
|
||||
[danmuku-failures-validation.json](../baselines/danmuku-failures-validation.json)。
|
||||
|
||||
```text
|
||||
node --test test/danmuku-failures.test.js
|
||||
node node_modules/eslint/bin/eslint.js test/helpers/danmuku.js test/danmuku-failures.test.js
|
||||
```
|
||||
|
||||
实际 Node 24.21.0 / Windows，42 passed / 0 failed / 0 skipped；专属 lint 通过。
|
||||
没有新依赖、没有修改 Yarn lock。缺少归档缓存时，01 verifier 只向冻结 npm URL 请求，
|
||||
测试本身不会请求 Bilibili、媒体或任何识别服务。
|
||||
|
||||
## 未完成范围与回退
|
||||
|
||||
尚未覆盖原生 Worker/CSP、真实媒体时钟和 seek/倍率、实际测量的防重叠/轨道顺序、
|
||||
长时间负载、内存、设置触摸/旋转、mask/fullscreen/PiP/外部挂载、浏览器错误表现。
|
||||
这些内容仍是 PKG-DANMUKU-02 及后续组合验收的门槛。本报告不标包重构完成或 npm 可发布。
|
||||
|
||||
此批只有历史测试与证据，可独立撤销，不影响发布包。整合代理将本子项与 02 的其他
|
||||
必要证据一起管理状态；不要仅依据这 42 个观察把整个任务标为 done。
|
||||
Reference in new issue
Block a user