function WebAssert::pageTextContainsOnce

Same name and namespace in other branches
  1. 8.9.x core/tests/Drupal/Tests/WebAssert.php \Drupal\Tests\WebAssert::pageTextContainsOnce()
  2. 10 core/tests/Drupal/Tests/WebAssert.php \Drupal\Tests\WebAssert::pageTextContainsOnce()
  3. 11.x core/tests/Drupal/Tests/WebAssert.php \Drupal\Tests\WebAssert::pageTextContainsOnce()

Checks that current page contains text only once.

Parameters

string $text: The string to look for.

See also

\Behat\Mink\WebAssert::pageTextContains()

File

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

Class

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

Namespace

Drupal\Tests

Code

public function pageTextContainsOnce($text) {
    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);
    }
    $regex = '/' . preg_quote($text, '/') . '/ui';
    try {
        $this->pageTextMatchesCount(1, $regex);
    } catch (AssertionFailedError $e) {
        throw new ResponseTextException($e->getMessage(), $this->session
            ->getDriver());
    }
}

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