从Cesium 1.92版本开始,Cesium.when
就被标记为废弃,并计划在未来的版本中完全移除。这意味着如果你正在使用这些版本或更高版本的Cesium,你应该改用原生的Promise。
如何迁移
如果你的代码中仍然使用了Cesium.when
,你可以按照以下步骤进行迁移:
-
查找所有使用
Cesium.when
的地方:- 在你的项目中搜索
Cesium.when
关键字,找到所有使用它的实例。
- 在你的项目中搜索
-
替换
Cesium.when
为原生Promise:- 如果你使用的是
Cesium.when
的then方法,直接替换为Promise.then
。 - 如果你使用的是
Cesium.when
的其他静态方法(如Cesium.when.all
),则替换为原生Promise的对应方法(如Promise.all
)。
- 如果你使用的是
示例
假设你有一个使用Cesium.when
的例子:
var promise1 = Cesium.when.resolve(1);
var promise2 = 2;
var promise3 = new Cesium.when.Promise(function(resolve) {
setTimeout(function() { resolve(3); }, 1000);
});
Cesium.when.all([promise1, promise2, promise3]).then(function(results) {
console.log(results); // [1, 2, 3]
});
你可以将其替换为使用原生Promise的方式:
var promise1 = Promise.resolve(1);
var promise2 = Promise.resolve(2);
var promise3 = new Promise(function(resolve) {
setTimeout(function() { resolve(3); }, 1000);
});
Promise.all([promise1, promise2, promise3]).then(function(results) {
console.log(results); // [1, 2, 3]
});
注意事项
-
确保你的环境支持原生Promise:
- 确认你的目标浏览器或环境支持Promise。大多数现代浏览器都已经支持Promise,但IE11需要Polyfill(如
es6-promise
)。
- 确认你的目标浏览器或环境支持Promise。大多数现代浏览器都已经支持Promise,但IE11需要Polyfill(如
-
检查Cesium API:
- 在更新代码时,务必检查Cesium API中的任何变化,因为一些方法的行为可能会随着API的更新而改变。
-
阅读升级指南:
- 查阅Cesium的官方文档或升级指南,了解从旧版本迁移到新版本的具体步骤。
如果你有任何具体的代码片段或疑问,欢迎提供更多的上下文信息,我可以帮助你更具体地迁移你的代码。