function WebAssert::titleEquals

Same name in other branches
  1. 8.9.x core/tests/Drupal/Tests/WebAssert.php \Drupal\Tests\WebAssert::titleEquals()
  2. 10 core/tests/Drupal/Tests/WebAssert.php \Drupal\Tests\WebAssert::titleEquals()
  3. 11.x 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');
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.