com.crawljax.core.configuration

Class CrawlRules.CrawlRulesBuilder

java.lang.Object

com.crawljax.core.configuration.CrawlRules.CrawlRulesBuilder

Enclosing class:

CrawlRules

public static final class CrawlRules.CrawlRulesBuilder
extends Object

Method Summary

Methods

Modifier and Type	Method and Description
PreCrawlConfiguration.PreCrawlConfigurationBuilder	addCrawlCondition(CrawlCondition... condition)
PreCrawlConfiguration.PreCrawlConfigurationBuilder	addCrawlCondition(String description, Condition crawlCondition)
CrawlRules.CrawlRulesBuilder	addEventType(Eventable.EventType... eventTypes)
CrawlRules.CrawlRulesBuilder	addInvariant(Invariant... invariant)
CrawlRules.CrawlRulesBuilder	addInvariant(String description, Condition condition)
CrawlRules.CrawlRulesBuilder	addOracleComparator(OracleComparator... oracle)
PreCrawlConfiguration.PreCrawlConfigurationBuilder	addWaitCondition(WaitCondition... condition)
void	click(String... tagNames)
CrawlElement	click(String tagName)
void	clickDefaultElements()
CrawlRules.CrawlRulesBuilder	clickOnce(boolean once)
CrawlRules.CrawlRulesBuilder	crawlFrames(boolean frames)
CrawlRules.CrawlRulesBuilder	crawlHiddenAnchors(boolean anchors) Set Crawljax to click hidden anchors or not.
CrawlElement	dontClick(String tagName)
CrawlActionsBuilder.ExcludeByParentBuilder	dontClickChildrenOf(String tagname)
CrawlRules.CrawlRulesBuilder	dontCrawlFrame(String frame)
PreCrawlConfiguration.PreCrawlConfigurationBuilder	filterAttributeNames(String names)
CrawlRules.CrawlRulesBuilder	insertRandomDataInInputForms(boolean insertRandomData)
CrawlRules.CrawlRulesBuilder	setInputSpec(InputSpecification spec)
CrawlRules.CrawlRulesBuilder	testInvariantsWhileCrawling(boolean test)
CrawlRules.CrawlRulesBuilder	waitAfterEvent(long time, TimeUnit unit)
CrawlRules.CrawlRulesBuilder	waitAfterReloadUrl(long time, TimeUnit unit)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

insertRandomDataInInputForms

public CrawlRules.CrawlRulesBuilder insertRandomDataInInputForms(boolean insertRandomData)

dontCrawlFrame

public CrawlRules.CrawlRulesBuilder dontCrawlFrame(String frame)

Parameters:

frame - A frame that should be excluded from the DOM, before doing any other operations.

addEventType

public CrawlRules.CrawlRulesBuilder addEventType(Eventable.EventType... eventTypes)

Parameters:

eventTypes - Add an Eventable.EventType that should be triggered by Crawljax. If none are defined, it will only use Eventable.EventType.click

addInvariant

public CrawlRules.CrawlRulesBuilder addInvariant(Invariant... invariant)

addInvariant

public CrawlRules.CrawlRulesBuilder addInvariant(String description,
                                        Condition condition)

Parameters:

description - The invariants description.

condition - The condition for the invariant.

See Also:

Invariant.Invariant(String, Condition)

addOracleComparator

public CrawlRules.CrawlRulesBuilder addOracleComparator(OracleComparator... oracle)

addWaitCondition

public PreCrawlConfiguration.PreCrawlConfigurationBuilder addWaitCondition(WaitCondition... condition)

Parameters:

condition - add a WaitCondition.

addCrawlCondition

public PreCrawlConfiguration.PreCrawlConfigurationBuilder addCrawlCondition(CrawlCondition... condition)

Parameters:

condition - add a CrawlCondition

addCrawlCondition

public PreCrawlConfiguration.PreCrawlConfigurationBuilder addCrawlCondition(String description,
                                                                   Condition crawlCondition)

See Also:

CrawlCondition.CrawlCondition(String, Condition)

filterAttributeNames

public PreCrawlConfiguration.PreCrawlConfigurationBuilder filterAttributeNames(String names)

Parameters:

names - add an attribute name you want to filter before parsing the dom.

setInputSpec

public CrawlRules.CrawlRulesBuilder setInputSpec(InputSpecification spec)

testInvariantsWhileCrawling

public CrawlRules.CrawlRulesBuilder testInvariantsWhileCrawling(boolean test)

Parameters:

test - Test the invariants while crawling or not. Default is true.

clickOnce

public CrawlRules.CrawlRulesBuilder clickOnce(boolean once)

Parameters:

once - Set the crawler to interact with any element only once. Default is true

crawlFrames

public CrawlRules.CrawlRulesBuilder crawlFrames(boolean frames)

Parameters:

frames - Crawl frames in a page. Default is true.

waitAfterReloadUrl

public CrawlRules.CrawlRulesBuilder waitAfterReloadUrl(long time,
                                              TimeUnit unit)

Parameters:

time - The time to wait after a URL is loaded. Default is 500 milliseconds.

unit - The time unit.

waitAfterEvent

public CrawlRules.CrawlRulesBuilder waitAfterEvent(long time,
                                          TimeUnit unit)

Parameters:

time - The time to wait after an event is fired. Default is 500 milliseconds.

unit - The time unit.

crawlHiddenAnchors

public CrawlRules.CrawlRulesBuilder crawlHiddenAnchors(boolean anchors)

Set Crawljax to click hidden anchors or not. Default is false.

Pro:

The benefit of clicking hidden anchors is that Crawljax isn't capable of clicking elements that are hidden for example because you have to hover another element first. This happens in most fold-out menus for example. Enabling this function allows Crawljax to find more states that are hidden this way.

Con:

If a anchor tag is never visible in the browser in any way, Crawljax will crawl it anyway. This makes the Crawl inconsistent with what the user experiences.

click

public CrawlElement click(String tagName)

Parameters:

tagName -

See Also:

CrawlActionsBuilder.click(java.lang.String)

click

public void click(String... tagNames)

Parameters:

tagNames -

See Also:

CrawlActionsBuilder.click(java.lang.String[])

clickDefaultElements

public void clickDefaultElements()

See Also:

CrawlActionsBuilder.clickDefaultElements()

dontClick

public CrawlElement dontClick(String tagName)

See Also:

CrawlActionsBuilder.dontClick(java.lang.String)

dontClickChildrenOf

public CrawlActionsBuilder.ExcludeByParentBuilder dontClickChildrenOf(String tagname)

Parameters:

tagname -

See Also:

CrawlActionsBuilder.dontClickChildrenOf(java.lang.String)