com.github.markusbernhardt.selenium2library.keywords.JavaScript Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of robotframework-selenium2library-java Show documentation
Show all versions of robotframework-selenium2library-java Show documentation
Java port of the Selenium 2 (WebDriver) Python library for Robot Framework
package com.github.markusbernhardt.selenium2library.keywords;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.nio.MappedByteBuffer;
import java.nio.channels.FileChannel;
import java.nio.charset.Charset;
import java.util.Arrays;
import org.openqa.selenium.Alert;
import org.openqa.selenium.JavascriptExecutor;
import org.openqa.selenium.WebDriverException;
import org.robotframework.javalib.annotation.ArgumentNames;
import org.robotframework.javalib.annotation.Autowired;
import org.robotframework.javalib.annotation.RobotKeyword;
import org.robotframework.javalib.annotation.RobotKeywordOverload;
import org.robotframework.javalib.annotation.RobotKeywords;
import com.github.markusbernhardt.selenium2library.RunOnFailureKeywordsAdapter;
import com.github.markusbernhardt.selenium2library.Selenium2LibraryNonFatalException;
import com.github.markusbernhardt.selenium2library.utils.Python;
@RobotKeywords
public class JavaScript extends RunOnFailureKeywordsAdapter {
/**
* Instantiated BrowserManagement keyword bean
*/
@Autowired
protected BrowserManagement browserManagement;
/**
* Instantiated Logging keyword bean
*/
@Autowired
protected Logging logging;
// ##############################
// Keywords
// ##############################
@RobotKeywordOverload
public void alertShouldBePresent() {
alertShouldBePresent("");
}
/**
* Verify an alert is present and dismiss it.
*
* If text is a non-empty string, then it is also verified that the
* message of the alert equals to text.
*
* Will fail if no alert is present. Note that following keywords will fail
* unless the alert is dismissed by this keyword or another like `Get Alert
* Message`.
*
* @param text
* Default=NONE. The alert message to verify.
*/
@RobotKeyword
@ArgumentNames({ "text=NONE" })
public void alertShouldBePresent(String text) {
String alertText = getAlertMessage();
if (text != null && !alertText.equals(text)) {
throw new Selenium2LibraryNonFatalException(String.format("Alert text should have been '%s' but was '%s'",
text, alertText));
}
}
/**
* Cancel will be selected the next time a confirmation dialog appears.
*/
@RobotKeyword
public void chooseCancelOnNextConfirmation() {
cancelOnNextConfirmation = true;
}
/**
* Undo the effect of using keywords `Choose Cancel On Next Confirmation`.
*
* Note that Selenium's overridden window.confirm() function will
* normally automatically return true, as if the user had manually clicked
* OK, so you shouldn't need to use this command unless for some reason you
* need to change your mind prior to the next confirmation.
*
* After any confirmation, Selenium will resume using the default behavior
* for future confirmations, automatically returning true (OK) unless/until
* you explicitly use `Choose Cancel On Next Confirmation` for each
* confirmation.
*
* Note that every time a confirmation comes up, you must consume it by
* using a keywords such as `Get Alert Message`, or else the following
* Selenium operations will fail.
*/
@RobotKeyword
public void chooseOkOnNextConfirmation() {
cancelOnNextConfirmation = false;
}
/**
* Dismisses currently shown confirmation dialog and returns its message.
*
* By default, this keyword chooses 'OK' option from the dialog. If 'Cancel'
* needs to be chosen, keyword `Choose Cancel On Next Confirmation` must be
* called before the action that causes the confirmation dialog to be shown.
*
* Example:
*
*
* Click Button
* Send
* # Shows a confirmation dialog
*
*
* ${message}=
* Confirm Action
* # Chooses Ok
*
*
* Should Be Equal
* ${message}
* Are your sure?
* # Check dialog message
*
*
* Choose Cancel On Next Confirmation
* # Choose cancel on next `Confirm Action`
*
*
* Click Button
* Send
* # Shows a confirmation dialog
*
*
* Confirm Action
* # Chooses Cancel
*
*
*
* @return The dialog message.
*/
@RobotKeyword
public String confirmAction() {
String text = closeAlert(!cancelOnNextConfirmation);
cancelOnNextConfirmation = false;
return text;
}
/**
* Execute the given JavaScript code.
*
* The given code may contain multiple lines of code, but must contain a
* return statement (with the value to be returned) at the end.
*
* The given code may be divided into multiple cells in the test data. In
* that case, the parts are concatenated together without adding spaces. If
* the given code is an absolute path to an existing file, the JavaScript to
* execute will be read from that file. Forward slashes work as a path
* separator on all operating systems.
*
* Note that by default the code will be executed in the context of the
* Selenium object itself, so this will refer to the Selenium object.
* Use window to refer to the window of your application, e.g.
* window.document.getElementById('foo').
*
* Example:
*
*
* Execute JavaScript
* return window.my_js_function('arg1', 'arg2');
* # Directly execute the JavaScript
*
*
* Execute JavaScript
* ${CURDIR}/js_to_execute.js
* # Load the JavaScript to execute from file
*
*
*
* @param code
* The JavaScript code or a file name.
* @return The return value of the executed code.
*/
@RobotKeyword
@ArgumentNames({ "*code" })
public Object executeJavascript(String... code) {
String js = getJavascriptToExecute(Python.join("", Arrays.asList(code)));
String.format("Executing JavaScript:\n%s", js);
return ((JavascriptExecutor) browserManagement.getCurrentWebDriver()).executeScript(js);
}
/**
* Execute the given JavaScript code asynchronously.
*
* The given code may contain multiple lines of code, but must contain a
* return statement (with the value to be returned) at the end.
*
* The given code may be divided into multiple cells in the test data. In
* that case, the parts are concatenated together without adding spaces. If
* the given code is an absolute path to an existing file, the JavaScript to
* execute will be read from that file. Forward slashes work as a path
* separator on all operating systems.
*
* Note that by default the code will be executed in the context of the
* Selenium object itself, so this will refer to the Selenium object.
* Use window to refer to the window of your application, e.g.
* window.document.getElementById('foo').
*
* Example:
*
*
* Execute Async JavaScript
* return window.my_js_function('arg1', 'arg2');
* # Directly execute the JavaScript
*
*
* Execute Async JavaScript
* ${CURDIR}/js_to_execute.js
* # Load the JavaScript to execute from file
*
*
*
* @param code
* The JavaScript code or a file name.
* @return The return value of the executed code.
*/
@RobotKeyword
@ArgumentNames({ "*code" })
public Object executeAsyncJavascript(String... code) {
String js = getJavascriptToExecute(Python.join("", Arrays.asList(code)));
String.format("Executing JavaScript:\n%s", js);
return ((JavascriptExecutor) browserManagement.getCurrentWebDriver()).executeAsyncScript(js);
}
/**
* Returns the text of current JavaScript alert.
*
* This keyword will fail if no alert is present. Note that following
* keywords will fail unless the alert is dismissed by this keyword or
* another like `Get Alert Message`.
*
* @return The alert message.
*/
@RobotKeyword
public String getAlertMessage() {
return closeAlert();
}
// ##############################
// Internal Methods
// ##############################
protected boolean cancelOnNextConfirmation = false;
protected String closeAlert() {
return closeAlert(false);
}
protected String closeAlert(boolean confirm) {
Alert alert = null;
try {
alert = browserManagement.getCurrentWebDriver().switchTo().alert();
String text = alert.getText().replace("\n", "");
if (!confirm) {
alert.dismiss();
} else {
alert.accept();
}
return text;
} catch (WebDriverException wde) {
throw new Selenium2LibraryNonFatalException("There were no alerts");
}
}
protected static String readFile(String path) throws IOException {
FileInputStream stream = new FileInputStream(new File(path));
try {
FileChannel fc = stream.getChannel();
MappedByteBuffer bb = fc.map(FileChannel.MapMode.READ_ONLY, 0, fc.size());
/* Instead of using default, pass in a decoder. */
return Charset.defaultCharset().decode(bb).toString();
} finally {
stream.close();
}
}
protected String getJavascriptToExecute(String code) {
String codepath = code.replace('/', File.separatorChar);
if (!new File(codepath).isFile()) {
return code;
}
logging.html(String.format("Reading JavaScript from file %s.",
codepath.replace(File.separatorChar, '/'), codepath));
try {
return readFile(codepath);
} catch (IOException e) {
throw new Selenium2LibraryNonFatalException("Cannot read JavaScript file: " + codepath);
}
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy