executeAsync

警告

executeAsyncコマンドは非推奨であり、将来のバージョンで削除される予定です。代わりにexecuteコマンドを使用してください。executeコマンドはasync/awaitを通じてより良いエラー処理のサポートを提供します。

JavaScriptのスニペットをページに注入し、現在選択されているフレームのコンテキストで実行します。対象要素をスコープとして使用するため、WebdriverIOはスクリプトを実行する前に自動的に要素が存在するまで待機します。実行されるスクリプトは非同期であると想定され、提供されるコールバック（常に関数の最後の引数として提供される）を呼び出すことによって完了を通知する必要があります。このコールバックに渡された値がクライアントに返されます。

非同期スクリプトコマンドはページロードをまたぐことはできません。スクリプト結果を待っている間にアンロードイベントが発生した場合は、エラーがクライアントに返されます。

script引数は関数本体の形式で実行するスクリプトを定義します。この関数は提供されたargs配列で呼び出され、値は指定された順序でargumentsオブジェクトを介してアクセスできます。最後の引数は常にコールバック関数であり、スクリプトが完了したことを通知するために呼び出す必要があります。

引数はJSON基本型、配列、またはJSONオブジェクトのいずれかです。WebElement参照を定義するJSONオブジェクトは対応するDOM要素に変換されます。同様に、スクリプト結果内のWebElementは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: スクリプトの結果。

使用法​

パラメータ​

例​

戻り値​

使用法

パラメータ

例

戻り値