public function WebAssert::linkExistsExact in Drupal 10

Same name and namespace in other branches

1. 8 core/tests/Drupal/Tests/WebAssert.php \Drupal\Tests\WebAssert::linkExistsExact()
2. 9 core/tests/Drupal/Tests/WebAssert.php \Drupal\Tests\WebAssert::linkExistsExact()

Passes if a link with the exactly specified label is found.

An optional link index may be passed.

Parameters

string $label: Text between the anchor tags.

int $index: Link position counting from zero.

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

Throws

\Behat\Mink\Exception\ExpectationException Thrown when element doesn't exist, or the link label is a different one.

File

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

Class

WebAssert

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

Namespace

Drupal\Tests

Code

public function linkExistsExact($label, $index = 0, $message = '') {
  $message = $message ? $message : strtr('Link with label %label found.', [
    '%label' => $label,
  ]);
  $links = $this->session
    ->getPage()
    ->findAll('named_exact', [
    'link',
    $label,
  ]);
  $this
    ->assert(!empty($links[$index]), $message);
}