protected function DrupalWebTestCase::clickLink in SimpleTest 7

Same name and namespace in other branches

1. 6.2 drupal_web_test_case.php \DrupalWebTestCase::clickLink()
2. 7.2 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.

2 calls to DrupalWebTestCase::clickLink()

ActionsConfigurationTestCase::testActionConfiguration in tests/actions.test

Test the configuration of advanced actions through the administration interface.

SimpleTestURLTestCase::testGetAbsoluteUrl in ./simpletest.test

Test DrupalWebTestCase::getAbsoluteUrl().

File

./drupal_web_test_case.php, line 1779

Class

DrupalWebTestCase

Test case for typical Drupal tests.

Code

protected function clickLink($label, $index = 0) {
  $url_before = $this
    ->getUrl();
  $urls = $this
    ->xpath('//a[text()="' . $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;
}