executeAsync

警告

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

将一段 JavaScript 代码注入页面，以便在当前选定框架的上下文中执行，并使用给定元素作为作用域，因为它位于元素作用域，这意味着 WebdriverIO 将自动等待元素存在，然后再执行脚本。假设执行的脚本是异步的，并且必须通过调用提供的回调来发出已完成的信号，该回调始终作为函数的最后一个参数提供。此回调的值将返回给客户端。

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

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

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

注意

正确

用法

$(selector).executeAsync(script, arguments)

参数

名称	类型	详情
script	String、Function	要执行的脚本。
arguments 可选	param	脚本参数

示例

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"
});