1.20.x backdrop_web_test_case.php protected BackdropWebTestCase::assertFieldByXPath($xpath, $value = NULL, $message = '', $group = 'Other')

Asserts that a field exists in the current page by the given XPath.

Parameters

$xpath: XPath used to find the field.

$value: (optional) Value of the field to assert.

$message: (optional) Message to display.

$group: (optional) The group this message belongs to.

Return value

TRUE on pass, FALSE on fail.:

File

modules/simpletest/backdrop_web_test_case.php, line 3516

Class

BackdropWebTestCase
Test case for typical Backdrop tests.

Code

protected function assertFieldByXPath($xpath, $value = NULL, $message = '', $group = 'Other') {
  $fields = $this->xpath($xpath);

  // If value specified then check array for match.
  $found = TRUE;
  if (isset($value)) {
    $found = FALSE;
    if ($fields) {
      foreach ($fields as $field) {
        if (isset($field['value']) && $field['value'] == $value) {
          // Input element with correct value.
          $found = TRUE;
        }
        elseif (isset($field->option)) {
          // Select element found.
          if ($this->getSelectedItem($field) == $value) {
            $found = TRUE;
          }
          else {
            // No item selected so use first item.
            $items = $this->getAllOptions($field);
            if (!empty($items) && $items[0]['value'] == $value) {
              $found = TRUE;
            }
          }
        }
        elseif ((string) $field == $value) {
          // Text area with correct text.
          $found = TRUE;
        }
      }
    }
  }
  return $this->assertTrue($fields && $found, $message, $group);
}