You are here

protected function AssertContentTrait::assertFieldByName in Drupal 9

Same name and namespace in other branches
  1. 8 core/tests/Drupal/KernelTests/AssertContentTrait.php \Drupal\KernelTests\AssertContentTrait::assertFieldByName()

Asserts that a field exists with the given name and value.

Parameters

string $name: Name of field to assert.

string $value: (optional) Value of the field to assert. You may pass in NULL (default) to skip checking the actual value, while still checking that the field exists.

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 'Browser'; most tests do not override this default.

Return value

bool TRUE on pass, FALSE on fail.

1 call to AssertContentTrait::assertFieldByName()
TextFormatElementFormTest::testTextFormatElement in core/modules/filter/tests/src/Kernel/TextFormatElementFormTest.php
Tests that values are returned.

File

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

Class

AssertContentTrait
Provides test methods to assert content.

Namespace

Drupal\KernelTests

Code

protected function assertFieldByName($name, $value = NULL, $message = NULL, $group = 'Browser') {
  if (!isset($message)) {
    if (!isset($value)) {
      $message = new FormattableMarkup('Found field with name @name', [
        '@name' => var_export($name, TRUE),
      ]);
    }
    else {
      $message = new FormattableMarkup('Found field with name @name and value @value', [
        '@name' => var_export($name, TRUE),
        '@value' => var_export($value, TRUE),
      ]);
    }
  }
  return $this
    ->assertFieldByXPath($this
    ->constructFieldXpath('name', $name), $value, $message, $group);
}