5.2 KiB
Canvas代理测试维护
先读 实际契约 和canvas-release.json。来源包含两个真实 发布、当前Git冻结工作区，以及1.0.0关联核心Git源码，后者不等于同版本npm内容。
node --test refactor/scripts/canvas-contract.test.mjs运行13项：归档/导出/声明、Git与
实际npm核心能力区别、三实现属性转发和事件、正常bitmap与无bitmap绘制/resize。
测试已接入test:baseline；test/helpers/canvas.js控制元素属性、microtask、RAF、延迟
订阅和事件对象，后续02复用以构造乱序/销毁。假Canvas不证明真实像素、codec或设备。
13项正常契约通过以后，02必须分别复现过期bitmap完成、回调错误/close资源、重复 play/pause、destroy前后订阅、缺context和尺寸异常；保留历史失败与候选通过两套测试。 03拆媒体adapter/绘制调度/订阅和所有权，04明确公共类型（尤其可选参数及canvas自有 方法优先），05/06核验新旧核心、实际媒体/浏览器/设备/安装包和8082 demo。
Ambilight代理颜色测试在03同步改用实际候选入口bundle，不能用旧dist掩盖改名或遗漏模块。 Canvas正式历史浏览器矩阵在02建立；01没有使用新浏览器结果作包整体验收。
01最终13项Canvas专项、7项契约索引检查与991项完整CI通过；证据见 发布契约验证 和 实施记录。三个新增风险继续open， 01时生命周期仅source-observed，02复现以后推进03源码修复。
02 历史失败与真实浏览器
yarn test:canvas运行33项历史Node检查，已接入test:unit。运行
yarn test:browser test/browser/canvas.spec.js核验42项：三实现×两种实际支持proxy
的核心×三引擎×两场景=36，加三个引擎分别挂载/未挂载原生video的6项独立对照。
就绪事件顺序、暂停/seek/resize/切源及回调内destroy后继续RAF均有断言。历史npm
5.1.7不支持proxy，不假装把它计入此矩阵。
WebKit历史代理输出透明是明确的失败基线；测试成功表示重现了该失败。原生video 播放前挂载可读到像素，未挂载对照为透明；播放后才挂载旧代理的video未恢复。 没有替换像素、bitmap或媒体来绕过它，03需以候选真实像素关闭CANVAS-PIXEL-01。 既有Ambilight组合测试由回调填充九格调色板，只证明输出buffer几何，不证明代理 已从视频画出有效帧。Windows Playwright WebKit证据不能直接等同真实Safari设备。
失败尝试与最终报告均保留report.json和完整results，哈希与范围见 02验证证据；问题处理细节见 02实施记录。本任务不修改生产源码。
03 严格TS和候选生命周期
源码拆为六个TS模块；职责、数据流和错误边界见
包内架构。yarn test:canvas现在
同时运行历史和候选测试，候选可通过ARTPLAYER_CANVAS_BASELINE=1切换冻结源码以
证明失败来源，不能把这个变量留在正常测试环境中。
候选浏览器文件canvas-lifecycle.spec.js覆盖实际5.4.0/候选核心×三个引擎×三场景 共18项：实际原始尺寸和多点像素、resize/切源、暂停seek补绘、回调销毁以及逃逸方法 不重启资源。组合运行Ambilight的9项代理/旧核心能力对照及18项原生生命周期检查。 所有加载均来自候选源码bundle；历史42项继续从归档/Git加载。
WebKit须验证intrinsic尺寸，不能仅alpha255；1px挂载曾令videoWidth/videoHeight 也变为1。Chromium临时无首帧不宜当稳定错误，WebKit零帧计数却不能作全局绘制门槛。 失败诊断与针对性回归见03记录和 03证据。04公开类型/导出和05设备、06 完整分发/demo仍需完成；本步的strict内部类型不替代安装消费者验收。
04 公开类型和分发入口
node --test refactor/scripts/canvas-types.test.mjs运行四组基线：两代真实声明、五种
编译器模式、11项非法用法、生成编辑器全局及三格式导出身份。Parameters保持可选
callback，Result精确保持HTMLCanvasElement；MediaCanvas只作显式类型视图，不能
用于收窄旧返回值或假设所有浏览器具备全部媒体API。不要复制Ambilight的必填末重载。
yarn test:canvas-types-package在仓库外安装两份实际发布及候选，校验文件字节和
非workspace链接，离线安装与frozen reinstall均须通过。17个编译场景里，候选7个
及历史9个应零诊断；另1个npm1.1.0 NodeNext ESM保留2349/2349/2322/2344/2344
五个旧诊断。候选每种模式移除@ts-expect-error后须拒绝11项非法用法。
公开namespace是编辑器声明源，不手改docs/assets/ts生成文件。.default与工厂 自身同一引用；根ESM/CJS及legacy类型入口各自测试。完整路径/内容/demo仍留06， 真实Safari/移动设备仍留05。见04实施记录 和04证据。