Test.WebDriver.Monad

Documentation

newtype WD a

A monadic interface to the WebDriver server. This monad is simply a state monad transformer over IO, threading session information between sequential webdriver commands

Constructors

WD (StateT WDSession IO a)

Instances

Monad WD

Functor WD

Applicative WD

MonadThrow WD

MonadCatch WD

MonadIO WD

WDSessionState WD

WebDriver WD

MonadBase IO WD

MonadBaseControl IO WD

type StM WD a = StM (StateT WDSession IO) a

runWD :: WDSession -> WD a -> IO a

Executes a WD computation within the IO monad, using the given WDSession.

runSession :: WDConfig -> WD a -> IO a

Executes a WD computation within the IO monad, automatically creating a new session beforehand.

NOTE: session is not automatically closed when complete. If you want this behavior, use finallyClose. Example: > runSessionThenClose action = runSession myConfig . finallyClose $ action

withSession :: WDSession -> WD a -> WD a

Locally sets a WDSession for use within the given WD action. The state of the outer action is unaffected by this function. This function is useful if you need to work with multiple sessions at once.

finallyClose :: WebDriver wd => wd a -> wd a

A finalizer ensuring that the session is always closed at the end of the given WD action, regardless of any exceptions.

closeOnException :: WebDriver wd => wd a -> wd a

Exception handler that closes the session when an asynchronous exception is thrown, but otherwise leaves the session open if the action was successful.

dumpSessionHistory :: (MonadIO wd, WebDriver wd) => wd a -> wd a

Prints a history of API requests to stdout after computing the given action.