Console (#5450)

* Setting up interactive shell

* Updated docs for interactive shell, minor improvements

* added HTML snapshot some tests

* Removed pause execution test

* renamed Shell trait to pause, updated documentation

Author: DavertMik

src/Codeception/Module/WebDriver.php

@@ -707,6 +707,7 @@ public function _saveScreenshot($filename)
             $this->webDriver->takeScreenshot($filename);
         } catch (\Exception $e) {
             $this->debug('Unable to retrieve screenshot from Selenium : ' . $e->getMessage());
+            return;
         }
     }
 
@@ -757,9 +758,26 @@ public function makeScreenshot($name = null)
         }
         $screenName = $debugDir . DIRECTORY_SEPARATOR . $name . '.png';
         $this->_saveScreenshot($screenName);
-        $this->debug("Screenshot saved to $screenName");
+        $this->debugSection('Screenshot Saved', "file://$screenName");
+    }
+
+    public function makeHtmlSnapshot($name = null)
+    {
+        if (empty($name)) {
+            $name = uniqid(date("Y-m-d_H-i-s_"));
+        }
+        $debugDir = codecept_output_dir() . 'debug';
+        if (!is_dir($debugDir)) {
+            mkdir($debugDir, 0777);
+        }
+        $fileName = $debugDir . DIRECTORY_SEPARATOR . $name . '.html';
+
+        $this->_savePageSource($fileName);
+        $this->debugSection('Snapshot Saved', "file://$fileName");
     }
 
+
+
     /**
      * Resize the current window.
      *
@@ -2697,17 +2715,6 @@ public function clickWithRightButton($cssOrXPath = null, $offsetX = null, $offse
         $this->webDriver->getMouse()->contextClick();
     }
 
-    /**
-     * Pauses test execution in debug mode.
-     * To proceed test press "ENTER" in console.
-     *
-     * This method is useful while writing tests,
-     * since it allows you to inspect the current page in the middle of a test case.
-     */
-    public function pauseExecution()
-    {
-        Debug::pause();
-    }
 
     /**
      * Performs a double-click on an element matched by CSS or XPath.

tests/web/WebDriverTest.php

@@ -135,6 +135,17 @@ public function testScreenshot()
         @unlink(\Codeception\Configuration::outputDir().'testshot.png');
     }
 
+    public function testSnapshot()
+    {
+        $this->module->amOnPage('/');
+        @unlink(\Codeception\Configuration::outputDir().'testshot.png');
+        $testName="debugTest";
+
+        $this->module->makeHtmlSnapshot($testName);
+        $this->assertFileExists(\Codeception\Configuration::outputDir().'debug/'.$testName.'.html');
+        @unlink(\Codeception\Configuration::outputDir().'debug/'.$testName.'.html');
+    }
+
     public function testSubmitForm()
     {
         $this->module->amOnPage('/form/complex');
@@ -414,12 +425,6 @@ public function testAppendFieldRadioButtonByLabelFails()
         $this->module->appendField('form input[name=terms]', 'Get Off123');
     }
 
-    public function testPauseExecution()
-    {
-        $this->module->amOnPage('/');
-        $this->module->pauseExecution();
-    }
-
     // Issue https://github.com/Codeception/Codeception/pull/875
     public function testFillPasswordOnFormSubmit()
     {