Press n or j to go to the next uncovered block, b, p or k for the previous block.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 | 3x 3x 2x 1x 1x 1x | import { verifyArgsAndStripIfElement } from '../../utils'
/**
*
* Inject a snippet of JavaScript into the page for execution in the context of the currently selected
* frame. The executed script is assumed to be asynchronous and must signal that is done by invoking
* the provided callback, which is always provided as the final argument to the function. The value
* to this callback will be returned to the client.
*
* Asynchronous script commands may not span page loads. If an unload event is fired while waiting
* for a script result, an error should be returned to the client.
*
* The script argument defines the script to execute in the form of a function body. The function will
* be invoked with the provided args array and the values may be accessed via the arguments object
* in the order specified. The final argument will always be a callback function that must be invoked
* to signal that the script has finished.
*
* Arguments may be any JSON-primitive, array, or JSON object. JSON objects that define a WebElement
* reference will be converted to the corresponding DOM element. Likewise, any WebElements in the script
* result will be returned to the client as WebElement JSON objects.
*
* <example>
:executeAsync.js
it('should execute async JavaScript on the page', () => {
browser.setTimeout({ script: 5000 })
const result = 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
});
* </example>
*
* @param {String|Function} script The script to execute.
* @param {*=} arguments script arguments
*
* @return {*} The script result.
*
* @see https://w3c.github.io/webdriver/webdriver-spec.html#dfn-execute-async-script
* @type protocol
*
*/
export default function executeAsync (...args) {
let script = args.shift()
/*!
* parameter check
*/
if ((typeof script !== 'string' && typeof script !== 'function')) {
throw new Error('number or type of arguments don\'t agree with execute protocol command')
}
/*!
* instances started as multibrowserinstance can't getting called with
* a function parameter, therefor we need to check if it starts with "function () {"
*/
Eif (typeof script === 'function') {
script = `return (${script}).apply(null, arguments)`
}
return this.executeAsyncScript(script, verifyArgsAndStripIfElement(args))
}
|