org.nuxeo.functionaltests

Class AbstractTest

java.lang.Object

org.nuxeo.functionaltests.AbstractTest

Direct Known Subclasses:

ShibbolethTest

public abstract class AbstractTest
extends Object

Base functions for all pages.

Field Summary

Fields

Modifier and Type	Field and Description
static int	AJAX_SHORT_TIMEOUT_SECONDS
static int	AJAX_TIMEOUT_SECONDS
static String	CHROME_DRIVER_DEFAULT_EXECUTABLE_NAME Deprecated. since 8.3
static String	CHROME_DRIVER_DEFAULT_PATH_LINUX Deprecated. since 8.3
static String	CHROME_DRIVER_DEFAULT_PATH_MAC Deprecated. since 8.3
static String	CHROME_DRIVER_DEFAULT_PATH_WINVISTA Deprecated. since 8.3
static String	CHROME_DRIVER_DEFAULT_PATH_WINXP Deprecated. since 8.3
static String	CHROME_DRIVER_WINDOWS_EXECUTABLE_NAME Deprecated. since 8.3
static org.openqa.selenium.remote.RemoteWebDriver	driver
protected JavaScriptErrorCollector.JavaScriptErrorIgnoreRule[]	ignores
static int	IMPLICIT_WAIT_MILLISECONDS Driver implicit wait in milliseconds.
static int	LOAD_SHORT_TIMEOUT_SECONDS
static int	LOAD_TIMEOUT_SECONDS
static String	NUXEO_URL
static int	PAGE_LOAD_TIME_OUT_SECONDS Page Load timeout in seconds.
static int	POLLING_FREQUENCY_MILLISECONDS Polling frequency in milliseconds.
static int	POLLING_FREQUENCY_SECONDS
protected static ProxyManager	proxyManager
static String	SYSPROP_CHROME_DRIVER_PATH Deprecated. since 8.3
static String	TEST_PASSWORD
static String	TEST_USERNAME
org.junit.rules.MethodRule	watchman Logger method to follow what's being run on server logs and take a screenshot of the last page in case of failure

Constructor Summary

Constructors

Constructor and Description
AbstractTest()

Method Summary

Modifier and Type	Method and Description
void	addAfterTestIgnores(JavaScriptErrorCollector.JavaScriptErrorIgnoreRule... ignores)
protected static String	anyElementNotLoaded(List<org.openqa.selenium.internal.WrapsElement> proxies, List<String> fieldNames)
static <T> T	asPage(Class<T> pageClassToProxy)
void	checkJavascriptError()
protected void	cleanRepository(DocumentBasePage currentPage) Deprecated. since 8.3
protected CollectionContentTabSubPage	createCollection(DocumentBasePage currentPage, String collectionsTitle, String fileDescription) Deprecated. since 8.3: use DocumentBasePage.createCollection(String, String) instead.
protected DocumentBasePage	createCollections(DocumentBasePage currentPage, String collectionsTitle, String fileDescription) Deprecated. since 8.3: use DocumentBasePage.createCollections(String, String) instead.
protected FileDocumentBasePage	createFile(DocumentBasePage currentPage, String fileTitle, String fileDescription, boolean uploadBlob, String filePrefix, String fileSuffix, String fileContent) Deprecated. since 8.3: use DocumentBasePage.createFile(String, String, boolean, String, String, String) instead.
protected NoteDocumentBasePage	createNote(DocumentBasePage currentPage, String noteTitle, String noteDescription, boolean defineNote, String noteContent) Deprecated. since 8.3: use DocumentBasePage.createNote(String, String, boolean, String) instead.
protected DocumentBasePage	createWorkspace(DocumentBasePage currentPage, String workspaceTitle, String workspaceDescription) Deprecated. since 8.3: use DocumentBasePage.createWorkspace(String, String) instead.
protected void	deleteWorkspace(DocumentBasePage currentPage, String workspaceTitle) Deprecated. since 8.3: use DocumentBasePage.deleteWorkspace(String) instead.
static <T> T	fillElement(Class<T> pageClassToProxy, T page) Fills an instantiated page/form/widget attributes
static <T> T	get(String url, Class<T> pageClassToProxy, JavaScriptErrorCollector.JavaScriptErrorIgnoreRule... ignores)
protected String	getCurrentDocumentId() Get the current document id stored in the javascript ctx.currentDocument variable of the current page.
LoginPage	getLoginPage()
static org.openqa.selenium.WebDriver	getPopup()
static String	getTmpFileToUploadPath(String filePrefix, String fileSuffix, String fileContent) Creates a temporary file and returns its absolute path.
static <T extends WebFragment> T	getWebFragment(org.openqa.selenium.By by, Class<T> webFragmentClass)
static <T extends WebFragment> T	getWebFragment(org.openqa.selenium.WebElement element, Class<T> webFragmentClass)
static <T> T	getWithoutErrorHandler(String url, Class<T> pageClassToProxy) Do not wait for page load.
protected static void	initChromeDriver()
static void	initDriver()
protected static void	initFirefoxDriver()
protected static void	initRemoteFirefoxDriver()
protected DocumentBasePage	initRepository(DocumentBasePage currentPage) Deprecated. since 8.3
protected static <T> T	instantiatePage(Class<T> pageClassToProxy)
protected static <T extends WebFragment> T	instantiateWebFragment(org.openqa.selenium.WebElement element, Class<T> webFragmentClass)
DocumentBasePage	login() Login as Administrator
DocumentBasePage	login(String username, String password)
DocumentBasePage	loginAsTestUser() Login as default test user.
LoginPage	loginInvalid(String username, String password) Login using an invalid credential.
LoginPage	logout()
void	logoutSimply() Logs out without expecting to be redirected to the login page.
<T extends AbstractPage> T	nav(Class<T> pageClass, String linkText) navigate to a link text.
void	navToUrl(String urlString) Navigate to a specified url
static void	open(String url, JavaScriptErrorCollector.JavaScriptErrorIgnoreRule... ignores) Opens given url adding hardcoded Seam conversation named "0NXMAIN".
static void	quitDriver()
void	runBeforeAfters() This method will be executed before any method registered with JUnit After annotation.
static org.openqa.selenium.WebDriver	switchToPopup(String text) Focus popup that contains text parameter value in his current URL.

Methods inherited from class java.lang.Object

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

Field Detail

TEST_USERNAME

public static final String TEST_USERNAME

Since:

5.9.2

See Also:

Constant Field Values

TEST_PASSWORD

public static final String TEST_PASSWORD

Since:

5.9.2

See Also:

Constant Field Values

POLLING_FREQUENCY_MILLISECONDS

public static final int POLLING_FREQUENCY_MILLISECONDS

Polling frequency in milliseconds.

Since:

5.9.2

See Also:

Constant Field Values

POLLING_FREQUENCY_SECONDS

public static final int POLLING_FREQUENCY_SECONDS

See Also:

Constant Field Values

PAGE_LOAD_TIME_OUT_SECONDS

public static final int PAGE_LOAD_TIME_OUT_SECONDS

Page Load timeout in seconds.

Since:

5.9.2

See Also:

Constant Field Values

LOAD_TIMEOUT_SECONDS

public static final int LOAD_TIMEOUT_SECONDS

See Also:

Constant Field Values

IMPLICIT_WAIT_MILLISECONDS

public static final int IMPLICIT_WAIT_MILLISECONDS

Driver implicit wait in milliseconds.

Since:

8.3

See Also:

Constant Field Values

LOAD_SHORT_TIMEOUT_SECONDS

public static final int LOAD_SHORT_TIMEOUT_SECONDS

See Also:

Constant Field Values

AJAX_TIMEOUT_SECONDS

public static final int AJAX_TIMEOUT_SECONDS

See Also:

Constant Field Values

AJAX_SHORT_TIMEOUT_SECONDS

public static final int AJAX_SHORT_TIMEOUT_SECONDS

See Also:

Constant Field Values

CHROME_DRIVER_DEFAULT_PATH_LINUX

@Deprecated
public static final String CHROME_DRIVER_DEFAULT_PATH_LINUX

Deprecated. since 8.3

Since:

5.7

See Also:

ChromeDriverProvider, Constant Field Values

CHROME_DRIVER_DEFAULT_PATH_MAC

@Deprecated
public static final String CHROME_DRIVER_DEFAULT_PATH_MAC

Deprecated. since 8.3

Since:

5.7 "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" doesn't work

See Also:

ChromeDriverProvider, Constant Field Values

CHROME_DRIVER_DEFAULT_PATH_WINVISTA

@Deprecated
public static final String CHROME_DRIVER_DEFAULT_PATH_WINVISTA

Deprecated. since 8.3

Since:

5.7

See Also:

ChromeDriverProvider

CHROME_DRIVER_DEFAULT_PATH_WINXP

@Deprecated
public static final String CHROME_DRIVER_DEFAULT_PATH_WINXP

Deprecated. since 8.3

Since:

5.7

See Also:

ChromeDriverProvider

CHROME_DRIVER_DEFAULT_EXECUTABLE_NAME

@Deprecated
public static final String CHROME_DRIVER_DEFAULT_EXECUTABLE_NAME

Deprecated. since 8.3

Since:

5.7

See Also:

ChromeDriverProvider, Constant Field Values

CHROME_DRIVER_WINDOWS_EXECUTABLE_NAME

@Deprecated
public static final String CHROME_DRIVER_WINDOWS_EXECUTABLE_NAME

Deprecated. since 8.3

Since:

5.7

See Also:

ChromeDriverProvider, Constant Field Values

SYSPROP_CHROME_DRIVER_PATH

@Deprecated
public static final String SYSPROP_CHROME_DRIVER_PATH

Deprecated. since 8.3

See Also:

ChromeDriverProvider, Constant Field Values

NUXEO_URL

public static final String NUXEO_URL

driver

public static org.openqa.selenium.remote.RemoteWebDriver driver

proxyManager

protected static ProxyManager proxyManager

watchman

public org.junit.rules.MethodRule watchman

Logger method to follow what's being run on server logs and take a screenshot of the last page in case of failure

ignores

protected JavaScriptErrorCollector.JavaScriptErrorIgnoreRule[] ignores

Since:

9.3

Constructor Detail

AbstractTest

public AbstractTest()

Method Detail

runBeforeAfters

public void runBeforeAfters()

This method will be executed before any method registered with JUnit After annotation.

Since:

5.8

initDriver

public static void initDriver()
                       throws Exception

Throws:

Exception

initFirefoxDriver

protected static void initFirefoxDriver()
                                 throws Exception

Throws:

Exception

initRemoteFirefoxDriver

protected static void initRemoteFirefoxDriver()
                                       throws Exception

Throws:

Exception

initChromeDriver

protected static void initChromeDriver()
                                throws Exception

Throws:

Exception

addAfterTestIgnores

public void addAfterTestIgnores(JavaScriptErrorCollector.JavaScriptErrorIgnoreRule... ignores)

Since:

9.3

checkJavascriptError

public void checkJavascriptError()

Since:

7.1

quitDriver

public static void quitDriver()

get

public static <T> T get(String url,
                        Class<T> pageClassToProxy,
                        JavaScriptErrorCollector.JavaScriptErrorIgnoreRule... ignores)

open

public static void open(String url,
                        JavaScriptErrorCollector.JavaScriptErrorIgnoreRule... ignores)

Opens given url adding hardcoded Seam conversation named "0NXMAIN".

Since:

8.3

getWithoutErrorHandler

public static <T> T getWithoutErrorHandler(String url,
                                           Class<T> pageClassToProxy)
                                    throws IOException

Do not wait for page load. Do not handle error. Do not give explicit error in case of failure. This is a very raw get.

Throws:

IOException

Since:

6.0

getPopup

public static org.openqa.selenium.WebDriver getPopup()

switchToPopup

public static org.openqa.selenium.WebDriver switchToPopup(String text)

Focus popup that contains text parameter value in his current URL.

Parameters:

text - that must be contained in popup URL

Returns:

WebDriver instance to be chained

Since:

9.3

asPage

public static <T> T asPage(Class<T> pageClassToProxy)

getWebFragment

public static <T extends WebFragment> T getWebFragment(org.openqa.selenium.By by,
                                                       Class<T> webFragmentClass)

getWebFragment

public static <T extends WebFragment> T getWebFragment(org.openqa.selenium.WebElement element,
                                                       Class<T> webFragmentClass)

fillElement

public static <T> T fillElement(Class<T> pageClassToProxy,
                                T page)

Fills an instantiated page/form/widget attributes

Since:

5.7

anyElementNotLoaded

protected static String anyElementNotLoaded(List<org.openqa.selenium.internal.WrapsElement> proxies,
                                            List<String> fieldNames)

instantiatePage

protected static <T> T instantiatePage(Class<T> pageClassToProxy)

instantiateWebFragment

protected static <T extends WebFragment> T instantiateWebFragment(org.openqa.selenium.WebElement element,
                                                                  Class<T> webFragmentClass)

getLoginPage

public LoginPage getLoginPage()

logout

public LoginPage logout()

logoutSimply

public void logoutSimply()

Logs out without expecting to be redirected to the login page. This can be the case on a simple server distribution when logged in: the logout action can redirect to the home.html startup page.

Since:

9.2

nav

public <T extends AbstractPage> T nav(Class<T> pageClass,
                                      String linkText)

navigate to a link text. wait until the link is available and click on it.

navToUrl

public void navToUrl(String urlString)
              throws MalformedURLException

Navigate to a specified url

Parameters:

urlString - url

Throws:

MalformedURLException

login

public DocumentBasePage login()
                       throws DocumentBasePage.UserNotConnectedException

Login as Administrator

Returns:

the Document base page (by default returned by CAP)

Throws:

DocumentBasePage.UserNotConnectedException

login

public DocumentBasePage login(String username,
                              String password)
                       throws DocumentBasePage.UserNotConnectedException

Throws:

DocumentBasePage.UserNotConnectedException

loginAsTestUser

public DocumentBasePage loginAsTestUser()
                                 throws DocumentBasePage.UserNotConnectedException

Login as default test user.

Throws:

DocumentBasePage.UserNotConnectedException

Since:

5.9.2

loginInvalid

public LoginPage loginInvalid(String username,
                              String password)

Login using an invalid credential.

Parameters:

username - the username

password - the password

initRepository

@Deprecated
protected DocumentBasePage initRepository(DocumentBasePage currentPage)
                                               throws Exception

Deprecated. since 8.3

Init the repository with a test Workspace form the currentPage.

Parameters:

currentPage - the current page

Returns:

the created Workspace page

Throws:

Exception - if initializing repository fails

cleanRepository

@Deprecated
protected void cleanRepository(DocumentBasePage currentPage)
                                    throws Exception

Deprecated. since 8.3

Cleans the repository (delete the test Workspace) from the currentPage.

Parameters:

currentPage - the current page

Throws:

Exception - if cleaning repository fails

createWorkspace

@Deprecated
protected DocumentBasePage createWorkspace(DocumentBasePage currentPage,
                                                       String workspaceTitle,
                                                       String workspaceDescription)

Deprecated. since 8.3: use DocumentBasePage.createWorkspace(String, String) instead.

Creates a Workspace from the currentPage.

Parameters:

currentPage - the current page

workspaceTitle - the workspace title

workspaceDescription - the workspace description

Returns:

the created Workspace page

deleteWorkspace

@Deprecated
protected void deleteWorkspace(DocumentBasePage currentPage,
                                           String workspaceTitle)

Deprecated. since 8.3: use DocumentBasePage.deleteWorkspace(String) instead.

Deletes the Workspace with title workspaceTitle from the currentPage.

Parameters:

currentPage - the current page

workspaceTitle - the workspace title

createFile

@Deprecated
protected FileDocumentBasePage createFile(DocumentBasePage currentPage,
                                                      String fileTitle,
                                                      String fileDescription,
                                                      boolean uploadBlob,
                                                      String filePrefix,
                                                      String fileSuffix,
                                                      String fileContent)
                                               throws IOException

Deprecated. since 8.3: use DocumentBasePage.createFile(String, String, boolean, String, String, String) instead.

Creates a File form the currentPage.

Parameters:

currentPage - the current page

fileTitle - the file title

fileDescription - the file description

uploadBlob - true if a blob needs to be uploaded (temporary file created for this purpose)

filePrefix - the file prefix

fileSuffix - the file suffix

fileContent - the file content

Returns:

the created File page

Throws:

IOException - if temporary file creation fails

createCollections

@Deprecated
protected DocumentBasePage createCollections(DocumentBasePage currentPage,
                                                         String collectionsTitle,
                                                         String fileDescription)

Deprecated. since 8.3: use DocumentBasePage.createCollections(String, String) instead.

Creates a Collections container form the currentPage.

Parameters:

currentPage - the current page

collectionsTitle - the Collections container title

fileDescription - the collections description

Returns:

the created Collections page

createCollection

@Deprecated
protected CollectionContentTabSubPage createCollection(DocumentBasePage currentPage,
                                                                   String collectionsTitle,
                                                                   String fileDescription)

Deprecated. since 8.3: use DocumentBasePage.createCollection(String, String) instead.

Creates a Collection form the currentPage.

Parameters:

currentPage - the current page

collectionsTitle - the Collections container title

fileDescription - the collection description

Returns:

the created Collections page

getTmpFileToUploadPath

public static String getTmpFileToUploadPath(String filePrefix,
                                            String fileSuffix,
                                            String fileContent)
                                     throws IOException

Creates a temporary file and returns its absolute path.

Parameters:

filePrefix - the file prefix

fileSuffix - the file suffix

fileContent - the file content

Returns:

the temporary file to upload path

Throws:

IOException - if temporary file creation fails

Since:

5.9.3

getCurrentDocumentId

protected String getCurrentDocumentId()

Get the current document id stored in the javascript ctx.currentDocument variable of the current page.

Returns:

the current document id

Since:

5.7

createNote

@Deprecated
protected NoteDocumentBasePage createNote(DocumentBasePage currentPage,
                                                      String noteTitle,
                                                      String noteDescription,
                                                      boolean defineNote,
                                                      String noteContent)
                                               throws IOException

Deprecated. since 8.3: use DocumentBasePage.createNote(String, String, boolean, String) instead.

Creates a Note form the currentPage.

Parameters:

currentPage - the current page

noteTitle - the note title

noteDescription - the note description

defineNote - true if the content of the note needs to be defined

noteContent - the content of the note

Returns:

the created note page.

Throws:

IOException

Since:

5.9.4