x15904151985/ArtPlayer
1
0 Fork 0
mirror of https://github.com/zhw2590582/ArtPlayer.git synced 2026-10-08 19:06:15 -08:00
Code Issues Packages Projects Releases Wiki Activity
Files
ddf3d6ccbc2fa7a3fa1a25c2b935b9d7045cee5c
ArtPlayer/refactor/vast-validation.md
T

9.5 KiB
Raw Blame History

VAST 测试维护

PKG-VAST-03已落实用户确认的两种初始化模式；04按独立类型确认提供准确/runtime。 来源见 实际契约、VAST/SDK归档 和 核心5.1.7归档。工作区1.2.0不是npm发布版本。

早期03检查点：新增test/vast-lifecycle.test.js的15项候选修复断言，冻结工作区全部失败、 当前5个TS模块全部通过；现有测试共60项Node、117项浏览器通过。覆盖终止/回调失败、 初始化回滚、活动广告重建、旧事件、配置getter和SDK同步重入；完整CI900项通过。 该文件已纳入yarn test:vast和test:unit。实际资源所有权见 包内架构； 初始化冲突当时尚未决定。以下缺陷清单保留历史 来源，不代表候选实现仍包含这些已获可控修复证据的问题；真实IMA验收仍待05。

文件与执行

PKG-VAST-04新增yarn test:vast-types和yarn test:vast-types-package。根声明与 实际npm1.0.0原文一致，/runtime与同一JS产物绑定；TS5.9.3/4.3.5、CommonJS、 NodeNext、Bundler、关闭interop共14组实际安装消费通过。安装后强制frozen重装、 成员哈希与解析路径隔离均检查；14条runtime反例逐行断言错误，不能只统计数量。 主项目yarn typecheck也接入根/准确消费样例，baseline测试自动发现vast-types。

编辑器CommonJS生成器补齐旧VAST的内联工厂与局部type；当前global回归npm旧类型， 冻结工作区的SDK生成路径仍独立测试。三真实浏览器的Monaco消费生成声明、拒绝 错误输入，并运行主片解码样例均通过；不执行广告SDK。正式VAST运行回归82通过， 类型/编辑器/工程20通过。见04记录。

PKG-VAST-07补回工厂.default自身别名，不改变初始化决策。当时yarn test:vast 65项通过；实际main/legacy加ESM各4项导出通过。117项三浏览器检查通过，其中候选 异步注册场景使用.default，其他场景保留直接调用。浏览器仍替换SDK边界，实际 打包SDK只做无广告的导出/已销毁宿主验证。详见 变更。

2026-09-14用户确认默认保留npm语义、显式选择workspace惰性模式。当前Node82项 通过，三浏览器×三核心×四插件实现/模式162项通过（99候选，63历史）。主片解码 是真实浏览器行为，SDK仍受控。首次新增7项Node中5项在原候选失败，修复后新增 10项全过；首轮浏览器153过9失败来自默认模式仍被旧断言当作工作区显隐，原报告 保留。修正为各自历史前缀、监听数和显隐责任，并补充回调开始时资源/数据字段 检查；未删除清理/重建断言。最终源码格式整理后重跑，完整证据见 03完成记录。 版本以实际附件为准：npm核心5.1.7/5.4.0、候选5.4.1；早期文档把published路径 写为5.4.1不准确，本轮报告已按来源及实际coreVersion纠正。

  • test/vast-exports.test.js：源码构建或环境变量指定的实际main/legacy/ESM导出。 保持现有callable，不宣称复刻旧namespace对象的反射形状；新文件纳入test:vast/test:unit。
  • test/helpers/vast-sdk.js：可在Node和浏览器使用的SDK记录器，控制加载、构造、 监听、请求、销毁失败和晚到事件；不实现IMA、广告请求或主片暂停恢复。
  • test/helpers/vast.js：只在精确的@glomex/vast-ima-player导入边界替换SDK。 当前JS/TS入口可打包加载；两套历史源码必须来自哈希验证的npm归档/Git内容。 source与source-workspace是相同编译代码，后者显式传第二参数；published字段 表示行为模式，historical才表示历史代码。浏览器附件记录实际选项，避免混计。 Node宿主仅提供事件和DOM所有权意图，不模拟布局或视频解码。
  • test/vast.test.js：共享契约、工作区新增功能、独立的历史缺陷观察。 修复时为当前候选增加正确行为断言，保留历史缺陷复现，不能把旧缺陷移入共享契约。
  • test/vast-compatibility.test.js：对照实际npm源码，验证提前初始化、原数据属性、 SDK默认设置、重复请求、回调拒绝/取消、构造重入、销毁重建及显式模式选择。 与原生命周期文件一起纳入test:vast/test:unit；后者保留工作区专属getter/四事件 故障断言，默认模式由兼容文件和共享/浏览器矩阵覆盖。
  • test/browser/vast.spec.js：三真实浏览器×三核心，测试异步注册、加载失败、真实 DOM显隐、显式清理重建、主片解码/切源和销毁后晚到初始化。SDK仍是同一受控记录器。
  • refactor/scripts/vast-core.test.mjs：实际5.1.7 tarball、197成员和发布关联检查。
  • refactor/scripts/vast-contract*.mjs：VAST及SDK归档、真实发布导出和冻结源码契约。

使用仓库固定Node24.21.0与Yarn1.22.22：yarn test:vast、yarn test:baseline、 yarn test:browser vast.spec.js。Node用例纳入test:unit，浏览器用例由常规Playwright 流程发现。8084浏览器运行串行执行；每次报告/完整results先归档再开启下一轮。 所有失败日志保留；不改超时、不加重试、不能把外部SDK受控替换说成供应商服务通过。

已复现问题与修复入口

VAST-LIFE-01由源码观察提升为受控运行复现，问题如下：

  1. 核心destroy不清理SDK；真实浏览器中旧插件在核心销毁后仍能分配到已脱离文档的player。
  2. SDK加载中销毁后仍执行callback并初始化。
  3. callback拒绝后已分配SDK和容器保留。
  4. callback等待中销毁，恢复后仍可请求广告。
  5. SDK构造失败后容器不回滚。
  6. 同毫秒多个实例产生重复ID。
  7. 工作区活动广告destroy后状态未复位，新的play请求被永久忽略。
  8. 工作区晚到SDK回调在destroy后抛错，重建后可污染替代容器与状态。
  9. 工作区SDK destroy抛错阻止DOM及引用清理。
  10. 工作区事件注册失败后留下不完整SDK，下一次init错误地认为它已就绪。

03已建立生命周期/SDK/DOM所有权，区分可重建的显式广告destroy与终止性的核心destroy。 初始化差异按用户本次独立确认处置；04处理准确类型、SDK声明依赖和同步误声明。 运行时确认没有扩大Ads类型批准范围，也不自动豁免VAST声明兼容。

验证边界

这些测试不是实际Google IMA加载、广告加载/播放/跳过/内容恢复的验收，也没有检查 物理移动设备或最终npm tarball。SDK记录器对load错误、constructor错误、destroy错误 使用精确注入；Node固定Date.now用于同毫秒ID复现，未改变生产时钟。

只有实际VAST外部脚本持续因VPN无法加载时，可按用户授权记录并跳过该网络验证； 它不豁免类型、生命周期或其他包。本次未用该例外。05/06和SDK-07继续开放。

真实 Google IMA 专项入口

固定工具链运行 yarn test:vast-native；可使用 --project=chromium 缩小复现。 playwright.vast-native.config.js 复用8084隔离服务、单worker、零重试，输出 refactor/.cache/vast-native/。此目录在进程终止后归档，再开始下一轮。.native.js 命名避免在默认PR受控测试中隐式请求远端SDK；后续CI/发布环境需明确执行此命令。

测试保留实际Glomex打包代码，由其正常加载Google IMA；手写本地VAST响应仅指定 测试广告媒体和本地跟踪图片，不替换AdsLoader、AdsManager、事件或媒体实现。 Google的AdsRequest接口 提供adsResponse作为广告输入。每项附件记录真实执行的输入、SDK版本、浏览器版本、 广告解码截图、主片播放位置及事件；远端SDK版本会变，结果仅代表对应运行环境。

三核心固定为npm5.1.7、npm5.4.0、候选5.4.1；实际npm1.0.0插件完整bundle通过 归档校验后直接加载，候选两种模式使用同一生产构建配置的内存bundle。历史插件的 SDK清理由夹具在证据后显式补做，不能据DOM被核心移除就认为旧插件拥有SDK清理。 源代码组合通过不等于最终tarball通过，也不等于iOS/Android物理设备通过。

vast-recovery.native.js补充候选核心两模式的真实303错误恢复、显式会话重建及 广告播放中核心销毁。当前结果见05检查点： 最终组合22/27，恢复6/6；SDK超时/迟到、旧插件首帧及真机未关闭。独立入口失败应 保留为失败，不能用默认受控套件通过抵消，也不能为稳定CI添加宽泛skip。

vast-skip.native.js经真实HTTP调用playUrl，只允许IMA来源读取测试XML，验证响应 原文/MIME/CORS及广告解码；等待SDK可跳过事件和可用按钮后点击，断言AdSkipped与 主片恢复。SDK倒计时控件提前有Skip Ad名称，不能只靠名称和visible就点击。 8秒生成视频配5秒跳过点；4秒/1秒素材未出现跳过状态的结果独立保留，不泛化。 最终5/6（另1项9000失败）、共享服务12/12及固定WebKit诊断3/3见 增补记录。媒体采样仅用于 记录，未放宽原首帧断言；三次通过不能覆盖先前间歇失败。

Reference in new issue View Git Blame Copy Permalink