protected function WebTestBase::assertTextHelper

Helper for assertText and assertNoText.

It is not recommended to call this function directly.

Parameters

$text: Plain text to look for.

$message: (optional) A message to display with the assertion. Do not translate messages: use format_string() to embed variables in the message text, not t(). If left blank, a default message will be displayed.

$group: The group this message is in, which is displayed in a column in test output. Use 'Debug' to indicate this is debugging output. Do not translate this string. Defaults to 'Other'; most tests do not override this default.

$not_exists: TRUE if this text should not exist, FALSE if it should.

Return value

TRUE on pass, FALSE on fail.

2 calls to WebTestBase::assertTextHelper()
WebTestBase::assertNoText in drupal/core/modules/simpletest/lib/Drupal/simpletest/WebTestBase.php
Pass if the text is NOT found on the text version of the page. The text version is the equivalent of what a user would see when viewing through a web browser. In other words the HTML has been filtered out of the contents.
WebTestBase::assertText in drupal/core/modules/simpletest/lib/Drupal/simpletest/WebTestBase.php
Pass if the text IS found on the text version of the page. The text version is the equivalent of what a user would see when viewing through a web browser. In other words the HTML has been filtered out of the contents.

File

drupal/core/modules/simpletest/lib/Drupal/simpletest/WebTestBase.php, line 2230
Definition of Drupal\simpletest\WebTestBase.

Class

WebTestBase
Test case for typical Drupal tests.

Namespace

Drupal\simpletest

Code

protected function assertTextHelper($text, $message = '', $group, $not_exists) {
  if ($this->plainTextContent === FALSE) {
    $this->plainTextContent = filter_xss($this
      ->drupalGetContent(), array());
  }
  if (!$message) {
    $message = !$not_exists ? t('"@text" found', array(
      '@text' => $text,
    )) : t('"@text" not found', array(
      '@text' => $text,
    ));
  }
  return $this
    ->assert($not_exists == (strpos($this->plainTextContent, $text) === FALSE), $message, $group);
}