function AssertBreadcrumbTrait::assertBreadcrumb

Same name in this branch
  1. 8.9.x core/modules/system/src/Tests/Menu/AssertBreadcrumbTrait.php \Drupal\system\Tests\Menu\AssertBreadcrumbTrait::assertBreadcrumb()
Same name and namespace in other branches
  1. 11.x core/modules/system/tests/src/Functional/Menu/AssertBreadcrumbTrait.php \Drupal\Tests\system\Functional\Menu\AssertBreadcrumbTrait::assertBreadcrumb()
  2. 10 core/modules/system/tests/src/Functional/Menu/AssertBreadcrumbTrait.php \Drupal\Tests\system\Functional\Menu\AssertBreadcrumbTrait::assertBreadcrumb()
  3. 9 core/modules/system/tests/src/Functional/Menu/AssertBreadcrumbTrait.php \Drupal\Tests\system\Functional\Menu\AssertBreadcrumbTrait::assertBreadcrumb()

Assert that a given path shows certain breadcrumb links.

Parameters

\Drupal\Core\Url|string $goto: (optional) A path or URL to pass to Drupal\simpletest\WebTestBase::drupalGet().

array $trail: An associative array whose keys are expected breadcrumb link paths and whose values are expected breadcrumb link texts (not sanitized).

string $page_title: (optional) A page title to additionally assert via Drupal\simpletest\WebTestBase::assertTitle(). Without site name suffix.

array $tree: (optional) An associative array whose keys are link paths and whose values are link titles (not sanitized) of an expected active trail in a menu tree output on the page.

$last_active: (optional) Whether the last link in $tree is expected to be active (TRUE) or just to be in the active trail (FALSE).

File

core/modules/system/tests/src/Functional/Menu/AssertBreadcrumbTrait.php, line 36

Class

AssertBreadcrumbTrait
Provides test assertions for verifying breadcrumbs.

Namespace

Drupal\Tests\system\Functional\Menu

Code

protected function assertBreadcrumb($goto, array $trail, $page_title = NULL, array $tree = [], $last_active = TRUE) {
  if (isset($goto)) {
    $this->drupalGet($goto);
  }
  $this->assertBreadcrumbParts($trail);
  // Additionally assert page title, if given.
  if (isset($page_title)) {
    $this->assertTitle("{$page_title} | Drupal");
  }
  // Additionally assert active trail in a menu tree output, if given.
  if ($tree) {
    $this->assertMenuActiveTrail($tree, $last_active);
  }
}

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