protected function DrupalWebTestCase::clickLink in SimpleTest 6.2

Same name and namespace in other branches

1. 7.2 drupal_web_test_case.php \DrupalWebTestCase::clickLink()
2. 7 drupal_web_test_case.php \DrupalWebTestCase::clickLink()

Follows a link by name.

Will click the first link found with this link text by default, or a later one if an index is given. Match is case insensitive with normalized space. The label is translated label. There is an assert for successful click.

Parameters

$label: Text between the anchor tags.

$index: Link position counting from zero.

Return value

Page on success, or FALSE on failure.

1 call to DrupalWebTestCase::clickLink()

SimpleTestBrowserTestCase::testGetAbsoluteUrl in ./simpletest.test

Test DrupalWebTestCase::getAbsoluteUrl().

File

./drupal_web_test_case.php, line 2158

Class

DrupalWebTestCase

Test case for typical Drupal tests.

Code

protected function clickLink($label, $index = 0) {
  $url_before = $this
    ->getUrl();
  $urls = $this
    ->xpath('//a[normalize-space(text())=:label]', array(
    ':label' => $label,
  ));
  if (isset($urls[$index])) {
    $url_target = $this
      ->getAbsoluteUrl($urls[$index]['href']);
  }
  $this
    ->assertTrue(isset($urls[$index]), t('Clicked link %label (@url_target) from @url_before', array(
    '%label' => $label,
    '@url_target' => $url_target,
    '@url_before' => $url_before,
  )), t('Browser'));
  if (isset($url_target)) {
    return $this
      ->drupalGet($url_target);
  }
  return FALSE;
}