You need to enable JavaScript to run this app. 如何判断Canvas中的Cesium地图是否已完全加载完成?
优惠活动
大模型
产品
解决方案
定价
更多

如何判断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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.11 12:54:03