nl.hsac.fitnesse.fixture.util.selenium.SeleniumHelper Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of hsac-fitnesse-fixtures Show documentation
Show all versions of hsac-fitnesse-fixtures Show documentation
Fixtures to assist in testing via FitNesse
package nl.hsac.fitnesse.fixture.util.selenium;
import nl.hsac.fitnesse.fixture.slim.StopTestException;
import nl.hsac.fitnesse.fixture.util.FileUtil;
import nl.hsac.fitnesse.fixture.util.selenium.by.*;
import org.apache.commons.io.FilenameUtils;
import org.apache.commons.lang3.StringUtils;
import org.openqa.selenium.*;
import org.openqa.selenium.ie.InternetExplorerDriver;
import org.openqa.selenium.interactions.Actions;
import org.openqa.selenium.remote.Augmenter;
import org.openqa.selenium.remote.RemoteWebDriver;
import org.openqa.selenium.remote.ScreenshotException;
import org.openqa.selenium.safari.SafariDriver;
import org.openqa.selenium.support.ui.ExpectedCondition;
import org.openqa.selenium.support.ui.FluentWait;
import org.openqa.selenium.support.ui.Select;
import org.openqa.selenium.support.ui.WebDriverWait;
import java.net.MalformedURLException;
import java.net.URL;
import java.util.ArrayList;
import java.util.Base64;
import java.util.List;
import java.util.Set;
import java.util.concurrent.TimeUnit;
import java.util.function.Function;
import java.util.function.Supplier;
/**
* Helper to work with Selenium.
*/
public class SeleniumHelper {
/** Default time in seconds the wait web driver waits unit throwing TimeOutException. */
private static final int DEFAULT_TIMEOUT_SECONDS = 10;
private static final String ELEMENT_ON_SCREEN_JS =
"if (arguments[0].getBoundingClientRect) {\n" +
"var rect = arguments[0].getBoundingClientRect();\n" +
"return (\n" +
" rect.top >= 0 &&\n" +
" rect.left >= 0 &&\n" +
" rect.bottom <= (window.innerHeight || document.documentElement.clientHeight) &&\n" +
" rect.right <= (window.innerWidth || document.documentElement.clientWidth));\n" +
"} else { return null; }";
private static final String ALL_DIRECT_TEXT_CONTENT =
"var element = arguments[0], text = '';\n" +
"for (var i = 0; i < element.childNodes.length; ++i) {\n" +
" var node = element.childNodes[i];\n" +
" if (node.nodeType == Node.TEXT_NODE" +
" && node.textContent.trim() != '')\n" +
" text += node.textContent.trim();\n" +
"}\n" +
"return text;";
private final static char NON_BREAKING_SPACE = 160;
private final List currentIFramePath = new ArrayList(4);
private int frameDepthOnLastAlertError;
private DriverFactory factory;
private WebDriver webDriver;
private WebDriverWait webDriverWait;
private boolean shutdownHookEnabled = false;
private int defaultTimeoutSeconds = DEFAULT_TIMEOUT_SECONDS;
/**
* Sets up webDriver to be used.
* @param aWebDriver web driver to use.
*/
public void setWebDriver(WebDriver aWebDriver) {
if (webDriver != null && !webDriver.equals(aWebDriver)) {
webDriver.quit();
}
webDriver = aWebDriver;
if (webDriver == null) {
webDriverWait = null;
} else {
webDriverWait = new WebDriverWait(webDriver, getDefaultTimeoutSeconds());
}
if (!shutdownHookEnabled) {
Runtime.getRuntime().addShutdownHook(new Thread() {
public void run() {
close();
}
});
shutdownHookEnabled = true;
}
}
/**
* Shuts down selenium web driver.
*/
public void close() {
setWebDriver(null);
}
/**
* @return current page title.
*/
public String getPageTitle() {
return driver().getTitle();
}
/**
* @return Selenium's navigation.
*/
public WebDriver.Navigation navigate() {
return driver().navigate();
}
/**
* Finds element to click, by searching in multiple locations.
* @param place identifier for element.
* @return first interactable element found,
* first element found if no interactable element could be found,
* null if none could be found.
*/
public WebElement getElementToClick(String place) {
return findByTechnicalSelectorOr(place, ToClickBy::heuristic);
}
/**
* Finds link.
* @param place technical selector or (partial text on link).
* @return first interactable link found,
* first element found if no interactable link could be found,
* null if none could be found.
*/
public WebElement getLink(String place) {
return findByTechnicalSelectorOr(place, LinkBy::heuristic);
}
/**
* Finds element to retrieve content from or enter content in, by searching in multiple locations.
* @param place identifier for element.
* @return first interactable element found,
* first element found if no interactable element could be found,
* null if none could be found.
*/
public WebElement getElement(String place) {
return findByTechnicalSelectorOr(place, ElementBy::heuristic);
}
public WebElement findByTechnicalSelectorOr(String place, Function byFunction) {
By by = placeToBy(place);
if (by == null) {
by = byFunction.apply(place);
}
return findElement(by);
}
public WebElement findByTechnicalSelectorOr(String possibleTechnicalSelector, Supplier supplier) {
WebElement element;
By by = placeToBy(possibleTechnicalSelector);
if (by != null) {
element = findElement(by);
} else {
element = supplier.get();
}
return element;
}
public By placeToBy(String place) {
return TechnicalSelectorBy.forPlace(place);
}
/**
* @param element element to check.
* @return whether the element is displayed and enabled.
*/
public boolean isInteractable(WebElement element) {
return IsInteractableFilter.mayPass(element);
}
public WebElement getLabelledElement(WebElement label) {
return LabelBy.getLabelledElement(getCurrentContext(), label);
}
public WebElement getNestedElementForValue(WebElement parent) {
return ConstantBy.nestedElementForValue().findElement(parent);
}
/**
* Determines number displayed for item in ordered list.
* @param element ordered list item.
* @return number, if one could be determined.
*/
public Integer getNumberFor(WebElement element) {
Integer number = null;
if ("li".equalsIgnoreCase(element.getTagName())
&& element.isDisplayed()) {
int num;
String ownVal = element.getAttribute("value");
if (ownVal != null && !"0".equals(ownVal)) {
num = toInt(ownVal, 0);
} else {
String start = element.findElement(By.xpath("ancestor::ol")).getAttribute("start");
num = toInt(start, 1);
List allItems = element.findElements(By.xpath("ancestor::ol/li"));
int index = allItems.indexOf(element);
for (int i = 0; i < index; i++) {
WebElement item = allItems.get(i);
if (item.isDisplayed()) {
num++;
String val = item.getAttribute("value");
int valNum = toInt(val, num);
if (valNum != 0) {
num = valNum + 1;
}
}
}
}
number = num;
}
return number;
}
private int toInt(String attributeValue, int defaultVal) {
int result = defaultVal;
if (attributeValue != null) {
try {
result = Integer.parseInt(attributeValue);
} catch (NumberFormatException e) {
throw new IllegalArgumentException("Unable to parse value: " + attributeValue, e);
}
}
return result;
}
/**
* Returns the texts of all available options for the supplied select element.
* @param element select element to find options for.
* @return text per option.
*/
public ArrayList getAvailableOptions(WebElement element) {
ArrayList result = null;
if (isInteractable(element)
&& "select".equalsIgnoreCase(element.getTagName())) {
result = new ArrayList();
List options = element.findElements(By.tagName("option"));
for (WebElement option : options) {
if (option.isEnabled()) {
result.add(option.getText());
}
}
}
return result;
}
public int countVisibleOccurrences(String text, boolean checkOnScreen) {
SearchContext containerContext = getCurrentContext();
By findAllTexts = TextBy.partial(text);
List texts = containerContext.findElements(findAllTexts);
int result = countDisplayedElements(texts, text, checkOnScreen);
By findAllInputs = InputBy.partialNormalizedValue(text);
List inputs = containerContext.findElements(findAllInputs);
result = result + countDisplayedValues(inputs, text, checkOnScreen);
return result;
}
private int countDisplayedElements(List elements, String textToFind, boolean checkOnScreen) {
int result = 0;
for (WebElement element : elements) {
if (checkVisible(element, checkOnScreen)) {
if ("option".equalsIgnoreCase(element.getTagName())) {
WebElement select = element.findElement(By.xpath("./ancestor::select"));
Select s = new Select(select);
if (s == null || s.isMultiple()) {
// for multi-select we count all options as visible
int occurrencesInText = getOccurrencesInText(element, textToFind);
result += occurrencesInText;
} else {
// for drop down we only count only selected option
WebElement selected = s.getFirstSelectedOption();
if (element.equals(selected)) {
int occurrencesInText = getOccurrencesInText(element, textToFind);
result += occurrencesInText;
}
}
} else {
int occurrencesInText = getOccurrencesInText(element, textToFind);
result += occurrencesInText;
}
}
}
return result;
}
private int getOccurrencesInText(WebElement element, String textToFind) {
String elementText = getAllDirectText(element);
return countOccurrences(elementText, textToFind);
}
private int countDisplayedValues(List elements, String textToFind, boolean checkOnScreen) {
int result = 0;
for (WebElement element : elements) {
if (checkVisible(element, checkOnScreen)) {
String value = element.getAttribute("value");
int occurrencesInValue = countOccurrences(value, textToFind);
result += occurrencesInValue;
}
}
return result;
}
public boolean checkVisible(WebElement element, boolean checkOnScreen) {
boolean result = false;
if (element != null && element.isDisplayed()) {
if (checkOnScreen) {
result = isElementOnScreen(element);
} else {
result = true;
}
}
return result;
}
private int countOccurrences(String value, String textToFind) {
String normalizedValue = XPathBy.getNormalizedText(value);
return StringUtils.countMatches(normalizedValue, textToFind);
}
/**
* Gets element's text content.
* @param element element to get text() of.
* @return text, without trailing whitespace and with as normal spaces.
*/
public String getText(WebElement element) {
String text = element.getText();
if (text != null) {
// Safari driver does not return as normal spacce, while others do
text = text.replace(NON_BREAKING_SPACE, ' ');
// Safari driver does not return trim, while others do
text = text.trim();
}
return text;
}
/**
* Gets the entire text of element, without the text elements of its children (which a normal element.getText()
* does include).
* @param element element to get text from.
* @return all text in the element.
*/
public String getAllDirectText(WebElement element) {
return (String) executeJavascript(ALL_DIRECT_TEXT_CONTENT, element);
}
/**
* Sets value of input field of type 'date'.
* Entering a value using sendKeys requires you to know what format the browser's OS is using for dates,
* this method prevents that problem by setting the input's value directly.
* @param element id or name of input field to set.
* @param value value to set, must be in format yyyy-mm-dd.
*/
public void fillDateInput(WebElement element, String value) {
executeJavascript("arguments[0].value = arguments[1]", element, value);
}
/**
* Sets value of hidden input field.
* @param idOrName id or name of input field to set.
* @param value value to set.
* @return whether input field was found.
*/
public boolean setHiddenInputValue(String idOrName, String value) {
WebElement element = findElement(By.id(idOrName));
if (element == null) {
element = findElement(By.name(idOrName));
if (element != null) {
executeJavascript("document.getElementsByName('%s')[0].value='%s'", idOrName, value);
}
} else {
executeJavascript("document.getElementById('%s').value='%s'", idOrName, value);
}
return element != null;
}
/**
* Executes Javascript in browser. If statementPattern contains the magic variable 'arguments'
* the parameters will also be passed to the statement. In the latter case the parameters
* must be a number, a boolean, a String, WebElement, or a List of any combination of the above.
* @link http://selenium.googlecode.com/git/docs/api/java/org/openqa/selenium/JavascriptExecutor.html#executeScript(java.lang.String,%20java.lang.Object...)
* @param statementPattern javascript to run, possibly with placeholders to be replaced.
* @param parameters placeholder values that should be replaced before executing the script.
* @return return value from statement.
*/
public Object executeJavascript(String statementPattern, Object... parameters) {
Object result;
String script = String.format(statementPattern, parameters);
if (statementPattern.contains("arguments")) {
result = executeScript(script, parameters);
} else {
result = executeScript(script);
}
return result;
}
protected Object executeScript(String script, Object... parameters) {
JavascriptExecutor jse = (JavascriptExecutor) driver();
Object result = JavascriptHelper.executeScript(jse, script, parameters);
return result;
}
/**
* Executes Javascript in browser and then waits for 'callback' to be invoked.
* If statementPattern should reference the magic (function) variable 'callback' which should be
* called to provide this method's result.
* If the statementPattern contains the magic variable 'arguments'
* the parameters will also be passed to the statement. In the latter case the parameters
* must be a number, a boolean, a String, WebElement, or a List of any combination of the above.
* @link http://selenium.googlecode.com/git/docs/api/java/org/openqa/selenium/JavascriptExecutor.html#executeAsyncScript(java.lang.String,%20java.lang.Object...)
* @param statementPattern javascript to run, possibly with placeholders to be replaced.
* @param parameters placeholder values that should be replaced before executing the script.
* @return return value from statement.
*/
public Object waitForJavascriptCallback(String statementPattern, Object... parameters) {
JavascriptExecutor jse = (JavascriptExecutor) driver();
Object result = JavascriptHelper.waitForJavascriptCallback(jse, statementPattern, parameters);
return result;
}
/**
* Creates By based on CSS selector, supporting placeholder replacement.
* @param pattern basic CSS selector, possibly with placeholders.
* @param parameters values for placeholders.
* @return ByCssSelector.
*/
public By byCss(String pattern, String... parameters) {
return new CssBy(pattern, parameters);
}
/**
* Creates By based on xPath, supporting placeholder replacement.
* It also supports the fictional 'normalized()' function that does whitespace normalization, that also
* considers a ' ' whitespace.
* @param pattern basic XPATH, possibly with placeholders.
* @param parameters values for placeholders.
* @return ByXPath.
*/
public By byXpath(String pattern, String... parameters) {
return new XPathBy(pattern, parameters);
}
public By byJavascript(String pattern, Object... arguments) {
return new JavascriptBy(pattern, arguments);
}
/**
* Checks whether element is in browser's viewport.
* @param element element to check
* @return true if element is in browser's viewport, null if we could not determine whether it was in viewport.
*/
public Boolean isElementOnScreen(WebElement element) {
return (Boolean)executeJavascript(ELEMENT_ON_SCREEN_JS, element);
}
/**
* Sets how long to wait before deciding an element does not exists.
* @param implicitWait time in milliseconds to wait.
*/
public void setImplicitlyWait(int implicitWait) {
try {
driver().manage().timeouts().implicitlyWait(implicitWait, TimeUnit.MILLISECONDS);
} catch (Exception e) {
// https://code.google.com/p/selenium/issues/detail?id=6015
System.err.println("Unable to set implicit timeout (known issue for Safari): " + e.getMessage());
}
}
/**
* Sets how long to wait when executing asynchronous script calls.
* @param scriptTimeout time in milliseconds to wait.
*/
public void setScriptWait(int scriptTimeout) {
try {
driver().manage().timeouts().setScriptTimeout(scriptTimeout, TimeUnit.MILLISECONDS);
} catch (Exception e) {
// https://code.google.com/p/selenium/issues/detail?id=6015
System.err.println("Unable to set script timeout (known issue for Safari): " + e.getMessage());
}
}
/**
* Sets how long to wait on opening a page.
* @param pageLoadWait time in milliseconds to wait.
*/
public void setPageLoadWait(int pageLoadWait) {
try {
driver().manage().timeouts().pageLoadTimeout(pageLoadWait, TimeUnit.MILLISECONDS);
} catch (Exception e) {
// https://code.google.com/p/selenium/issues/detail?id=6015
System.err.println("Unable to set page load timeout (known issue for Safari): " + e.getMessage());
}
}
/**
* Simulates placing the mouse over the supplied element.
* @param element element to place mouse over.
*/
public void hoverOver(WebElement element) {
getActions().moveToElement(element).perform();
}
/**
* Simulates double clicking on the supplied element
* @param element element to double click on
*/
public void doubleClick(WebElement element) {
getActions().doubleClick(element).perform();
}
/**
* Simulates right clicking (i.e. context clicking) on the supplied element
* @param element element to right click on
*/
public void rightClick(WebElement element) {
getActions().contextClick(element).perform();
}
/**
* Simulates a drag from source element and drop to target element
* @param source element to start the drag
* @param target element to end the drag
*/
public void dragAndDrop(WebElement source, WebElement target) {
getActions().dragAndDrop(source, target).perform();
}
public Actions getActions() {
return new Actions(driver());
}
/**
* @return currently active element.
*/
public WebElement getActiveElement() {
return getTargetLocator().activeElement();
}
/**
* Finds element using xPath, supporting placeholder replacement.
* @param pattern basic XPATH, possibly with placeholders.
* @param parameters values for placeholders.
* @return element if found, null if none could be found.
*/
public WebElement findByXPath(String pattern, String... parameters) {
By by = byXpath(pattern, parameters);
return findElement(by);
}
/**
* Finds element matching the By supplied.
* @param by criteria.
* @return element if found, null if none could be found.
*/
public WebElement findElement(By by) {
return findElement(getCurrentContext(), by);
}
private SearchContext currentContext;
public void setCurrentContext(SearchContext currentContext) {
this.currentContext = currentContext;
}
public SearchContext getCurrentContext() {
return currentContext != null? currentContext : driver();
}
/**
* Perform action/supplier in context.
* @param context context to perfom action in.
* @param action action to perform.
* @param type of action result.
* @return action result.
*/
public T doInContext(SearchContext context, Supplier action) {
T result;
if (context == null) {
result = action.get();
} else {
SearchContext currentSearchContext = getCurrentContext();
setCurrentContext(context);
try {
result = action.get();
} finally {
setCurrentContext(currentSearchContext);
}
}
return result;
}
/**
* Finds the nth element matching the By supplied.
* @param by criteria.
* @param index (zero based) matching element to return.
* @return element if found, null if none could be found.
*/
public WebElement findElement(By by, int index) {
WebElement element = null;
List elements = getCurrentContext().findElements(by);
if (elements.size() > index) {
element = elements.get(index);
}
return element;
}
/**
* @return the session id from the current driver (if available).
*/
public String getSessionId() {
String result = null;
WebDriver d = driver();
if (d instanceof RemoteWebDriver) {
Object s = ((RemoteWebDriver) d).getSessionId();
if (s != null) {
result = s.toString();
}
}
return result;
}
/**
* @return true when current driver is connected to either a local or remote Internet Explorer.
*/
public boolean connectedToInternetExplorer() {
boolean result = false;
WebDriver driver = driver();
if (driver instanceof InternetExplorerDriver) {
result = true;
} else if (driver instanceof RemoteWebDriver) {
result = checkRemoteBrowserName(driver, "internet explorer");
}
return result;
}
/**
* @return true when current driver is connected to either a local or remote Safari.
*/
public boolean connectedToSafari() {
boolean result = false;
WebDriver driver = driver();
if (driver instanceof SafariDriver) {
result = true;
} else if (driver instanceof RemoteWebDriver) {
result = checkRemoteBrowserName(driver, "safari");
}
return result;
}
protected boolean checkRemoteBrowserName(WebDriver driver, String expectedName) {
RemoteWebDriver remoteWebDriver = (RemoteWebDriver) driver;
String browserName = remoteWebDriver.getCapabilities().getBrowserName();
return expectedName.equalsIgnoreCase(browserName);
}
/**
* Allows direct access to WebDriver. If possible please use methods of this class to facilitate testing.
* @return selenium web driver.
*/
public WebDriver driver() {
if (webDriver == null) {
if (factory == null) {
throw new StopTestException("Cannot use Selenium before a driver is started (for instance using SeleniumDriverSetup)");
} else {
factory.createDriver();
}
}
return webDriver;
}
/**
* Allows clients to wait until a certain condition is true.
* @return wait using the driver in this helper.
*/
public WebDriverWait waitDriver() {
return webDriverWait;
}
/**
* Executes condition until it returns a value other than null or false.
* It does not forward StaleElementReferenceExceptions, but keeps waiting.
* @param maxSecondsToWait number of seconds to wait at most.
* @param condition condition to check.
* @param return type.
* @return result of condition (if not null).
* @throws TimeoutException when condition did not give a value to return after maxSecondsToWait.
*/
public T waitUntil(int maxSecondsToWait, ExpectedCondition condition) {
ExpectedCondition cHandlingStale = getConditionIgnoringStaleElement(condition);
FluentWait wait = waitDriver().withTimeout(maxSecondsToWait, TimeUnit.SECONDS);
return wait.until(cHandlingStale);
}
/**
* Wraps the supplied condition so that StaleElementReferenceExceptions (and the Safari equivalent)
* are to thrown by waitUntil(), but just mean: try again.
* @param condition condition to wrap.
* @param retrun type of condition
* @return wrapped condition.
*/
public ExpectedCondition getConditionIgnoringStaleElement(final ExpectedCondition condition) {
return new ExpectedCondition() {
@Override
public T apply(WebDriver webDriver) {
try {
return condition.apply(webDriver);
} catch (StaleElementReferenceException e) {
// try again
return null;
} catch (WebDriverException e) {
String msg = e.getMessage();
if (msg != null
&& (msg.contains("Element does not exist in cache")
// Safari stale element
|| msg.contains("Error: element is not attached to the page document")
// Alternate Chrome stale element
)) {
return null;
} else {
throw e;
}
}
}
};
}
/**
* Finds element matching the By supplied.
* @param context context to find element in.
* @param by criteria.
* @return element if found, null if none could be found.
*/
public WebElement findElement(SearchContext context, By by) {
return FirstElementBy.getWebElement(by, context);
}
/**
* Trigger scrolling of window to ensure element is in visible.
* @param element element to scroll to.
*/
public void scrollTo(WebElement element) {
executeJavascript("arguments[0].scrollIntoView(true);", element);
}
/**
* Takes screenshot of current page (as .png).
* @param baseName name for file created (without extension),
* if a file already exists with the supplied name an
* '_index' will be added.
* @return absolute path of file created.
*/
public String takeScreenshot(String baseName) {
String result = null;
WebDriver d = driver();
if (!(d instanceof TakesScreenshot)) {
d = new Augmenter().augment(d);
}
if (d instanceof TakesScreenshot) {
TakesScreenshot ts = (TakesScreenshot) d;
byte[] png = ts.getScreenshotAs(OutputType.BYTES);
result = writeScreenshot(baseName, png);
}
return result;
}
/**
* Finds screenshot embedded in throwable, if any.
* @param t exception to search in.
* @return content of screenshot (if any is present), null otherwise.
*/
public byte[] findScreenshot(Throwable t) {
byte[] result = null;
if (t != null) {
if (t instanceof ScreenshotException) {
String encodedScreenshot = ((ScreenshotException)t).getBase64EncodedScreenshot();
result = Base64.getDecoder().decode(encodedScreenshot);
} else {
result = findScreenshot(t.getCause());
}
}
return result;
}
/**
* Saves screenshot (as .png).
* @param baseName name for file created (without extension),
* if a file already exists with the supplied name an
* '_index' will be added.
* @return absolute path of file created.
*/
public String writeScreenshot(String baseName, byte[] png) {
return FileUtil.saveToFile(baseName, "png", png);
}
public String getResourceNameFromLocation() {
String fileName = "pageSource";
try {
String location = driver().getCurrentUrl();
URL u = new URL(location);
String file = FilenameUtils.getName(u.getPath());
file = file.replaceAll("^(.*?)(\\.html?)?$", "$1");
if (!"".equals(file)) {
fileName = file;
}
} catch (MalformedURLException e) {
// ignore
}
return fileName;
}
/**
* @return HTML content of current page.
*/
public String getHtml() {
String html;
try {
html = (String) executeJavascript(
"var node = document.doctype;\n" +
"var docType = '';\n" +
"if (node) {\n" +
" docType = \"'; }\n" +
"var html = document.documentElement.outerHTML " +
"|| '' + document.documentElement.innerHTML + '';\n" +
"return docType + html;"
);
} catch (RuntimeException e) {
// unable to get via Javascript
try {
// this is very WebDriver implementation dependent, so we only use as fallback
html = driver().getPageSource();
} catch (Exception ex) {
ex.printStackTrace();
// throw original exception
throw e;
}
}
return html;
}
public PageSourceSaver getPageSourceSaver(String baseDir) {
return new PageSourceSaver(baseDir, this);
}
/**
* @return current window's size.
*/
public Dimension getWindowSize() {
return getWindow().getSize();
}
/**
* Sets current window's size.
* @param newWidth new width (in pixels)
* @param newHeight new height (in pixels)
*/
public void setWindowSize(int newWidth, int newHeight) {
getWindow().setSize(new Dimension(newWidth, newHeight));
}
/**
* Sets current window to maximum size.
*/
public void setWindowSizeToMaximum() {
getWindow().maximize();
}
/**
* @return current browser window.
*/
public WebDriver.Window getWindow() {
return driver().manage().window();
}
public int getCurrentTabIndex(List tabHandles) {
try {
String currentHandle = driver().getWindowHandle();
return tabHandles.indexOf(currentHandle);
} catch (NoSuchWindowException e) {
return -1;
}
}
public void goToTab(List tabHandles, int indexToGoTo) {
getTargetLocator().window(tabHandles.get(indexToGoTo));
switchToDefaultContent();
setCurrentContext(null);
}
public List getTabHandles() {
return new ArrayList(driver().getWindowHandles());
}
/**
* Activates main/top-level iframe (i.e. makes it the current frame).
*/
public void switchToDefaultContent() {
getTargetLocator().defaultContent();
if (!currentIFramePath.isEmpty()) {
setCurrentContext(null);
currentIFramePath.clear();
}
}
/**
* Activates specified child frame of current iframe.
* @param iframe frame to activate.
*/
public void switchToFrame(WebElement iframe) {
getTargetLocator().frame(iframe);
setCurrentContext(null);
currentIFramePath.add(iframe);
}
/**
* Activates parent frame of current iframe.
* Does nothing if when current frame is the main/top-level one.
*/
public void switchToParentFrame() {
if (!currentIFramePath.isEmpty()) {
// copy path since substring creates a view, not a deep copy
List newPath = currentIFramePath.subList(0, currentIFramePath.size() - 1);
newPath = new ArrayList(newPath);
// Safari and PhantomJs don't support switchTo.parentFrame, so we do this
// it works for Phantom, but is VERY slow there (other browsers are slow but ok)
switchToDefaultContent();
for (WebElement iframe : newPath) {
switchToFrame(iframe);
}
}
}
public ExpectedCondition conditionForAllFrames(ExpectedCondition nested) {
return new TryAllFramesConditionDecorator(this, nested);
}
/**
* @return current alert, if one is present, null otherwise.
*/
public Alert getAlert() {
Alert alert = null;
try {
alert = getTargetLocator().alert();
} catch (NoAlertPresentException e) {
// just leave alert null
}
return alert;
}
private WebDriver.TargetLocator getTargetLocator() {
return driver().switchTo();
}
/**
* Gets current browser's cookie with supplied name.
* @param cookieName name of cookie to return.
* @return cookie, if present, null otherwise.
*/
public Cookie getCookie(String cookieName) {
return driver().manage().getCookieNamed(cookieName);
}
/**
* @return current browser's cookies.
*/
public Set getCookies() {
return driver().manage().getCookies();
}
/**
* Deletes all of the browser's cookies (for the current domain).
*/
public void deleteAllCookies() {
driver().manage().deleteAllCookies();
}
public void setDriverFactory(DriverFactory aFactory) {
factory = aFactory;
}
/**
* @param timeoutSeconds default number of seconds to wait before throwing timeout exceptions
*/
public void setDefaultTimeoutSeconds(int timeoutSeconds) {
defaultTimeoutSeconds = timeoutSeconds;
}
/**
* @return default time for waiting (in seconds).
*/
public int getDefaultTimeoutSeconds() {
return defaultTimeoutSeconds;
}
/**
* @return return current depth of (i)frames.
*/
public int getCurrentFrameDepth() {
return currentIFramePath.size();
}
/**
* Store current frame depth in case of alert error
* @param frameDepthOnAlert frames added searching in nested frames started, this is the number of levels that
* should be removed after the alert is handled.
*/
public void storeFrameDepthOnAlertError(int frameDepthOnAlert) {
frameDepthOnLastAlertError = frameDepthOnAlert;
}
/**
* Reactivate (i)frame that was active before we encountered an alert searching in nested (i)frames.
*/
public void resetFrameDepthOnAlertError() {
int depthOnLastAlertError = getFrameDepthOnLastAlertError();
for (int i = 0; i < depthOnLastAlertError; i++) {
switchToParentFrame();
frameDepthOnLastAlertError--;
}
}
/**
* @return number of (i)frame levels that need to be removed to get back to right frame after encountering an alert
* in a nested (i)frame.
*/
public int getFrameDepthOnLastAlertError() {
return frameDepthOnLastAlertError;
}
public interface DriverFactory {
void createDriver();
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy