public function WebAssert::titleEquals in Drupal 9

Same name and namespace in other branches

1. 8 core/tests/Drupal/Tests/WebAssert.php \Drupal\Tests\WebAssert::titleEquals()

Pass if the page title is the given string.

Parameters

string $expected_title: The string the page title should be.

Throws

\Behat\Mink\Exception\ExpectationException Thrown when element doesn't exist, or the title is a different one.

File

core/tests/Drupal/Tests/WebAssert.php, line 286

Class

WebAssert

Defines a class with methods for asserting presence of elements during tests.

Namespace

Drupal\Tests

Code

public function titleEquals($expected_title) {
  if (func_num_args() > 1) {
    @trigger_error('Calling ' . __METHOD__ . ' with more than one argument is deprecated in drupal:9.1.0 and will throw an \\InvalidArgumentException in drupal:10.0.0. See https://www.drupal.org/node/3162537', E_USER_DEPRECATED);
  }
  $title_element = $this->session
    ->getPage()
    ->find('css', 'title');
  if (!$title_element) {
    throw new ExpectationException('No title element found on the page', $this->session
      ->getDriver());
  }
  $actual_title = $title_element
    ->getText();
  $this
    ->assert($expected_title === $actual_title, 'Title found');
}