如何判断Canvas中的Cesium地图是否已完全加载完成?
Cesium地图加载完成自动化判断方案
核心实现思路
Cesium官方提供了原生的加载状态监听API,不需要通过DOM变化盲判,核心判断逻辑分为两个层级,可根据测试需求选择:
- 基础加载完成:指Cesium核心组件、Canvas渲染上下文初始化完成,可响应交互操作,对应监听
Viewer.readyPromise即可 - 内容完全渲染完成:指所有地形瓦片、影像瓦片、自定义加载的3D资源全部渲染完成,无空白区域,需要额外监听瓦片加载队列状态
通用判断代码(所有自动化测试框架通用)
你可以直接在测试框架中注入以下JS代码,等待返回结果后再执行后续测试步骤:
// 封装异步等待Cesium完全加载的函数 function waitForCesiumFullLoaded() { return new Promise((resolve, reject) => { // 从window获取Cesium Viewer实例,演示地址Sandcastle默认挂载为window.viewer const viewer = window.viewer; if (!viewer) return reject(new Error("未找到Cesium Viewer实例")); // 第一步:等待Cesium基础实例初始化完成 viewer.readyPromise.then(() => { // 第二步:等待所有瓦片资源加载完成 const checkLoadStatus = () => { // 待加载瓦片数量为0时判定为加载完成 const pendingTileCount = viewer.scene.globe._tileLoadQueueLength; if (pendingTileCount === 0) { // 间隔200ms二次校验,避免临时加载波动导致误判 setTimeout(() => { if (viewer.scene.globe._tileLoadQueueLength === 0) { resolve(true); } else { requestAnimationFrame(checkLoadStatus); } }, 200); return; } requestAnimationFrame(checkLoadStatus); }; checkLoadStatus(); }).catch(reject); }); } // 调用示例:await waitForCesiumFullLoaded()
不同测试框架适配方式
- Selenium:使用
executeAsyncScript方法执行上述函数,等待返回结果后再执行后续测试逻辑 - Playwright:使用
page.evaluate()调用上述异步函数,等待Promise resolve - Cypress:封装为自定义命令,通过
cy.window()获取window对象后执行判断逻辑
补充说明
如果你的业务场景中Cesium Viewer没有挂载到window对象,可以临时修改测试环境的业务代码,将Viewer实例暴露到window上,或者通过window.Cesium全局对象遍历获取活跃的Viewer实例即可。如果测试涉及自定义3D Tiles、模型加载,可额外监听对应资源的readyPromise补充判断逻辑。
内容的提问来源于stack exchange,提问作者Swaroop Humane
相关产品推荐
相关产品推荐

