public class

CssLocator

extends AbstractLocator
implements Locator

java.lang.Object
↳	com.atlassian.jira.functest.framework.locator.AbstractLocator
	↳	com.atlassian.jira.functest.framework.locator.CssLocator

Class Overview

A CSS locator that uses JSOUP for the supported CSS selectors

At present it is a subset of jQuery CSS support so be a bit careful with the more tricky selectors

Summary

[Expand]

Inherited Fields

From class com.atlassian.jira.functest.framework.locator.AbstractLocator

Public Constructors
	CssLocator(WebTester tester, String cssSelector) Locates org.w3c.dom.Node's using the specified net.sourceforge.jwebunit.WebTester
	CssLocator(Node startNode, String cssSelector) Locates org.w3c.dom.Node's starting from the specified org.w3c.dom.Node The start node can ONLY be a node given out previous by another CssLocator.

Public Methods
Node[]	getNodes() A `Locator` may return 0 nodes, 1 node or multiple nodes.
String	toString()

Protected Methods
Node	betterNode(Node node)

[Expand]

Inherited Methods

From class com.atlassian.jira.functest.framework.locator.AbstractLocator

Iterable<LocatorEntry>	allMatches() Get all matches of this locator as an iterable collection of locator entries
Node	betterNode(Node node)
static boolean	containsNode(Locator locator, Node node)
boolean	exists() Return true at least one element will be matches by this locator.
Document	getDOM(WebTester tester) Returns the DOM Document from the WebTester.
String	getHTML() Returns the HTML that a called to `getNodes()` represent, including the top level nodes themselves.
String	getHTML(Node node) Returns the HTML of the specified node.
Node	getNode() This convenience methods is the the equivalent of getNodes()[0] except when the number of nodes found is zero, in which case it should return null.
String	getNodeTextImpl(Node node, AbstractLocator.LocatorTextOperation textOperation) Called to get the test or HTML of an org.w3c.dom.Node
String	getNodesTextImpl(Node[] nodes, AbstractLocator.LocatorTextOperation textOperation) Called to get all the text or HTML of a set of org.w3c.dom.Node's.
String	getRawText(Node node) Returns the raw text of the specified Node.
String	getRawText() Returns the combined raw text of the Nodes that `getNodes()` would return or empty string.
String	getText(Node node) Returns the collapsed text of the specified Node.
String	getText() Returns the combined collapsed text of the Nodes that `getNodes()` would return or empty string.
WebResponse	getWebResponse(WebTester tester)
boolean	hasNodes() This will return true if the Locator found some org.w3c.dom.Node's.
Iterator<LocatorEntry>	iterator() This will return a `Iterator` that returns `LocatorEntry` objects
synchronized String	toStringImpl(String concreteImplementationName)

From class java.lang.Object

From interface com.atlassian.jira.functest.framework.locator.Locator

Iterable<LocatorEntry>	allMatches() Get all matches of this locator as an iterable collection of locator entries
boolean	exists() Return true at least one element will be matches by this locator.
String	getHTML() Returns the HTML that a called to `getNodes()` represent, including the top level nodes themselves.
String	getHTML(Node node) Returns the HTML of the specified node.
Node	getNode() This convenience methods is the the equivalent of getNodes()[0] except when the number of nodes found is zero, in which case it should return null.
Node[]	getNodes() A `Locator` may return 0 nodes, 1 node or multiple nodes.
String	getRawText(Node node) Returns the raw text of the specified Node.
String	getRawText() Returns the combined raw text of the Nodes that `getNodes()` would return or empty string.
String	getText(Node node) Returns the collapsed text of the specified Node.
String	getText() Returns the combined collapsed text of the Nodes that `getNodes()` would return or empty string.
boolean	hasNodes() This will return true if the Locator found some org.w3c.dom.Node's.
Iterator<LocatorEntry>	iterator() This will return a `Iterator` that returns `LocatorEntry` objects
String	toString() A meaningful "debugging" representation of this Locator to help when test fail.

Public Constructors

public CssLocator (WebTester tester, String cssSelector)

Locates org.w3c.dom.Node's using the specified net.sourceforge.jwebunit.WebTester

Parameters

tester	the WebTester in play
cssSelector	the CSS selector string

public CssLocator (Node startNode, String cssSelector)

Locates org.w3c.dom.Node's starting from the specified org.w3c.dom.Node

The start node can ONLY be a node given out previous by another CssLocator. It will throw and IllegalArgumentException if you give it any other type of Node.

Parameters

startNode	the org.w3c.dom.Node to start at.
cssSelector	the CSS selector string

Public Methods

public Node[] getNodes ()

A Locator may return 0 nodes, 1 node or multiple nodes.

Returns

a non null array of Nodes that match, or a zero sized array of no matches are made

Interfaces

Classes

CssLocator

Class Overview

Summary

Public Constructors

public CssLocator (WebTester tester, String cssSelector)

Parameters

public CssLocator (Node startNode, String cssSelector)

Parameters

Public Methods

public Node[] getNodes ()

Returns

public String toString ()

Protected Methods

protected Node betterNode (Node node)