Java tutorial
/******************************************************************************* * QMetry Automation Framework provides a powerful and versatile platform to author * Automated Test Cases in Behavior Driven, Keyword Driven or Code Driven approach * * Copyright 2016 Infostretch Corporation * * This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version. * * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. * * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT * OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE * * You should have received a copy of the GNU General Public License along with this program in the name of LICENSE.txt in the root folder of the distribution. If not, see https://opensource.org/licenses/gpl-3.0.html * * See the NOTICE.TXT file in root folder of this source files distribution * for additional information regarding copyright ownership and licenses * of other open source software / files used by QMetry Automation Framework. * * For any inquiry or need additional information, please contact support-qaf@infostretch.com *******************************************************************************/ package com.qmetry.qaf.automation.ui.util; import static com.qmetry.qaf.automation.core.ConfigurationManager.getBundle; import java.util.Collection; import java.util.concurrent.TimeUnit; import org.openqa.selenium.NoSuchElementException; import org.openqa.selenium.StaleElementReferenceException; import org.openqa.selenium.support.ui.Clock; import org.openqa.selenium.support.ui.FluentWait; import org.openqa.selenium.support.ui.Sleeper; import org.openqa.selenium.support.ui.SystemClock; import com.google.common.collect.ImmutableList; import com.qmetry.qaf.automation.core.ConfigurationManager; import com.qmetry.qaf.automation.keys.ApplicationProperties; import com.qmetry.qaf.automation.ui.webdriver.QAFExtendedWebElement; /** * A specialization of {@link FluentWait} that uses WebDriver instances. */ public class QAFWebElementWait extends FluentWait<QAFExtendedWebElement> { /** * Wait will ignore instances of NotFoundException that are encountered * (thrown) by default in the 'until' condition, and immediately propagate * all others. You can add more to the ignore list by calling * ignoring(exceptions to add). * * @param element * The WebElement instance to pass to the expected conditions * @param timeOutInMiliSeconds * The timeout in seconds when an expectation is called * @see QAFWebElementWait#ignoring(Class[]) equals */ public QAFWebElementWait(QAFExtendedWebElement element, long timeOutInMiliSeconds) { this(element, new SystemClock(), Sleeper.SYSTEM_SLEEPER, timeOutInMiliSeconds, getDefaultInterval()); } /** * Wait will ignore instances of NotFoundException that are encountered * (thrown) by default in the 'until' condition, and immediately propagate * all others. You can add more to the ignore list by calling * ignoring(exceptions to add). * * @param element * The WebElement instance to pass to the expected conditions * @param timeOutInMiliSeconds * The timeout in seconds when an expectation is called * @param sleepInMillis * The duration in milliseconds to sleep between polls. * @see QAFWebElementWait#ignoring(Class[]) equals */ public QAFWebElementWait(QAFExtendedWebElement element, long timeOutInMiliSeconds, long sleepInMillis) { this(element, new SystemClock(), Sleeper.SYSTEM_SLEEPER, timeOutInMiliSeconds, sleepInMillis); } public QAFWebElementWait(QAFExtendedWebElement QAFExtendedWebElement, long... timeout) { this(QAFExtendedWebElement, getTimeout(timeout), getInterval(timeout)); } /** * @param element * The WebElement instance to pass to the expected conditions * @param clock * The clock to use when measuring the timeout * @param sleeper * Object used to make the current thread go to sleep. * @param timeOutInSeconds * The timeout in seconds when an expectation is * @param sleepTimeOut * The timeout used whilst sleeping. Defaults to 500ms called. */ @SuppressWarnings("unchecked") protected QAFWebElementWait(QAFExtendedWebElement element, Clock clock, Sleeper sleeper, long timeOutInMiliSeconds, long sleepTimeOut) { super(element, clock, sleeper); withTimeout(timeOutInMiliSeconds, TimeUnit.MILLISECONDS); pollingEvery(sleepTimeOut, TimeUnit.MILLISECONDS); ignore(NoSuchElementException.class, StaleElementReferenceException.class); } /** * @see #ignoreAll(Collection) */ @SuppressWarnings("unchecked") public QAFWebElementWait ignore(Class<? extends RuntimeException>... exceptionType) { return (QAFWebElementWait) this .ignoreAll(ImmutableList.<Class<? extends RuntimeException>>copyOf(exceptionType)); } private static long getTimeout(long... timeout) { if ((null == timeout) || (timeout.length < 1) || (timeout[0] <= 0)) { return getDefaultTimeout(); } return timeout[0]; } private static long getInterval(long... timeout) { if ((null == timeout) || (timeout.length < 2) || (timeout[1] <= 0)) { return getDefaultInterval(); } return timeout[1]; } private static long getDefaultTimeout() { return ConfigurationManager.getBundle().getLong("selenium.explicit.wait.timeout", ApplicationProperties.SELENIUM_WAIT_TIMEOUT.getIntVal(5000)); } private static long getDefaultInterval() { return getBundle().getLong("selenium.explicit.wait.interval", getBundle().getLong("selenium.wait.interval", 1000)); } }