selenium-0.2.2: Test web applications through a browser. Source code Contents Index

Selenium.Server Portability Uses mtl Stability provisional Maintainer Aaron Tomb <atomb@galois.com>

Contents Types Basic functions Selenium command wrappers

Description

A Haskell binding the HTTP protocol spoken by the Selenium Remote Control server. The Selenium server allows remote clients to control a web browser, acting as automated users.

Synopsis

data Browser = InternetExplorer | Firefox | Konqueror | Opera | Safari data SCommand = SClick | SDoubleClick | SClickAt | SDoubleClickAt | SFireEvent | SKeyPress | SShiftKeyDown | SShiftKeyUp | SMetaKeyDown | SMetaKeyUp | SAltKeyDown | SAltKeyUp | SControlKeyDown | SControlKeyUp | SKeyDown | SKeyUp | SMouseOver | SMouseOut | SMouseDown | SMouseDownAt | SMouseUp | SMouseUpAt | SMouseMove | SMouseMoveAt | SType | STypeKeys | SSetSpeed | SGetSpeed | SCheck | SUncheck | SSelect | SAddSelection | SRemoveSelection | SRemoveAllSelections | SSubmit | SOpen | SOpenWindow | SSelectWindow | SSelectFrame | SFrameMatchesExpression | SWindowMatchesExpression | SWaitForPopup | SCancelNextPrompt | SAnswerNextPrompt | SGoBack | SRefresh | SClose | SIsAlertPresent | SIsPromptPresent | SIsConfirmationPresent | SGetAlert | SGetConfirmation | SGetPrompt | SGetLocation | SGetTitle | SGetBodyText | SGetValue | SGetText | SHighlight | SEval | SIsChecked | SGetTable | SGetSelectedLabels | SGetSelectedLabel | SGetSelectedValues | SGetSelectedValue | SGetSelectedIndexes | SGetSelectedIndex | SGetSelectedIds | SGetSelectedId | SIsSomethingSelected | SGetSelectOptions | SGetAttribute | SIsTextPresent | SIsElementPresent | SIsVisible | SIsEditable | SGetAllButtons | SGetAllLinks | SGetAllFields | SGetAttrFromAllWindows | SSetMouseSpeed | SGetMouseSpeed | SDragAndDrop | SDragAndDropToObject | SWindowFocus | SWindowMaximize | SGetAllWindowIds | SGetAllWindowNames | SGetAllWindowTitles | SGetHTMLSource | SSetCursorPosition | SGetElementIndex | SIsOrdered | SGetElementPositionLeft | SGetElementPositionTop | SGetElementWidth | SGetElementHeight | SGetCursorPosition | SSetContext | SGetExpression | SWaitForCondition | SGetXPathCount | SAddLocationStrategy | SSetTimeout | SWaitForPage | SGetCookie | SCreateCookie | SDeleteCookie | STestComplete | SNewSession data SeleniumRCSession = SeleniumRCSession { selHost :: HostName selPort :: Int selBrowser :: Browser selURL :: URI selSessionID :: Maybe Integer } data Selenium a mkSeleniumRCSession :: HostName -> Browser -> URI -> SeleniumRCSession startSelenium :: Selenium SeleniumRCSession stopSelenium :: Selenium () withSelenium :: SeleniumRCSession -> Selenium a -> IO (Either String a) runSelenium :: SeleniumRCSession -> Selenium a -> IO (Either String a) runSeleniumReader :: SeleniumRCSession -> Selenium a -> ErrorT String IO a doCommand :: SCommand -> [String] -> Selenium String doCommandList :: [(SCommand, [String])] -> Selenium [String] mkURI :: SeleniumRCSession -> SCommand -> [String] -> Maybe URI open :: String -> Selenium String click :: Locator -> Selenium String clickAndWait :: Locator -> Selenium String check :: Locator -> Selenium String uncheck :: Locator -> Selenium String typeText :: Locator -> String -> Selenium String isTextPresent :: String -> Selenium Bool isElementPresent :: Locator -> Selenium Bool isChecked :: Locator -> Selenium Bool waitForPage :: Integer -> Selenium String waitForCondition :: String -> Integer -> Selenium String keyPress :: Locator -> String -> Selenium String submit :: Locator -> Selenium String selectFrame :: String -> Selenium String mouseDown :: Locator -> Selenium String mouseMove :: Locator -> Selenium String mouseUp :: Locator -> Selenium String dragAndDrop :: Locator -> String -> Selenium String dragAndDropToObject :: Locator -> Locator -> Selenium String getAttribute :: Locator -> Selenium String getBodyText :: Selenium String getAllLinks :: Selenium [String] evalJS :: String -> Selenium String

Types

data Browser Source

Browser types Constructors InternetExplorer Firefox Konqueror Opera Safari Instances Show Browser

data SCommand Source

An SCommand: an action or accessor Constructors SClick SDoubleClick SClickAt SDoubleClickAt SFireEvent SKeyPress SShiftKeyDown SShiftKeyUp SMetaKeyDown SMetaKeyUp SAltKeyDown SAltKeyUp SControlKeyDown SControlKeyUp SKeyDown SKeyUp SMouseOver SMouseOut SMouseDown SMouseDownAt SMouseUp SMouseUpAt SMouseMove SMouseMoveAt SType STypeKeys SSetSpeed SGetSpeed SCheck SUncheck SSelect SAddSelection SRemoveSelection SRemoveAllSelections SSubmit SOpen SOpenWindow SSelectWindow SSelectFrame SFrameMatchesExpression SWindowMatchesExpression SWaitForPopup SCancelNextPrompt SAnswerNextPrompt SGoBack SRefresh SClose SIsAlertPresent SIsPromptPresent SIsConfirmationPresent SGetAlert SGetConfirmation SGetPrompt SGetLocation SGetTitle SGetBodyText SGetValue SGetText SHighlight SEval SIsChecked SGetTable SGetSelectedLabels SGetSelectedLabel SGetSelectedValues SGetSelectedValue SGetSelectedIndexes SGetSelectedIndex SGetSelectedIds SGetSelectedId SIsSomethingSelected SGetSelectOptions SGetAttribute SIsTextPresent SIsElementPresent SIsVisible SIsEditable SGetAllButtons SGetAllLinks SGetAllFields SGetAttrFromAllWindows SSetMouseSpeed SGetMouseSpeed SDragAndDrop SDragAndDropToObject SWindowFocus SWindowMaximize SGetAllWindowIds SGetAllWindowNames SGetAllWindowTitles SGetHTMLSource SSetCursorPosition SGetElementIndex SIsOrdered SGetElementPositionLeft SGetElementPositionTop SGetElementWidth SGetElementHeight SGetCursorPosition SSetContext SGetExpression SWaitForCondition SGetXPathCount SAddLocationStrategy SSetTimeout SWaitForPage SGetCookie SCreateCookie SDeleteCookie STestComplete SNewSession Instances Show SCommand

data SeleniumRCSession Source

Constructors SeleniumRCSession selHost :: HostName The HostName of the Selenium server to connect to selPort :: Int The port of the Selenium server to connect to selBrowser :: Browser The type of browser to start and use to run the tests selURL :: URI The base URL of the site to be tested selSessionID :: Maybe Integer A session ID filled in by startSelenium Instances MonadReader SeleniumRCSession Selenium

data Selenium a Source

The Selenium Monad, an error-handling read-only state Instances Monad Selenium Functor Selenium MonadIO Selenium MonadError String Selenium MonadReader SeleniumRCSession Selenium

Basic functions

mkSeleniumRCSession :: HostName -> Browser -> URI -> SeleniumRCSession Source

Create an unconnected Selenium session.

startSelenium :: Selenium SeleniumRCSession Source

Connect to the server, and tell it to start a web browser.

stopSelenium :: Selenium () Source

Tell the server that a session is finished.

withSelenium :: SeleniumRCSession -> Selenium a -> IO (Either String a) Source

Start a session, execute some code with the resulting handle, and then stop the session.

runSelenium :: SeleniumRCSession -> Selenium a -> IO (Either String a) Source

Run a Selenium action inside IO. This is the top-level function you'll usually use to run a Selenium command when not using withSelenium.

runSeleniumReader :: SeleniumRCSession -> Selenium a -> ErrorT String IO a Source

Run a Selenium action within the ErrorT monad. Useful for chaining together several actions without writing intermediate error handling.

doCommand :: SCommand -> [String] -> Selenium String Source

Send a Selenium command to the server with a list of arguments.

doCommandList :: [(SCommand, [String])] -> Selenium [String] Source

Execute a list of Selenium commands paired with arguments, and return | a list of results.

mkURI :: SeleniumRCSession -> SCommand -> [String] -> Maybe URI Source

Selenium command wrappers

open :: String -> Selenium String Source

click :: Locator -> Selenium String Source

clickAndWait :: Locator -> Selenium String Source

check :: Locator -> Selenium String Source

uncheck :: Locator -> Selenium String Source

typeText :: Locator -> String -> Selenium String Source

isTextPresent :: String -> Selenium Bool Source

isElementPresent :: Locator -> Selenium Bool Source

isChecked :: Locator -> Selenium Bool Source

waitForPage :: Integer -> Selenium String Source

waitForCondition :: String -> Integer -> Selenium String Source

keyPress :: Locator -> String -> Selenium String Source

submit :: Locator -> Selenium String Source

selectFrame :: String -> Selenium String Source

mouseDown :: Locator -> Selenium String Source

mouseMove :: Locator -> Selenium String Source

mouseUp :: Locator -> Selenium String Source

dragAndDrop :: Locator -> String -> Selenium String Source

dragAndDropToObject :: Locator -> Locator -> Selenium String Source

getAttribute :: Locator -> Selenium String Source

getBodyText :: Selenium String Source

getAllLinks :: Selenium [String] Source

evalJS :: String -> Selenium String Source

Produced by Haddock version 2.4.2