function DrupalWebTestCase::assertLinkByHref

Pass if a link containing a given href (part) is found.

Parameters

$href: The full or partial value of the 'href' attribute of the anchor tag.

$index: Link position counting from zero.

$message: Message to display.

$group: The group this message belongs to, defaults to 'Other'.

Return value

TRUE if the assertion succeeded, FALSE otherwise.

2 calls to DrupalWebTestCase::assertLinkByHref()
MenuUpgradePathTestCase::testMenuUpgrade in modules/simpletest/tests/upgrade/upgrade.menu.test
Test a successful upgrade.
ShortcutLinksTestCase::testShortcutLinkChangePath in modules/shortcut/shortcut.test
Tests that changing the path of a shortcut link works.

File

modules/simpletest/drupal_web_test_case.php, line 3016

Class

DrupalWebTestCase
Test case for typical Drupal tests.

Code

protected function assertLinkByHref($href, $index = 0, $message = '', $group = 'Other') {
  $links = $this->xpath('//a[contains(@href, :href)]', array(
    ':href' => $href,
  ));
  $message = $message ? $message : t('Link containing href %href found.', array(
    '%href' => $href,
  ));
  return $this->assert(isset($links[$index]), $message, $group);
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.