com.opera.core.systems
Class OperaDesktopDriver

java.lang.Object
  org.openqa.selenium.remote.RemoteWebDriver
      com.opera.core.systems.OperaDriver
          com.opera.core.systems.OperaDesktopDriver

All Implemented Interfaces:

org.openqa.selenium.HasCapabilities, org.openqa.selenium.HasInputDevices, org.openqa.selenium.internal.FindsByClassName, org.openqa.selenium.internal.FindsByCssSelector, org.openqa.selenium.internal.FindsById, org.openqa.selenium.internal.FindsByLinkText, org.openqa.selenium.internal.FindsByName, org.openqa.selenium.internal.FindsByTagName, org.openqa.selenium.internal.FindsByXPath, org.openqa.selenium.JavascriptExecutor, org.openqa.selenium.SearchContext, org.openqa.selenium.TakesScreenshot, org.openqa.selenium.WebDriver

public class OperaDesktopDriver
extends OperaDriver

An extension of OperaDriver for testing the interface of the Opera desktop browser.

Author:

Adam Minchinton, Karianne Ekern

Nested Class Summary

Nested classes/interfaces inherited from class com.opera.core.systems.OperaDriver

OperaDriver.OperaOptions, OperaDriver.OperaTimeouts, OperaDriver.OperaUtils, OperaDriver.PrivateData

Nested classes/interfaces inherited from class org.openqa.selenium.remote.RemoteWebDriver

org.openqa.selenium.remote.RemoteWebDriver.RemoteTargetLocator, org.openqa.selenium.remote.RemoteWebDriver.RemoteWebDriverOptions, org.openqa.selenium.remote.RemoteWebDriver.When

Nested classes/interfaces inherited from interface org.openqa.selenium.WebDriver

org.openqa.selenium.WebDriver.ImeHandler, org.openqa.selenium.WebDriver.Navigation, org.openqa.selenium.WebDriver.Options, org.openqa.selenium.WebDriver.TargetLocator, org.openqa.selenium.WebDriver.Timeouts, org.openqa.selenium.WebDriver.Window

Field Summary

Fields inherited from class com.opera.core.systems.OperaDriver

objectIds, runner, settings

Constructor Summary

OperaDesktopDriver()

OperaDesktopDriver(org.openqa.selenium.Capabilities c)
Constructor that starts Opera if it's not running.

Method Summary

void	deleteOperaPrefs() Deletes the profile for the connected Opera instance.
QuickWidget	findWidgetByName(DesktopWmProtos.QuickWidgetInfo.QuickWidgetType type, int windowId, String widgetName) Finds widget by name in the window specified by windowId.
QuickWidget	findWidgetByName(DesktopWmProtos.QuickWidgetInfo.QuickWidgetType type, int windowId, String widgetName, String parentName) Finds widget by name and parent in the window with the specified window id.
QuickWidget	findWidgetByPosition(DesktopWmProtos.QuickWidgetInfo.QuickWidgetType type, int windowId, int row, int column) Finds widget by specified position.
QuickWidget	findWidgetByPosition(DesktopWmProtos.QuickWidgetInfo.QuickWidgetType type, int windowId, int row, int column, String parentName) Finds widget by specified position.
QuickWidget	findWidgetByStringId(DesktopWmProtos.QuickWidgetInfo.QuickWidgetType type, int windowId, String stringId) Finds widget with the text specified by string id in the window with the given id.
QuickWidget	findWidgetByStringId(DesktopWmProtos.QuickWidgetInfo.QuickWidgetType type, int windowId, String stringId, String parentName) Finds widget with the text specified by string id and parentName in the specified window.
QuickWidget	findWidgetByText(DesktopWmProtos.QuickWidgetInfo.QuickWidgetType type, int windowId, String text) Finds widget with the text specified in the window with the given window id.
QuickWidget	findWidgetByText(DesktopWmProtos.QuickWidgetInfo.QuickWidgetType type, int windowId, String text, String parentName) Finds widget by text and parent widget name.
QuickWindow	findWindowById(int windowId) Find window by window id.
QuickWindow	findWindowByName(String windowName) Find a Window by its name.
int	getActiveQuickWindowID() Gets the id of the active QuickWindow.
String	getCachePreferencesPath()
String	getLargePreferencesPath()
String	getOperaPath() Gets the path to the connected Opera instance.
int	getPid()
QuickMenu	getQuickMenu(String menuName) Get a menu based on its name (Note; the menubar is also seen as a menu)
QuickMenu	getQuickMenu(String menuName, int windowId) Get a menu based on its name and windowid - makes it possible to get the menubar of a specific main window
QuickMenuItem	getQuickMenuItemByAccKey(String key, String menuName)
QuickMenuItem	getQuickMenuItemByAction(String action) Get a QuickMenuItem by its action
QuickMenuItem	getQuickMenuItemByName(String name)
QuickMenuItem	getQuickMenuItemByName(String name, int window_id) Get a menuitem by its name and the windowid of the window the menu it is in is in.
QuickMenuItem	getQuickMenuItemByPosition(int row, String menuName) Get an item by its position (row).
QuickMenuItem	getQuickMenuItemByShortcut(String shortcut)
QuickMenuItem	getQuickMenuItemByStringId(String stringId) Get an item in a language independant way from its stringId.
QuickMenuItem	getQuickMenuItemBySubmenu(String submenu) Get a quickmenuitem by its submenuname
QuickMenuItem	getQuickMenuItemByText(String text) Get an item by its text.
List<QuickMenuItem>	getQuickMenuItemList()
List<QuickMenu>	getQuickMenuList()
List<QuickWidget>	getQuickWidgetList(int windowId) Gets a list of all widgets in the window with the given window id.
List<QuickWidget>	getQuickWidgetList(String windowName) Gets a list of all widgets in the window with the given window name.
QuickWindow	getQuickWindow(String windowName)
int	getQuickWindowCount() Gets number of open windows.
int	getQuickWindowID(String windowName)
List<QuickWindow>	getQuickWindowList() Gets a list of all open QuickWindows.
String	getQuickWindowName(int windowId) Gets the name of the window from its window id.
protected Map<String,String>	getServicesList()
String	getSmallPreferencesPath()
String	getString(String enumText, boolean stripAmpersand)
boolean	isOperaRunning() Deprecated.
void	keyDown(String key, List<SystemInputProtos.ModifierPressed> modifiers) Press Key.
void	keyPress(String key, List<SystemInputProtos.ModifierPressed> modifiers) Press Key with modifiers held down.
void	keyUp(String key, List<SystemInputProtos.ModifierPressed> modifiers) Release key.
void	operaDesktopAction(String using, int data, String dataString, String dataStringParam) Executes an opera action.
void	pressQuickMenuItem(String menuItemText, boolean popMenu)
void	quitDriver() Shuts down the driver (but not Opera)
void	quitOpera() Quits Opera, cuts the connection to free the port and shuts down the getScopeServices().
void	resetOperaPrefs(String newPrefs) resetOperaPrefs - restarts Opera after copying over newPrefs to profile, if newPrefs folder exists.
String	waitForMenuClosed(String menuName) Waits until the menu is closed, and then returns the name of the window
String	waitForMenuItemPressed(String menuItemText) Waits until the menu item is pressed and then returns the text of the menu item pressed
String	waitForMenuShown(String menuName) Waits until the menu is shown, and then returns the name of the window
void	waitForWindowActivated() Waits for any window activated event.
int	waitForWindowActivated(String windowName) Waits until the window is activated, and then returns the window id of the window.
void	waitForWindowClose() Waits for any window close event.
int	waitForWindowClose(String windowName) Waits until the window is closed, and then returns the window id of the window.
int	waitForWindowLoaded(String windowName) Waits until the window is loaded and then returns the window id of the window.
int	waitForWindowShown(String windowName) Waits until the window is shown, and then returns the window id of the window
void	waitForWindowUpdated() Waits for any window update event.
int	waitForWindowUpdated(String windowName) Waits until the window is updated, and then returns the window id of the window.
void	waitStart() Starts a process of waiting for some event.

Methods inherited from class com.opera.core.systems.OperaDriver

close, executeAsyncScript, executeScript, findElement, findElement, findElement, findElementByName, findElements, findElements, findElements, findElementsByName, get, get, getCapabilities, getCurrentUrl, getExecService, getKeyboard, getMouse, getOperaActionList, getPageSource, getScopeServices, getScreenshotAs, getScriptDebugger, getTitle, getWindowCount, getWindowHandle, getWindowHandles, implicitlyWaitFor, init, listFrames, manage, navigate, operaAction, preferences, processElements, quit, saveScreenshot, selftest, setUseOperaIdle, switchTo, utils, waitForLoadToComplete

Methods inherited from class org.openqa.selenium.remote.RemoteWebDriver

execute, execute, findElementByClassName, findElementByCssSelector, findElementById, findElementByLinkText, findElementByPartialLinkText, findElementByTagName, findElementByXPath, findElementsByClassName, findElementsByCssSelector, findElementsById, findElementsByLinkText, findElementsByPartialLinkText, findElementsByTagName, findElementsByXPath, getCommandExecutor, getElementConverter, getErrorHandler, getExecuteMethod, getFileDetector, getSessionId, log, setCommandExecutor, setElementConverter, setFileDetector, setFoundBy, setLogLevel, setSessionId, startClient, startSession, stopClient, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

OperaDesktopDriver

public OperaDesktopDriver()

OperaDesktopDriver

public OperaDesktopDriver(org.openqa.selenium.Capabilities c)

Constructor that starts Opera if it's not running.

Parameters:

c - Settings for binary path to Opera, prefs directory, arguments and more.

Method Detail

getServicesList

protected Map<String,String> getServicesList()

Overrides:

getServicesList in class OperaDriver

Returns:

a map of service names to the minimum versions we require.

quitDriver

public void quitDriver()

Shuts down the driver (but not Opera)

quitOpera

public void quitOpera()

Quits Opera, cuts the connection to free the port and shuts down the getScopeServices().

getActiveQuickWindowID

public int getActiveQuickWindowID()

Gets the id of the active QuickWindow.

Returns:

id of active window

getQuickWidgetList

public List<QuickWidget> getQuickWidgetList(String windowName)

Gets a list of all widgets in the window with the given window name.

Parameters:

windowName - name of window to list widgets inside

Returns:

list of widgets in the window with name windowName If windowName is empty, it gets the widgets in the active window

getQuickWidgetList

public List<QuickWidget> getQuickWidgetList(int windowId)

Gets a list of all widgets in the window with the given window id.

Parameters:

windowId - - windowId of window to get widgets in

Returns:

list of widgets in the window with id windowId If windowId -1, gets the widgets in the active window

getQuickWindowList

public List<QuickWindow> getQuickWindowList()

Gets a list of all open QuickWindows.

Returns:

list of windows

getQuickMenu

public QuickMenu getQuickMenu(String menuName)

Get a menu based on its name (Note; the menubar is also seen as a menu)

Parameters:

menuName - (as found in standard_menu.ini)

Returns:

QuickMenu with the given name, or null if no such menu is found

getQuickMenu

public QuickMenu getQuickMenu(String menuName,
                              int windowId)

Get a menu based on its name and windowid - makes it possible to get the menubar of a specific main window

Parameters:

menuName - Name of the menu

windowId - WindowId of the menu (the window it is attached to)

Returns:

QuickMenu with given menuName and windowId, or null if no such menu can be found.

getQuickMenuList

public List<QuickMenu> getQuickMenuList()

Returns:

list of all open menus, as QuickMenus

getQuickMenuItemList

public List<QuickMenuItem> getQuickMenuItemList()

Returns:

list of all QuickMenuItems in open menus

getQuickWindowID

public int getQuickWindowID(String windowName)

Parameters:

windowName - name of the window

Returns:

window id of the QuickWindow with name windowName, or -1 if no such window exists

getQuickWindow

public QuickWindow getQuickWindow(String windowName)

Parameters:

windowName - name of the window

Returns:

QuickWindow with the given name, or null if no such window exists

findWidgetByName

public QuickWidget findWidgetByName(DesktopWmProtos.QuickWidgetInfo.QuickWidgetType type,
                                    int windowId,
                                    String widgetName)

Finds widget by name in the window specified by windowId.

Parameters:

windowId - window id of parent window

widgetName - name of widget to find

Returns:

QuickWidget with the given name in the window with id windowId, or null if no such widget exists.

findWidgetByName

public QuickWidget findWidgetByName(DesktopWmProtos.QuickWidgetInfo.QuickWidgetType type,
                                    int windowId,
                                    String widgetName,
                                    String parentName)

Finds widget by name and parent in the window with the specified window id.

Parameters:

windowId - id of parent window

widgetName - name of widget

parentName - name of parent widget

Returns:

QuickWidget with widgetName and parent in the window given by windowId, or null if no such widget exists

findWidgetByText

public QuickWidget findWidgetByText(DesktopWmProtos.QuickWidgetInfo.QuickWidgetType type,
                                    int windowId,
                                    String text)

Finds widget with the text specified in the window with the given window id. Note, if there are several widgets in this window with the same text, the widget returned can be any one of those

Parameters:

windowId - - id of parent window

text - - text of widget

Returns:

QuickWidget with the given text in the specified window, or null if no such widget exists.

findWidgetByText

public QuickWidget findWidgetByText(DesktopWmProtos.QuickWidgetInfo.QuickWidgetType type,
                                    int windowId,
                                    String text,
                                    String parentName)

Finds widget by text and parent widget name.

Parameters:

windowId - id of parent window

text - text of widget

parentName - name of parent widget

Returns:

QuickWidget with the given text and parent in the window with id windowId, or null if no such widget exists

findWidgetByStringId

public QuickWidget findWidgetByStringId(DesktopWmProtos.QuickWidgetInfo.QuickWidgetType type,
                                        int windowId,
                                        String stringId)

Finds widget with the text specified by string id in the window with the given id.

Parameters:

windowId - id of parent window

stringId - string id of the widget

Returns:

QuickWidget or null if no matching widget found

findWidgetByStringId

public QuickWidget findWidgetByStringId(DesktopWmProtos.QuickWidgetInfo.QuickWidgetType type,
                                        int windowId,
                                        String stringId,
                                        String parentName)

Finds widget with the text specified by string id and parentName in the specified window.

Parameters:

windowId - id of parent window

stringId - stringid of the widget

parentName - name of parent widget

Returns:

QuickWidget, or null if no matching widget found

findWidgetByPosition

public QuickWidget findWidgetByPosition(DesktopWmProtos.QuickWidgetInfo.QuickWidgetType type,
                                        int windowId,
                                        int row,
                                        int column)

Finds widget by specified position. Used for widgets that have a position only, e.g. treeviewitems and tabs.

Parameters:

windowId - id of parent window

row - row of widget within its parent

column - column of widget within its parent

Returns:

QuickWidget matching, or null if no matching widget is found

findWidgetByPosition

public QuickWidget findWidgetByPosition(DesktopWmProtos.QuickWidgetInfo.QuickWidgetType type,
                                        int windowId,
                                        int row,
                                        int column,
                                        String parentName)

Finds widget by specified position. Used for widgets that have a position, e.g. treeviewitems and tabs.

Parameters:

windowId - id of parent window

row - row of widget within its parent

column - column of widget within its parent

parentName - name of parent widget

Returns:

QuickWidget, or null if no matching widget is found

pressQuickMenuItem

public void pressQuickMenuItem(String menuItemText,
                               boolean popMenu)

Parameters:

menuItemText - Menu item text

getQuickMenuItemByAction

public QuickMenuItem getQuickMenuItemByAction(String action)

Get a QuickMenuItem by its action

Parameters:

action - name of action of item (as specified in standard_menu.ini)

Returns:

QuickMenuItem

getQuickMenuItemBySubmenu

public QuickMenuItem getQuickMenuItemBySubmenu(String submenu)

Get a quickmenuitem by its submenuname

Parameters:

submenu - name of submenu of item (as specified in standard_menu.ini)

getQuickMenuItemByName

public QuickMenuItem getQuickMenuItemByName(String name)

Parameters:

name - Name of menuitem For a command/action item, this is its action name For a command/action item, with a parameter to its action, this is "action, parameter" (e.g. "Open link, www.elg.no") For an item that opens a submenu, this is the submenuname (all as found in standard_menu.ini)

getQuickMenuItemByName

public QuickMenuItem getQuickMenuItemByName(String name,
                                            int window_id)

Get a menuitem by its name and the windowid of the window the menu it is in is in. This is only relevant for the menubar. Makes it possible to distinguish between menubar items in different main windows.

getQuickMenuItemByText

public QuickMenuItem getQuickMenuItemByText(String text)

Get an item by its text. Not language independant, and therefore not a recommended way to get an item.

Parameters:

text - - text of the item (as shown in UI).

getQuickMenuItemByPosition

public QuickMenuItem getQuickMenuItemByPosition(int row,
                                                String menuName)

Get an item by its position (row). Rows starts counting at 0, and note that also menu separators are counted. Note that this is only unique within a single menu (specified by parentName), if parentName is null, this retrieves the first match.

Parameters:

row - position (row) in menu of item

menuName - name of menu item is in

getQuickMenuItemByAccKey

public QuickMenuItem getQuickMenuItemByAccKey(String key,
                                              String menuName)

Parameters:

key - accelerator key in menu of item (the letter that's underlined in the menu item text) Note: not platform independant, as it cannot be used on mac.

menuName - name of menu item is in

getQuickMenuItemByShortcut

public QuickMenuItem getQuickMenuItemByShortcut(String shortcut)

Parameters:

shortcut - shortcut of item

getQuickMenuItemByStringId

public QuickMenuItem getQuickMenuItemByStringId(String stringId)

Get an item in a language independant way from its stringId.

Parameters:

stringId - StringId as found in standard_menu.ini

findWindowByName

public QuickWindow findWindowByName(String windowName)

Find a Window by its name.

Parameters:

windowName - name of window

Returns:

QuickWindow or null if no window with windowName is found

findWindowById

public QuickWindow findWindowById(int windowId)

Find window by window id.

Parameters:

windowId - id of window

Returns:

QuickWindow or null if no window with the id found

getQuickWindowName

public String getQuickWindowName(int windowId)

Gets the name of the window from its window id.

Parameters:

windowId - window id of window

Returns:

String: name of the window with id windowId

getString

public String getString(String enumText,
                        boolean stripAmpersand)

Returns:

the string specified by the id @param enum_text

getOperaPath

public String getOperaPath()

Gets the path to the connected Opera instance.

Returns:

the path to the connected Opera instance

getLargePreferencesPath

public String getLargePreferencesPath()

Returns:

large preferences path

getSmallPreferencesPath

public String getSmallPreferencesPath()

Returns:

small preferences path

getCachePreferencesPath

public String getCachePreferencesPath()

Returns:

cache preferences path

keyPress

public void keyPress(String key,
                     List<SystemInputProtos.ModifierPressed> modifiers)

Press Key with modifiers held down.

Parameters:

key - key to press

modifiers - modifiers held

keyUp

public void keyUp(String key,
                  List<SystemInputProtos.ModifierPressed> modifiers)

Release key.

Parameters:

key - key to press

modifiers - modifiers held

keyDown

public void keyDown(String key,
                    List<SystemInputProtos.ModifierPressed> modifiers)

Press Key.

Parameters:

key - key to press

modifiers - modifiers held

getQuickWindowCount

public int getQuickWindowCount()

Gets number of open windows.

Returns:

number of open windows

operaDesktopAction

public void operaDesktopAction(String using,
                               int data,
                               String dataString,
                               String dataStringParam)

Executes an opera action.

Parameters:

using - - action_name

data - - data parameter

dataString - - data string parameter

dataStringParam - - parameter to data string

waitStart

public void waitStart()

Starts a process of waiting for some event. After this call, messages to the driver about window events are not thrown away, so that the notification about window shown is not lost because of other events or messages

waitForWindowUpdated

public void waitForWindowUpdated()

Waits for any window update event.

waitForWindowActivated

public void waitForWindowActivated()

Waits for any window activated event.

waitForWindowClose

public void waitForWindowClose()

Waits for any window close event.

waitForWindowShown

public int waitForWindowShown(String windowName)

Waits until the window is shown, and then returns the window id of the window

Parameters:

windowName - - window to wait for shown event on

Returns:

id of window

waitForWindowUpdated

public int waitForWindowUpdated(String windowName)

Waits until the window is updated, and then returns the window id of the window.

Parameters:

windowName - - window to wait for shown event on

Returns:

id of window

waitForWindowActivated

public int waitForWindowActivated(String windowName)

Waits until the window is activated, and then returns the window id of the window.

Parameters:

windowName - - window to wait for shown event on

Returns:

id of window

waitForWindowClose

public int waitForWindowClose(String windowName)

Waits until the window is closed, and then returns the window id of the window.

Parameters:

windowName - - window to wait for shown event on

Returns:

id of window

waitForWindowLoaded

public int waitForWindowLoaded(String windowName)

Waits until the window is loaded and then returns the window id of the window.

Parameters:

windowName - - window to wait for shown event on

Returns:

id of window

waitForMenuShown

public String waitForMenuShown(String menuName)

Waits until the menu is shown, and then returns the name of the window

Parameters:

menuName - window to wait for shown event on

Returns:

id of window

waitForMenuClosed

public String waitForMenuClosed(String menuName)

Waits until the menu is closed, and then returns the name of the window

Parameters:

menuName - window to wait for shown event on

Returns:

id of window

waitForMenuItemPressed

public String waitForMenuItemPressed(String menuItemText)

Waits until the menu item is pressed and then returns the text of the menu item pressed

Parameters:

menuItemText - - window to wait for shown event on

Returns:

text of the menu item

resetOperaPrefs

public void resetOperaPrefs(String newPrefs)

resetOperaPrefs - restarts Opera after copying over newPrefs to profile, if newPrefs folder exists. Copies prefs in folder newPrefs to the profile for the connected Opera instance. Will first quit Opera, then delete the old prefs, and copy the new prefs over, then restart Opera with the new prefs. Does nothing if profile used is default main user profile

Parameters:

newPrefs - - path to where new prefs to be copied into the prefs folders are located

deleteOperaPrefs

public void deleteOperaPrefs()

Deletes the profile for the connected Opera instance. Should only be called after the given Opera instance has quit

getPid

public int getPid()

Returns:

Process id of Opera browser that is connected to this driver.

isOperaRunning

public boolean isOperaRunning()

Deprecated.

Returns:

true if Opera is running, and running under the launcher