Same name in other branches

1. 9 core/tests/Drupal/KernelTests/AssertContentTrait.php \Drupal\KernelTests\AssertContentTrait::assertTextHelper()
2. 10 core/tests/Drupal/KernelTests/AssertContentTrait.php \Drupal\KernelTests\AssertContentTrait::assertTextHelper()
3. 11.x core/tests/Drupal/KernelTests/AssertContentTrait.php \Drupal\KernelTests\AssertContentTrait::assertTextHelper()

Helper for assertText and assertNoText.

It is not recommended to call this function directly.

Parameters

string $text: Plain text to look for.

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

string $group: (optional) 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. Defaults to 'Other'.

bool $not_exists: (optional) TRUE if this text should not exist, FALSE if it should. Defaults to TRUE.

Return value

bool TRUE on pass, FALSE on fail.

2 calls to AssertContentTrait::assertTextHelper()

AssertContentTrait::assertNoText in core/tests/Drupal/KernelTests/AssertContentTrait.php

Passes if the page (with HTML stripped) does not contains the text.

AssertContentTrait::assertText in core/tests/Drupal/KernelTests/AssertContentTrait.php

Passes if the page (with HTML stripped) contains the text.

File

core/tests/Drupal/KernelTests/AssertContentTrait.php, line 626

Class

AssertContentTrait

Provides test methods to assert content.

Namespace

Drupal\KernelTests

Code

protected function assertTextHelper($text, $message = '', $group = 'Other', $not_exists = TRUE) {
    if (!$message) {
        $message = !$not_exists ? new FormattableMarkup('"@text" found', [
            '@text' => $text,
        ]) : new FormattableMarkup('"@text" not found', [
            '@text' => $text,
        ]);
    }
    if ($not_exists) {
        if ($this instanceof TestCase) {
            $this->assertStringNotContainsString((string) $text, $this->getTextContent(), $message);
        }
        else {
            return $this->assert(strpos($this->getTextContent(), (string) $text) === FALSE, $message, $group);
        }
    }
    else {
        if ($this instanceof TestCase) {
            $this->assertStringContainsString((string) $text, $this->getTextContent(), $message);
        }
        else {
            return $this->assert(strpos($this->getTextContent(), (string) $text) !== FALSE, $message, $group);
        }
    }
}

---