X-Git-Url: http://source.bookstackapp.com/bookstack/blobdiff_plain/a6633642232efd164d4708967ab59e498fbff896..refs/pull/2902/head:/tests/BrowserKitTest.php diff --git a/tests/BrowserKitTest.php b/tests/BrowserKitTest.php index 6c332a984..23eb10887 100644 --- a/tests/BrowserKitTest.php +++ b/tests/BrowserKitTest.php @@ -1,11 +1,12 @@ -make(Kernel::class)->bootstrap(); return $app; } - - /** - * Get a user that's not a system user such as the guest user. - */ - public function getNormalUser() - { - return User::where('system_name', '=', null)->get()->last(); - } - /** * Quickly sets an array of settings. + * * @param $settingsArray */ protected function setSettings($settingsArray) @@ -89,6 +82,7 @@ abstract class BrowserKitTest extends TestCase /** * Helper for updating entity permissions. + * * @param Entity $entity */ protected function updateEntityPermissions(Entity $entity) @@ -97,30 +91,33 @@ abstract class BrowserKitTest extends TestCase $restrictionService->buildJointPermissionsForEntity($entity); } - /** - * Quick way to create a new user without any permissions + * Quick way to create a new user without any permissions. + * * @param array $attributes + * * @return mixed */ protected function getNewBlankUser($attributes = []) { $user = factory(User::class)->create($attributes); + return $user; } /** * Assert that a given string is seen inside an element. * - * @param bool|string|null $element - * @param integer $position - * @param string $text - * @param bool $negate + * @param bool|string|null $element + * @param int $position + * @param string $text + * @param bool $negate + * * @return $this */ protected function seeInNthElement($element, $position, $text, $negate = false) { - $method = $negate ? 'assertNotRegExp' : 'assertRegExp'; + $method = $negate ? 'assertDoesNotMatchRegularExpression' : 'assertMatchesRegularExpression'; $rawPattern = preg_quote($text, '/'); @@ -139,13 +136,16 @@ abstract class BrowserKitTest extends TestCase /** * Assert that the current page matches a given URI. * - * @param string $uri + * @param string $uri + * * @return $this */ protected function seePageUrlIs($uri) { $this->assertEquals( - $uri, $this->currentUri, "Did not land on expected page [{$uri}].\n" + $uri, + $this->currentUri, + "Did not land on expected page [{$uri}].\n" ); return $this; @@ -153,10 +153,12 @@ abstract class BrowserKitTest extends TestCase /** * Do a forced visit that does not error out on exception. + * * @param string $uri - * @param array $parameters - * @param array $cookies - * @param array $files + * @param array $parameters + * @param array $cookies + * @param array $files + * * @return $this */ protected function forceVisit($uri, $parameters = [], $cookies = [], $files = []) @@ -167,13 +169,16 @@ abstract class BrowserKitTest extends TestCase $this->clearInputs()->followRedirects(); $this->currentUri = $this->app->make('request')->fullUrl(); $this->crawler = new Crawler($this->response->getContent(), $uri); + return $this; } /** * Click the text within the selected element. + * * @param $parentElement * @param $linkText + * * @return $this */ protected function clickInElement($parentElement, $linkText) @@ -181,28 +186,33 @@ abstract class BrowserKitTest extends TestCase $elem = $this->crawler->filter($parentElement); $link = $elem->selectLink($linkText); $this->visit($link->link()->getUri()); + return $this; } /** * Check if the page contains the given element. - * @param string $selector + * + * @param string $selector */ protected function pageHasElement($selector) { $elements = $this->crawler->filter($selector); - $this->assertTrue(count($elements) > 0, "The page does not contain an element matching " . $selector); + $this->assertTrue(count($elements) > 0, 'The page does not contain an element matching ' . $selector); + return $this; } /** * Check if the page contains the given element. - * @param string $selector + * + * @param string $selector */ protected function pageNotHasElement($selector) { $elements = $this->crawler->filter($selector); - $this->assertFalse(count($elements) > 0, "The page contains " . count($elements) . " elements matching " . $selector); + $this->assertFalse(count($elements) > 0, 'The page contains ' . count($elements) . ' elements matching ' . $selector); + return $this; } }