{-# LANGUAGE FlexibleInstances #-} {-# LANGUAGE IncoherentInstances #-} {-# LANGUAGE GADTs #-} {-# LANGUAGE StandaloneDeriving #-} {-# LANGUAGE OverloadedStrings #-} {-# LANGUAGE NoImplicitPrelude #-} module Selenium ( module Test.Hspec.WebDriver, module Test.WebDriver.Commands.Wait, wd, wait_delay, -- * Selecting CanSelect(..), ComplexSelector(..), select, selectSome, -- * Webdriver click, cssProp, attr, enterInput, setInput, fontSize, highlight, selectDropdown, getBackAfterwards, getLink, getText, getValue, sendKeys, clearInput, -- * Expectations changesURL, doesNotChangeURL, checkPresent, checkPresentSome, checkNotPresent, shouldHaveAttr, shouldHaveProp, shouldLinkTo, shouldSatisfy, shouldHaveText, shouldNotBe, shouldBeHidden, shouldBeInRange, shouldBeSelected, shouldBeDisplayed, expectationFailure, ) where import BasePrelude hiding (catch, bracket, (:|)) -- Lenses import Lens.Micro.Platform -- Monads import Control.Monad.Loops -- Containers import qualified Data.Set as Set -- Text import Data.Text (Text) import qualified Data.Text as T -- Testing import Test.Hspec.WebDriver hiding (getText, shouldHaveAttr, shouldHaveText, click, cssProp, attr, sendKeys, clearInput) import qualified Test.Hspec.WebDriver as WD import Test.WebDriver.Commands.Wait import Test.WebDriver.Exceptions import qualified Test.WebDriver.Common.Keys as Key import qualified Test.Hspec.Expectations as Hspec -- Exceptions import Control.Monad.Catch import Guide.Utils (ordNub) getLink :: CanSelect s => s -> WD String getLink s = do e <- select s -- Select all links including the root element itself linkElems <- selectAll ((e :& "a") :| (e :// "a")) links <- nub . catMaybes <$> mapM (flip attr "href") linkElems case links of [x] -> return (T.unpack x) [] -> expectationFailure $ printf "expected %s to contain a link" (show s) _ -> expectationFailure $ printf "expected %s to contain only one link" (show s) getText :: CanSelect s => s -> WD Text getText s = do -- TODO: Note [staleness] e <- select s WD.getText e getValue :: CanSelect s => s -> WD Text getValue x = fromMaybe "" <$> attr x "value" clearInput :: CanSelect s => s -> WD () clearInput s = do -- TODO: Note [staleness] input <- select s WD.clearInput input sendKeys :: CanSelect s => Text -> s -> WD () sendKeys t s = do -- TODO: Note [staleness] input <- select s WD.sendKeys t input enterInput :: CanSelect s => Text -> s -> WD () enterInput x s = do input <- select s clearInput input sendKeys (x <> Key.enter) input checkNotPresent input setInput :: CanSelect s => Text -> s -> WD () setInput x s = do input <- select s clearInput input sendKeys x input isAlive :: Element -> WD Bool isAlive e = (isEnabled e >> return True) `onDead` return False onDead :: WD a -> WD a -> WD a onDead x h = do let handler ex@(FailedCommand t _) | t `elem` [NoSuchElement, StaleElementReference] = h | otherwise = throw ex x `catch` handler tryDead :: WD a -> WD (Maybe a) tryDead x = (Just <$> x) `onDead` return Nothing -- TODO: can fail if the element becomes stale between 'select' and 'click' click :: CanSelect a => a -> WD () click s = WD.click =<< select s -- TODO: can fail if the element becomes stale between 'select' and -- 'shouldHaveAttr' shouldHaveAttr :: CanSelect a => a -> (Text, Text) -> WD () s `shouldHaveAttr` (a, txt) = do e <- select s e `WD.shouldHaveAttr` (a, txt) -- TODO: can fail if the element becomes stale between 'select' and -- 'shouldHaveText' shouldHaveText :: CanSelect a => a -> Text -> WD () s `shouldHaveText` txt = do e <- select s e `WD.shouldHaveText` txt shouldLinkTo :: CanSelect a => a -> String -> WD () s `shouldLinkTo` url2 = do url <- getLink s url `shouldBe` url2 highlight :: Element -> WD () highlight e = do html <- executeJS [JSArg e] "arguments[0].style.border='thick solid #FF0000';\ \return arguments[0].outerHTML;" liftIO $ putStrLn html selectDropdown :: Element -- ^ Dropdown -> Element -- ^ Option to select -> WD () selectDropdown sel opt = void (executeJS [JSArg sel, JSArg opt] "sel=arguments[0];opt=arguments[1];\ \for (var i=0;i WD [Element] getDescendants e = findElemsFrom e (ByXPath ".//*") getChildren :: Element -> WD [Element] getChildren e = findElemsFrom e (ByXPath "./*") data ComplexSelector where -- | Descendants (not including the element itself) (://) :: (CanSelect a, CanSelect b) => a -> b -> ComplexSelector -- | Children (:/) :: (CanSelect a, CanSelect b) => a -> b -> ComplexSelector -- | Parents (: a -> b -> ComplexSelector -- | Direct parents (: a -> b -> ComplexSelector -- | And (:&) :: (CanSelect a, CanSelect b) => a -> b -> ComplexSelector -- | Or (:|) :: (CanSelect a, CanSelect b) => a -> b -> ComplexSelector -- | Not Not :: CanSelect a => a -> ComplexSelector -- | Elements with specific text HasText :: Text -> ComplexSelector -- | Elements that contain specific text ContainsText :: Text -> ComplexSelector -- | Only pick the first N selected elements Take :: CanSelect a => Int -> a -> ComplexSelector -- | Only pick the Nth (starting from 0) selected element Index :: CanSelect a => Int -> a -> ComplexSelector -- | Displayed element Displayed :: ComplexSelector deriving instance Show ComplexSelector defSelectAll :: CanSelect a => a -> WD [Element] defSelectAll s = filterElems s =<< findElems (ByXPath "//") defFilterElems :: CanSelect a => a -> [Element] -> WD [Element] defFilterElems s es = do ss <- Set.fromList <$> selectAll s return (filter (`Set.member` ss) es) defAnyElem :: CanSelect a => a -> [Element] -> WD Bool defAnyElem s es = do ss <- Set.fromList <$> selectAll s return (any (`Set.member` ss) es) {- NOTE [staleness] ~~~~~~~~~~~~~~~ We want to avoid “stale element” errors at all costs, instead preferring “element not found” and so on. This means that whenever we select an element with 'select' or 'selectAll' and then do something with it, we have to catch and handle possible staleness. -} class Show a => CanSelect a where selectAll :: a -> WD [Element] selectAll = defSelectAll filterElems :: a -> [Element] -> WD [Element] filterElems = defFilterElems anyElem :: a -> [Element] -> WD Bool anyElem = defAnyElem instance CanSelect Element where selectAll e = filterM isAlive [e] filterElems s es = do alive <- isAlive s return $ if alive then filter (s ==) es else [] anyElem s es = do alive <- isAlive s return $ if alive then any (s ==) es else False instance CanSelect Selector where selectAll s = findElems s instance (a ~ Text) => CanSelect a where selectAll t = findElems (ByCSS t) instance CanSelect ComplexSelector where selectAll s = do let getDescendants' e = getDescendants e `onDead` return [] getChildren' e = getChildren e `onDead` return [] case s of (a :// b) -> do as <- selectAll a ordNub.concat <$> mapM (filterElems b <=< getDescendants') as (a :/ b) -> do as <- selectAll a ordNub.concat <$> mapM (filterElems b <=< getChildren') as (a : filterM (anyElem b <=< getDescendants') =<< selectAll a (a : filterM (anyElem b <=< getChildren') =<< selectAll a (a :& b) -> do filterElems b =<< selectAll a (a :| b) -> do as <- Set.fromList <$> selectAll a bs <- Set.fromList <$> selectAll b return (Set.toList (as `Set.union` bs)) Take n a -> take n <$> selectAll a Index n a -> toListOf (ix n) <$> selectAll a -- Not a -> defSelectAll (Not a) HasText t -> defSelectAll (HasText t) ContainsText t -> defSelectAll (ContainsText t) Displayed -> defSelectAll Displayed filterElems s es = do let andNotDead = fmap (== Just True) . tryDead case s of Not a -> (es \\) <$> filterElems a es HasText t -> filterM (andNotDead . fmap (== t) . getText) es ContainsText t -> filterM (andNotDead . fmap (t `T.isInfixOf`) . getText) es Displayed -> filterM (andNotDead . isDisplayed) es _ -> defFilterElems s es anyElem s es = do let andNotDead = fmap (== Just True) . tryDead case s of Not a -> (== length es) . length <$> filterElems a es HasText t -> anyM (andNotDead . fmap (== t) . getText) es ContainsText t -> anyM (andNotDead . fmap (t `T.isInfixOf`) . getText) es Displayed -> anyM (andNotDead . isDisplayed) es _ -> defAnyElem s es {- class ToSelector a where toSelector :: a -> Selector instance ToSelector Selector where toSelector = id instance ToSelector Text where toSelector = ByCSS -} -- | Ensure that the element is the only element matching the selector. select :: CanSelect a => a -> WD Element select x = do -- True = found more than one element -- False = found no elements v <- liftIO $ newIORef False let findOne = do es <- selectAll x case es of [e] -> return e [] -> do liftIO $ writeIORef v False unexpected "select: no elements" _ -> do liftIO $ writeIORef v True unexpected "select: more than one element" let handler = do moreThanOne <- liftIO $ readIORef v if moreThanOne then expectationFailure $ printf "%s isn't unique on the page" (show x) else expectationFailure $ printf "%s wasn't found on the page" (show x) waitUntil wait_delay findOne `onTimeout` handler -- | Select one of the elements matching the selector. selectSome :: CanSelect a => a -> WD Element selectSome x = do es <- selectAll x when (null es) $ expectationFailure $ printf "%s wasn't found on the page" (show x) return (head es) -- | @font-size@ of an element, in pixels fontSize :: CanSelect a => a -> WD Double fontSize s = do mbProp <- cssProp s "font-size" case mbProp of Nothing -> expectationFailure $ printf "expected %s to have font-size" (show s) Just fs -> case reads (T.unpack fs) of [(d, "px")] -> return d _ -> expectationFailure $ printf "couldn't parse font-size of %s: %s" (show s) (show fs) cssProp :: CanSelect a => a -> Text -> WD (Maybe Text) -- TODO: can fail (NOTE [staleness]) cssProp s p = do e <- select s WD.cssProp e p attr :: CanSelect a => a -> Text -> WD (Maybe Text) -- TODO: can fail (NOTE [staleness]) attr s p = do e <- select s WD.attr e p changesURL :: WD a -> WD a changesURL x = do url <- getCurrentURL a <- x waitUntil wait_delay (expect =<< ((/= url) <$> getCurrentURL)) return a doesNotChangeURL :: WD a -> WD a doesNotChangeURL x = do url <- getCurrentURL a <- x -- TODO: somehow check that the browser isn't even trying to change the URL url2 <- getCurrentURL url2 `shouldBe` url return a getBackAfterwards :: WD a -> WD a getBackAfterwards x = do url <- getCurrentURL a <- x openPage url return a wd :: String -> WD a -> SpecWith (WdTestSession ()) wd x act = it x (runWD (void act)) checkPresent :: CanSelect a => a -> WD () checkPresent x = void (select x) checkPresentSome :: CanSelect a => a -> WD () checkPresentSome x = void (selectSome x) checkNotPresent :: CanSelect a => a -> WD () checkNotPresent x = waitUntil wait_delay $ do es <- selectAll x when (not (null es)) $ unexpected $ printf "expected %s not to be present on the page" (show x) expectationFailure :: MonadIO m => String -> m a expectationFailure s = do liftIO (Hspec.expectationFailure s) undefined shouldSatisfy :: (Show a, MonadIO m) => a -> (String, a -> Bool) -> m () shouldSatisfy a (s, p) = unless (p a) $ expectationFailure (printf "expected %s to %s" (show a) s) shouldBeInRange :: (Show a, Ord a, MonadIO m) => a -> (a, a) -> m () shouldBeInRange a (x, y) = shouldSatisfy a ("be in range " ++ show (x,y), \n -> n >= x && n <= y) shouldNotBe :: (Show a, Eq a, MonadIO m) => a -> a -> m () shouldNotBe a x = shouldSatisfy a ("not be " ++ show x, const (a /= x)) shouldHaveProp :: CanSelect a => a -> (Text, Text) -> WD () s `shouldHaveProp` (a, txt) = do t <- cssProp s a unless (Just txt == t) $ expectationFailure $ printf "expected property %s of %s to be %s, got %s" a (show s) (show txt) (show t) shouldBeSelected :: CanSelect a => a -> WD () -- TODO: can fail (NOTE [staleness]) shouldBeSelected s = do e <- select s x <- isSelected e s `shouldSatisfy` ("be checked/selected", const x) shouldBeDisplayed :: CanSelect a => a -> WD () -- TODO: can fail (NOTE [staleness]) shouldBeDisplayed s = do e <- select s x <- isDisplayed e s `shouldSatisfy` ("be displayed", const x) shouldBeHidden :: CanSelect a => a -> WD () -- TODO: can fail (NOTE [staleness]) shouldBeHidden s = do e <- select s x <- isDisplayed e s `shouldSatisfy` ("be hidden", const (not x)) wait_delay :: Double wait_delay = 10