Remove WebDriver (62e55fc7) · Commits · e / os / android_frameworks_base

core/java/android/webkit/webdriver/By.java

deleted100644 → 0

+0 −252

Original line number	Original line	Diff line number	Diff line
	/*
	* Copyright (C) 2011 The Android Open Source Project
	*
	* 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 android.webkit.webdriver;

	import java.util.List;

	/**
	* Mechanism to locate elements within the DOM of the page.
	* @hide
	*/
	public abstract class By {
	public abstract WebElement findElement(WebElement element);
	public abstract List<WebElement> findElements(WebElement element);

	/**
	* Locates an element by its HTML id attribute.
	*
	* @param id The HTML id attribute to look for.
	* @return A By instance that locates elements by their HTML id attributes.
	*/
	public static By id(final String id) {
	throwIfNull(id);
	return new By() {
	@Override
	public WebElement findElement(WebElement element) {
	return element.findElementById(id);
	}

	@Override
	public List<WebElement> findElements(WebElement element) {
	return element.findElementsById(id); // Yes, it happens a lot.
	}

	@Override
	public String toString() {
	return "By.id: " + id;
	}
	};
	}

	/**
	* Locates an element by the matching the exact text on the HTML link.
	*
	* @param linkText The exact text to match against.
	* @return A By instance that locates elements by the text displayed by
	* the link.
	*/
	public static By linkText(final String linkText) {
	throwIfNull(linkText);
	return new By() {
	@Override
	public WebElement findElement(WebElement element) {
	return element.findElementByLinkText(linkText);
	}

	@Override
	public List<WebElement> findElements(WebElement element) {
	return element.findElementsByLinkText(linkText);
	}

	@Override
	public String toString() {
	return "By.linkText: " + linkText;
	}
	};
	}

	/**
	* Locates an element by matching partial part of the text displayed by an
	* HTML link.
	*
	* @param linkText The text that should be contained by the text displayed
	* on the link.
	* @return A By instance that locates elements that contain the given link
	* text.
	*/
	public static By partialLinkText(final String linkText) {
	throwIfNull(linkText);
	return new By() {
	@Override
	public WebElement findElement(WebElement element) {
	return element.findElementByPartialLinkText(linkText);
	}

	@Override
	public List<WebElement> findElements(WebElement element) {
	return element.findElementsByPartialLinkText(linkText);
	}

	@Override
	public String toString() {
	return "By.partialLinkText: " + linkText;
	}
	};
	}

	/**
	* Locates an element by matching its HTML name attribute.
	*
	* @param name The value of the HTML name attribute.
	* @return A By instance that locates elements by the HTML name attribute.
	*/
	public static By name(final String name) {
	throwIfNull(name);
	return new By() {
	@Override
	public WebElement findElement(WebElement element) {
	return element.findElementByName(name);
	}

	@Override
	public List<WebElement> findElements(WebElement element) {
	return element.findElementsByName(name);
	}

	@Override
	public String toString() {
	return "By.name: " + name;
	}
	};
	}

	/**
	* Locates an element by matching its class name.
	* @param className The class name
	* @return A By instance that locates elements by their class name attribute.
	*/
	public static By className(final String className) {
	throwIfNull(className);
	return new By() {
	@Override
	public WebElement findElement(WebElement element) {
	return element.findElementByClassName(className);
	}

	@Override
	public List<WebElement> findElements(WebElement element) {
	return element.findElementsByClassName(className);
	}

	@Override
	public String toString() {
	return "By.className: " + className;
	}
	};
	}

	/**
	* Locates an element by matching its css property.
	*
	* @param css The css property.
	* @return A By instance that locates elements by their css property.
	*/
	public static By css(final String css) {
	throwIfNull(css);
	return new By() {
	@Override
	public WebElement findElement(WebElement element) {
	return element.findElementByCss(css);
	}

	@Override
	public List<WebElement> findElements(WebElement element) {
	return element.findElementsByCss(css);
	}

	@Override
	public String toString() {
	return "By.css: " + css;
	}
	};
	}

	/**
	* Locates an element by matching its HTML tag name.
	*
	* @param tagName The HTML tag name to look for.
	* @return A By instance that locates elements using the name of the
	* HTML tag.
	*/
	public static By tagName(final String tagName) {
	throwIfNull(tagName);
	return new By() {
	@Override
	public WebElement findElement(WebElement element) {
	return element.findElementByTagName(tagName);
	}

	@Override
	public List<WebElement> findElements(WebElement element) {
	return element.findElementsByTagName(tagName);
	}

	@Override
	public String toString() {
	return "By.tagName: " + tagName;
	}
	};
	}

	/**
	* Locates an element using an XPath expression.
	*
	* <p>When using XPath, be aware that this follows standard conventions: a
	* search prefixed with "//" will search the entire document, not just the
	* children of the current node. Use ".//" to limit your search to the
	* children of this {@link android.webkit.webdriver.WebElement}.
	*
	* @param xpath The XPath expression to use.
	* @return A By instance that locates elements using the given XPath.
	*/
	public static By xpath(final String xpath) {
	throwIfNull(xpath);
	return new By() {
	@Override
	public WebElement findElement(WebElement element) {
	return element.findElementByXPath(xpath);
	}

	@Override
	public List<WebElement> findElements(WebElement element) {
	return element.findElementsByXPath(xpath);
	}

	@Override
	public String toString() {
	return "By.xpath: " + xpath;
	}
	};
	}

	private static void throwIfNull(String argument) {
	if (argument == null) {
	throw new IllegalArgumentException(
	"Cannot find elements with null locator.");
	}
	}
	}

core/java/android/webkit/webdriver/WebDriver.java

deleted100644 → 0

+0 −843

File deleted.

Preview size limit exceeded, changes collapsed.

core/java/android/webkit/webdriver/WebDriverException.java

deleted100644 → 0

+0 −38

Original line number	Original line	Diff line number	Diff line
	/*
	* Copyright (C) 2011 The Android Open Source Project
	*
	* 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 android.webkit.webdriver;

	/**
	* @hide
	*/
	public class WebDriverException extends RuntimeException {
	public WebDriverException() {
	super();
	}

	public WebDriverException(String reason) {
	super(reason);
	}

	public WebDriverException(String reason, Throwable cause) {
	super(reason, cause);
	}

	public WebDriverException(Throwable cause) {
	super(cause);
	}
	}

core/java/android/webkit/webdriver/WebElement.java

deleted100644 → 0

+0 −388

Original line number	Original line	Diff line number	Diff line
	/*
	* Copyright (C) 2011 The Android Open Source Project
	*
	* 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 android.webkit.webdriver;

	import android.graphics.Point;
	import android.view.KeyEvent;

	import com.android.internal.R;

	import java.util.List;
	import java.util.Map;

	/**
	* Represents an HTML element. Typically most interactions with a web page
	* will be performed through this class.
	*
	* @hide
	*/
	public class WebElement {
	private final String mId;
	private final WebDriver mDriver;

	private static final String LOCATOR_ID = "id";
	private static final String LOCATOR_LINK_TEXT = "linkText";
	private static final String LOCATOR_PARTIAL_LINK_TEXT = "partialLinkText";
	private static final String LOCATOR_NAME = "name";
	private static final String LOCATOR_CLASS_NAME = "className";
	private static final String LOCATOR_CSS = "css";
	private static final String LOCATOR_TAG_NAME = "tagName";
	private static final String LOCATOR_XPATH = "xpath";

	/**
	* Package constructor to prevent clients from creating a new WebElement
	* instance.
	*
	* <p> A WebElement represents an HTML element on the page.
	* The corresponding HTML element is stored in a JS cache in the page
	* that can be accessed through JavaScript using "bot.inject.cache".
	*
	* @param driver The WebDriver instance to use.
	* @param id The index of the HTML element in the JavaSctipt cache.
	* document.documentElement object.
	*/
	/* package */ WebElement(final WebDriver driver, final String id) {
	this.mId = id;
	this.mDriver = driver;
	}

	/**
	* Finds the first {@link android.webkit.webdriver.WebElement} using the
	* given method.
	*
	* @param by The locating mechanism to use.
	* @return The first matching element on the current context.
	*/
	public WebElement findElement(final By by) {
	return by.findElement(this);
	}

	/**
	* Finds all {@link android.webkit.webdriver.WebElement} within the page
	* using the given method.
	*
	* @param by The locating mechanism to use.
	* @return A list of all {@link android.webkit.webdriver.WebElement} found,
	* or an empty list if nothing matches.
	*/
	public List<WebElement> findElements(final By by) {
	return by.findElements(this);
	}

	/**
	* Gets the visisble (i.e. not hidden by CSS) innerText of this element,
	* inlcuding sub-elements.
	*
	* @return the innerText of this element.
	* @throws {@link android.webkit.webdriver.WebElementStaleException} if this
	* element is stale, i.e. not on the current DOM.
	*/
	public String getText() {
	String getText = mDriver.getResourceAsString(R.raw.get_text_android);
	return (String) executeAtom(getText, this);
	}

	/**
	* Gets the value of an HTML attribute for this element or the value of the
	* property with the same name if the attribute is not present. If neither
	* is set, null is returned.
	*
	* @param attribute the HTML attribute.
	* @return the value of that attribute or the value of the property with the
	* same name if the attribute is not set, or null if neither are set. For
	* boolean attribute values this will return the string "true" or "false".
	*/
	public String getAttribute(String attribute) {
	String getAttribute = mDriver.getResourceAsString(
	R.raw.get_attribute_value_android);
	return (String) executeAtom(getAttribute, this, attribute);
	}

	/**
	* @return the tag name of this element.
	*/
	public String getTagName() {
	return (String) mDriver.executeScript("return arguments[0].tagName;",
	this);
	}

	/**
	* @return true if this element is enabled, false otherwise.
	*/
	public boolean isEnabled() {
	String isEnabled = mDriver.getResourceAsString(
	R.raw.is_enabled_android);
	return (Boolean) executeAtom(isEnabled, this);
	}

	/**
	* Determines whether this element is selected or not. This applies to input
	* elements such as checkboxes, options in a select, and radio buttons.
	*
	* @return True if this element is selected, false otherwise.
	*/
	public boolean isSelected() {
	String isSelected = mDriver.getResourceAsString(
	R.raw.is_selected_android);
	return (Boolean) executeAtom(isSelected, this);
	}

	/**
	* Selects an element on the page. This works for selecting checkboxes,
	* options in a select, and radio buttons.
	*/
	public void setSelected() {
	String setSelected = mDriver.getResourceAsString(
	R.raw.set_selected_android);
	executeAtom(setSelected, this);
	}

	/**
	* This toggles the checkboxe state from selected to not selected, or
	* from not selected to selected.
	*
	* @return True if the toggled element is selected, false otherwise.
	*/
	public boolean toggle() {
	String toggle = mDriver.getResourceAsString(R.raw.toggle_android);
	return (Boolean) executeAtom(toggle, this);
	}

	/**
	* Sends the KeyEvents for the given sequence of characters to the
	* WebElement to simulate typing. The KeyEvents are generated using the
	* device's {@link android.view.KeyCharacterMap.VIRTUAL_KEYBOARD}.
	*
	* @param keys The keys to send to this WebElement
	*/
	public void sendKeys(CharSequence... keys) {
	if (keys == null \|\| keys.length == 0) {
	return;
	}
	click();
	mDriver.moveCursorToRightMostPosition(getAttribute("value"));
	mDriver.sendKeys(keys);
	}

	/**
	* Use this to send one of the key code constants defined in
	* {@link android.view.KeyEvent}
	*
	* @param keys
	*/
	public void sendKeyCodes(int... keys) {
	if (keys == null \|\| keys.length == 0) {
	return;
	}
	click();
	mDriver.moveCursorToRightMostPosition(getAttribute("value"));
	mDriver.sendKeyCodes(keys);
	}

	/**
	* Sends a touch event to the center coordinates of this WebElement.
	*/
	public void click() {
	Point topLeft = getLocation();
	Point size = getSize();
	int jsX = topLeft.x + size.x/2;
	int jsY = topLeft.y + size.y/2;
	Point center = new Point(jsX, jsY);
	mDriver.sendTouchScreen(center);
	}

	/**
	* Submits the form containing this WebElement.
	*/
	public void submit() {
	mDriver.resetPageLoadState();
	String submit = mDriver.getResourceAsString(R.raw.submit_android);
	executeAtom(submit, this);
	mDriver.waitForPageLoadIfNeeded();
	}

	/**
	* Clears the text value if this is a text entry element. Does nothing
	* otherwise.
	*/
	public void clear() {
	String value = getAttribute("value");
	if (value == null \|\| value.equals("")) {
	return;
	}
	int length = value.length();
	int[] keys = new int[length];
	for (int i = 0; i < length; i++) {
	keys[i] = KeyEvent.KEYCODE_DEL;
	}
	sendKeyCodes(keys);
	}

	/**
	* @return the value of the given CSS property if found, null otherwise.
	*/
	public String getCssValue(String cssProperty) {
	String getCssProp = mDriver.getResourceAsString(
	R.raw.get_value_of_css_property_android);
	return (String) executeAtom(getCssProp, this, cssProperty);
	}

	/**
	* Gets the width and height of the rendered element.
	*
	* @return a {@link android.graphics.Point}, where Point.x represents the
	* width, and Point.y represents the height of the element.
	*/
	public Point getSize() {
	String getSize = mDriver.getResourceAsString(R.raw.get_size_android);
	Map<String, Long> map = (Map<String, Long>) executeAtom(getSize, this);
	return new Point(map.get("width").intValue(),
	map.get("height").intValue());
	}

	/**
	* Gets the location of the top left corner of this element on the screen.
	* If the element is not visisble, this will scroll to get the element into
	* the visisble screen.
	*
	* @return a {@link android.graphics.Point} containing the x and y
	* coordinates of the top left corner of this element.
	*/
	public Point getLocation() {
	String getLocation = mDriver.getResourceAsString(
	R.raw.get_top_left_coordinates_android);
	Map<String,Long> map = (Map<String, Long>) executeAtom(getLocation,
	this);
	return new Point(map.get("x").intValue(), map.get("y").intValue());
	}

	/**
	* @return True if the WebElement is displayed on the screen,
	* false otherwise.
	*/
	public boolean isDisplayed() {
	String isDisplayed = mDriver.getResourceAsString(
	R.raw.is_displayed_android);
	return (Boolean) executeAtom(isDisplayed, this);
	}

	/package/ String getId() {
	return mId;
	}

	/* package */ WebElement findElementById(final String locator) {
	return findElement(LOCATOR_ID, locator);
	}

	/* package */ WebElement findElementByLinkText(final String linkText) {
	return findElement(LOCATOR_LINK_TEXT, linkText);
	}

	/* package */ WebElement findElementByPartialLinkText(
	final String linkText) {
	return findElement(LOCATOR_PARTIAL_LINK_TEXT, linkText);
	}

	/* package */ WebElement findElementByName(final String name) {
	return findElement(LOCATOR_NAME, name);
	}

	/* package */ WebElement findElementByClassName(final String className) {
	return findElement(LOCATOR_CLASS_NAME, className);
	}

	/* package */ WebElement findElementByCss(final String css) {
	return findElement(LOCATOR_CSS, css);
	}

	/* package */ WebElement findElementByTagName(final String tagName) {
	return findElement(LOCATOR_TAG_NAME, tagName);
	}

	/* package */ WebElement findElementByXPath(final String xpath) {
	return findElement(LOCATOR_XPATH, xpath);
	}

	/* package */ List<WebElement> findElementsById(final String locator) {
	return findElements(LOCATOR_ID, locator);
	}

	/* package */ List<WebElement> findElementsByLinkText(final String linkText) {
	return findElements(LOCATOR_LINK_TEXT, linkText);
	}

	/* package */ List<WebElement> findElementsByPartialLinkText(
	final String linkText) {
	return findElements(LOCATOR_PARTIAL_LINK_TEXT, linkText);
	}

	/* package */ List<WebElement> findElementsByName(final String name) {
	return findElements(LOCATOR_NAME, name);
	}

	/* package */ List<WebElement> findElementsByClassName(final String className) {
	return findElements(LOCATOR_CLASS_NAME, className);
	}

	/* package */ List<WebElement> findElementsByCss(final String css) {
	return findElements(LOCATOR_CSS, css);
	}

	/* package */ List<WebElement> findElementsByTagName(final String tagName) {
	return findElements(LOCATOR_TAG_NAME, tagName);
	}

	/* package */ List<WebElement> findElementsByXPath(final String xpath) {
	return findElements(LOCATOR_XPATH, xpath);
	}

	private Object executeAtom(final String atom, final Object... args) {
	String scriptArgs = mDriver.convertToJsArgs(args);
	return mDriver.executeRawJavascript("(" +
	atom + ")(" + scriptArgs + ")");
	}

	private List<WebElement> findElements(String strategy, String locator) {
	String findElements = mDriver.getResourceAsString(
	R.raw.find_elements_android);
	if (mId.equals("")) {
	return (List<WebElement>) executeAtom(findElements,
	strategy, locator);
	} else {
	return (List<WebElement>) executeAtom(findElements,
	strategy, locator, this);
	}
	}

	private WebElement findElement(String strategy, String locator) {
	String findElement = mDriver.getResourceAsString(
	R.raw.find_element_android);
	WebElement el;
	if (mId.equals("")) {
	el = (WebElement) executeAtom(findElement,
	strategy, locator);
	} else {
	el = (WebElement) executeAtom(findElement,
	strategy, locator, this);
	}
	if (el == null) {
	throw new WebElementNotFoundException("Could not find element "
	+ "with " + strategy + ": " + locator);
	}
	return el;
	}
	}

core/java/android/webkit/webdriver/WebElementNotFoundException.java

deleted100644 → 0

+0 −41

Original line number	Original line	Diff line number	Diff line
	/*
	* Copyright (C) 2011 The Android Open Source Project
	*
	* 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 android.webkit.webdriver;

	/**
	* Thrown when a {@link android.webkit.webdriver.WebElement} is not found in the
	* DOM of the page.
	* @hide
	*/
	public class WebElementNotFoundException extends RuntimeException {

	public WebElementNotFoundException() {
	super();
	}

	public WebElementNotFoundException(String reason) {
	super(reason);
	}

	public WebElementNotFoundException(String reason, Throwable cause) {
	super(reason, cause);
	}

	public WebElementNotFoundException(Throwable cause) {
	super(cause);
	}
	}