如何使用ArcGIS Javascript API将WebMap缩放到全要素可见范围

• webmap.when() 仅代表WebMap实例本身的元数据加载完成，此时WebMap中包含的各个图层（尤其是要素图层、业务图层）的资源、范围属性还未完全加载，此时获取的webmap.fullExtent要么是空值，要么是WebMap发布时预设的初始范围，并不是所有图层加载完成后的实际总范围。
• ArcGIS JS API 4.x 不推荐直接给view.extent赋值，这种赋值方式在视图投影与范围不匹配、或视图未完成初始化时大概率不生效，官方统一推荐使用view.goTo()方法更新视图视角。

简化方案（适用WebMap发布时已配置正确全图范围的场景） #

如果你的WebMap在ArcGIS Online发布时，已经设置好了包含所有要素的初始视角，可以直接调用以下代码，性能更好：

view.when(() => {
  view.goTo(webmap.initialViewProperties.viewpoint, {duration: 0});
});

通用方案（适用图层动态变化、或发布时初始范围不符合要求的场景） #

等待所有图层加载完成后，合并所有可见图层的范围，再让视图跳转到合并后的总范围：

view.when(async () => {
  const extents = [];
  // 遍历WebMap下所有图层
  for (const layer of webmap.allLayers) {
    // 跳过不可见图层，无需纳入范围计算
    if (!layer.visible) continue;
    try {
      // 等待图层加载完成，才能获取正确的fullExtent
      await layer.load();
      if (layer.fullExtent) {
        extents.push(layer.fullExtent);
      }
    } catch (err) {
      console.warn("图层加载失败，已跳过：", layer.title, err);
    }
  }
  if (extents.length > 0) {
    // 合并所有图层范围得到总范围
    const totalExtent = extents.reduce((prevExtent, currExtent) => prevExtent.union(currExtent));
    // 跳转至总范围，duration参数控制动画时长，设为0则无动画
    view.goTo(totalExtent, {
      duration: 500
    }).catch(err => {
      // 忽略用户操作中断跳转的报错
      if (err.name !== "AbortError") console.error("视角跳转失败：", err);
    });
  }
});

内容的提问来源于stack exchange，提问作者Jorge Chávez