Added component hover action. (#14)

drevops · Oct 6, 2017 · de988dc · de988dc
1 parent abb2c9c
commit de988dc
Show file tree

Hide file tree

Showing 4 changed files with 64 additions and 2 deletions.
diff --git a/behat.yml b/behat.yml
@@ -62,6 +62,8 @@ default:
         'off-canvas bottom': "#off-canvas-bottom"
         'sr only': "#sr-only"
         'sr only shown': "#sr-only-shown"
+        'hover': "#hover"
+        'hover content': "#hover-content"
         'overlay': "#overlay"
         'overlay trigger': "#overlay-trigger"
         'off-canvas overlay': "#overlay-off-canvas"

diff --git a/src/IntegratedExperts/BehatRelativityExtension/Context/RelativityContext.php b/src/IntegratedExperts/BehatRelativityExtension/Context/RelativityContext.php
@@ -137,7 +137,7 @@ public function assertFocused($subject)
      *
      * @javascript
      */
-    public function assertClick($subjects)
+    public function iClickComponents($subjects)
     {
         $subjects = $this->parseComponents($subjects);
 
@@ -148,7 +148,7 @@ public function assertClick($subjects)
         $errors = [];
         foreach ($subjects as $subject) {
             if (!$this->componentIsVisible($this->components[$subject])) {
-                $errors[] = sprintf("Unable to click on invisible component '%s' (%s)", $subject, $this->components[$subject]);
+                $errors[] = sprintf("Unable to click on an invisible component '%s' (%s)", $subject, $this->components[$subject]);
                 continue;
             }
 
@@ -167,6 +167,45 @@ public function assertClick($subjects)
         }
     }
 
+    /**
+     * Hover the mouse over one or multiple elements.
+     *
+     * @param string $subjects Subjects as a string.
+     *
+     * @When /^(?:|I )hover (?:over?) ([a-zA-Z0-9\s,\-]+)$/
+     *
+     * @javascript
+     */
+    public function iHoverComponents($subjects)
+    {
+        $subjects = $this->parseComponents($subjects);
+
+        if (empty($subjects)) {
+            throw new \Exception('No components provided');
+        }
+
+        $errors = [];
+        foreach ($subjects as $subject) {
+            if (!$this->componentIsVisible($this->components[$subject])) {
+                $errors[] = sprintf("Unable to hover over an invisible component '%s' (%s)", $subject, $this->components[$subject]);
+                continue;
+            }
+
+            $session = $this->getSession();
+            $xpath = $session->getSelectorsHandler()->selectorToXpath('css', $this->components[$subject]);
+
+            try {
+                $this->getSession()->getDriver()->mouseOver($xpath);
+            } catch (\Exception $e) {
+                $errors[] = sprintf("Unable to hover over a component '%s' (%s): %s", $subject, $this->components[$subject], $e->getMessage());
+            }
+        }
+
+        if (count($errors) > 0) {
+            throw new \Exception(implode("\n", $errors));
+        }
+    }
+
     /**
      * Init values required for relativity context.
      *

diff --git a/tests/behat/features/fixtures/relative.html b/tests/behat/features/fixtures/relative.html
@@ -302,6 +302,14 @@
                 display: block;
             }
         }
+
+        #hover #hover-content {
+            display: none;
+        }
+
+        #hover:hover #hover-content {
+            display: inline;
+        }
     </style>
 </head>
 <body>
@@ -426,5 +434,9 @@
     <div id="over-bottom">Text for over bottom</div>
 </div>
 
+<div id="hover">
+    Visible hover content
+    <span id="hover-content">Revealed hover content</span>
+</div>
 </body>
 </html>
diff --git a/tests/behat/features/positioning.feature b/tests/behat/features/positioning.feature
@@ -92,6 +92,15 @@ Feature: Behat relative assertions work
     Then I don't see off-canvas left, off-canvas right, off-canvas top and off-canvas bottom
     And I save screenshot
 
+  @javascript @phpserver
+  Scenario: Assert that element can be hovered
+    Given I am on the test page
+    And I see visible hover
+    And I don't see hover content
+    When I hover over hover
+    Then I see visible hover content
+    And I save screenshot
+
   @javascript @phpserver
   Scenario: Assert that overlay is clickable when visible
     Given I am on the test page