/** * * 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. * * :executeAsync.js it('should execute async JavaScript on the page', function () { browser.timeoutsAsyncScript(5000); var result = browser.executeAsync(function(a, b, c, d, done) { // browser context - you may access neither client nor console setTimeout(function() { done(a + b + c + d); }, 3000); }, 1, 2, 3, 4) // node.js context - client and console are available console.log(result.value); // outputs: 10 }); * * * @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 * */ import { ProtocolError } from '../utils/ErrorHandler' export default function executeAsync (...args) { let script = args.shift() /*! * parameter check */ if ((typeof script !== 'string' && typeof script !== 'function')) { throw new ProtocolError('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 () {" */ if (typeof script === 'function' || (this.inMultibrowserMode && script.indexOf('function (') === 0)) { script = `return (${script}).apply(null, arguments)` } return this.requestHandler.create('/session/:sessionId/execute_async', { script, args }).catch((err) => { /** * jsonwire command not supported try webdriver endpoint */ if (err.message.match(/did not match a known command/)) { return this.requestHandler.create('/session/:sessionId/execute/async', { script, args }) } throw err }) }