跳到主要内容

executeAsync(异步执行)

注意

executeAsync 命令已被弃用,将在未来版本中删除。 请改用 execute 命令,因为它通过 async/await 提供了更好的错误处理支持。

将JavaScript代码片段注入页面,在当前选定的框架上下文中执行。执行的脚本被假定为异步的,并且必须通过调用提供的回调函数来表明其已完成,该回调函数始终作为函数的最后一个参数提供。此回调函数的值将返回给客户端。

异步脚本命令可能不会跨越页面加载。如果在等待脚本结果时触发了卸载事件,则应向客户端返回错误。

script参数以函数体的形式定义要执行的脚本。该函数将使用提供的args数组进行调用,并且可以按指定顺序通过arguments对象访问这些值。最后一个参数始终是回调函数,必须调用它来表明脚本已完成。

参数可以是任何JSON原始类型、数组或JSON对象。定义WebElement引用的JSON对象将被转换为相应的DOM元素。同样,脚本结果中的任何WebElements都将作为WebElement JSON对象返回给客户端。

警告

请改用 execute

用法
browser.executeAsync(script, arguments)
参数
名称类型详情
scriptString, Function要执行的脚本。
arguments
可选
*脚本参数
示例
executeAsync.js
it('should execute async JavaScript on the page', async () => {
await browser.setTimeout({ script: 5000 })
const result = await browser.executeAsync(function(a, b, c, d, done) {
// browser context - you may not access client or console
setTimeout(() => {
done(a + b + c + d)
}, 3000);
}, 1, 2, 3, 4)
// node.js context - client and console are available
console.log(result) // outputs: 10
});
返回值
  • <*> return: 脚本结果。

Welcome! How can I help?

WebdriverIO AI Copilot