org.openqa.selenium.lift.HamcrestWebDriverTestCase Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of webdriver-support Show documentation
There is a newer version: 0.9.7376
/*
Copyright 2007-2009 WebDriver committers
Copyright 2007-2009 Google Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

package org.openqa.selenium.lift;

import junit.framework.TestCase;

import static org.openqa.selenium.lift.match.NumericalMatchers.exactly;
import static org.openqa.selenium.lift.match.SelectionMatcher.selection;

import org.hamcrest.Matcher;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.lift.find.Finder;

/**
 * Base class for tests using the LiFT style API to driver WebDriver.
 * @author rchatley (Robert Chatley)
 *
 */
public abstract class HamcrestWebDriverTestCase extends TestCase {

	private static final long DEFAULT_TIMEOUT = 5000;

        private WebDriver driver = createDriver();
        private TestContext context = new WebDriverTestContext(driver);

	protected abstract WebDriver createDriver();

	@Override
	protected void tearDown() throws Exception {
		context.quit();
		super.tearDown();
	}

        protected WebDriver getWebDriver() {
          return driver;
        }

        protected void clickOn(Finder finder) {
		context.clickOn(finder);
	}

	protected void assertPresenceOf(Finder finder) {
		context.assertPresenceOf(finder);
	}
	
	protected void assertPresenceOf(Matcher cardinalityConstraint, Finder finder) {
		context.assertPresenceOf(cardinalityConstraint, finder);
	}
	
	protected void waitFor(Finder finder) {
		waitFor(finder, DEFAULT_TIMEOUT);
	}
	
	protected void waitFor(Finder finder, long timeout) {
		context.waitFor(finder, timeout);
	}

	/**
	 * Cause the browser to navigate to the given URL
	 * @param url
	 */
	protected void goTo(String url) {
		  context.goTo(url);
	}
	
	/**
	 * Type characters into an element of the page, typically an input field
	 * @param text - characters to type
	 * @param inputFinder - specification for the page element
	 */
	protected void type(String text, Finder inputFinder) {
		context.type(text, inputFinder);
	}

	/**
	 * Syntactic sugar to use with {@link HamcrestWebDriverTestCase#type(String, Finder)},
	 * e.g. type("cheese", into(textbox()));
	 * The into() method simply returns its argument.
	 */
	protected Finder into(Finder input) {
		return input;
	}
	
	/**
	 * replace the default {@link TestContext}
	 */
	void setContext(TestContext context) {
		this.context = context;
	}

      /**
       * Returns the current page source
       */
      public String getPageSource() {
        return getWebDriver().getPageSource();
      }

      /**
       * Returns the current page title
       */
      public String getTitle() {
        return getWebDriver().getTitle();
      }

      /**
       * Returns the current URL
       */
      public String getCurrentUrl() {
        return getWebDriver().getCurrentUrl();
      }

      protected void assertSelected(Finder finder) {
		assertPresenceOf(finder.with(selection()));
	}
	
	protected void assertNotSelected(Finder finder) {
		assertPresenceOf(exactly(0), finder.with(selection()));
	}
	
}