threejs-testing

3D 测试与视觉 QA

使用项目中已安装的版本和现有架构。这些说明是对用户任务的补充，不授权进行无关更改或执行外部操作。

将要求的行为转化为可观察的检查项：主体是否可见、取景是否正确、交互结果、加载失败与重试、尺寸调整、拆卸，以及任何明确的性能目标。测试范围应与更改规模相称。

对于纯坐标变换、选择映射、时间步策略和归约器，在有意义的情况下使用单元测试。模拟渲染器无法证明像素是否正确渲染。运行生产构建，并使用浏览器测试页面进行 GPU 集成测试。

确保视觉测试夹具可复现：为随机数设定种子，固定摄像机、视口和像素比，将动画停止或定位到已知时间，并等待资源就绪且至少完成一帧渲染。使用语义化的就绪信号，而非任意等待。除屏幕截图外，还要捕获控制台错误和网络失败。

对受 GPU 影响的像素比较采用容差；不要将不同驱动程序之间的图像完全相同视为可移植的约定。检查屏幕截图中是否存在裁切、对比度问题、阴影缺陷、文字或叠加层遮挡，以及残留的加载状态。浏览器功能预期应限定于受测后端。

测试重复导航、快速切换资源、从隐藏到可见时的尺寸调整、触摸交互、减少动态效果、渲染不受支持的情况，以及相关的实际设备和浏览器。无头软件渲染不能作为移动 GPU 基准测试。

将检查结果报告为通过、失败或未运行，并说明原因。不要仅凭编译结果声称具备性能、XR 硬件支持或辅助技术行为方面的能力。

API 参考

有关确切签名和特定修订版的行为，请参阅官方文档。如果无法访问文档，请检查已安装的类型定义或源代码，并说明任何尚未确定之处。