executeAsync(异步执行)
注意
executeAsync
命令已被弃用,将在未来版本中移除。
请使用 execute
命令代替,因为它通过 async
/await
提供了更好的错误处理支持。
将JavaScript代码片段注入页面,在当前选定的框架上下文中执行,并使用给定元素作为作用域,因为它在元素作用域上,所以WebdriverIO会在执行脚本前自动等待元素存在。 执行的脚本假定为异步的,必须通过调用提供的回调函数来表示执行完成,该回调函数始终作为函数的最后一个参数提供。 此回调函数的值将返回给客户端。
异步脚本命令可能不会跨越页面加载。如果在等待脚本结果时触发了卸载事件,将向客户端返回错误。
脚本参数以函数体的形式定义要执行的脚本。该函数将使用提供的args数组进行调用,可以按指定顺序通过arguments对象访问这些值。最后一个参数将始终是一个回调函数,必须调用它以表示脚本已完成。
参数可以是任何JSON原始值、数组或JSON对象。定义WebElement引用的JSON对象将转换为相应的DOM元素。同样,脚本结果中的任何WebElements都将作为WebElement JSON对象返回给客户端。
警告
请使用 execute
代替
用法
$(selector).executeAsync(script, arguments)
参数
名称 | 类型 | 详情 |
---|---|---|
script | String, Function | 要执行的脚本。 |
arguments 可选 | * | 脚本参数 |
示例
executeAsync.js
it('should wait for the element to exist, then executes async javascript on the page with the element as first argument', async () => {
await browser.setTimeout({ script: 5000 })
const text = await $('div').execute((elem, a, b, c, d) => {
// browser context - you may not access client or console
setTimeout(() => {
done(elem.textContent + a + b + c + d)
}, 3000);
}, 1, 2, 3, 4);
// node.js context - client and console are available
// node.js context - client and console are available
console.log(text); // outputs "Hello World1234"
});
返回值
- <*>
return
: 脚本结果。