function TourTestBase::assertTourTips

Asserts the presence of page elements for tour tips.

// Basic example.
$this->assertTourTips();
// Advanced example. The following would be used for multipage or
// targeting a specific subset of tips.
$tips = array();
$tips[] = array(
    'data-id' => 'foo',
);
$tips[] = array(
    'data-id' => 'bar',
);
$tips[] = array(
    'data-class' => 'baz',
);
$this->assertTourTips($tips);

Parameters

array $tips: A list of tips which provide either a "data-id" or "data-class".

File

core/modules/tour/tests/src/Functional/TourTestBase.php, line 32

Class

TourTestBase

Base class for testing Tour functionality.

Namespace

Code

public function assertTourTips($tips = []) {
    // Get the rendered tips and their data-id and data-class attributes.
    if (empty($tips)) {
        // Tips are rendered as drupalSettings values.
        $drupalSettings = $this->getDrupalSettings();
        if (isset($drupalSettings['_tour_internal'])) {
            foreach ($drupalSettings['_tour_internal'] as $tip) {
                $tips[] = [
                    'selector' => $tip['selector'] ?? NULL,
                ];
            }
        }
    }
    // If the tips are still empty we need to fail.
    if (empty($tips)) {
        $this->fail('Could not find tour tips on the current page.');
    }
    else {
        // Check for corresponding page elements.
        $total = 0;
        $modals = 0;
        foreach ($tips as $tip) {
            if (!empty($tip['data-id'])) {
                $elements = $this->getSession()
                    ->getPage()
                    ->findAll('css', '#' . $tip['data-id']);
                $this->assertCount(1, $elements, new FormattableMarkup('Found corresponding page element for tour tip with id #%data-id', [
                    '%data-id' => $tip['data-id'],
                ]));
            }
            elseif (!empty($tip['data-class'])) {
                $elements = $this->getSession()
                    ->getPage()
                    ->findAll('css', '.' . $tip['data-class']);
                $this->assertNotEmpty($elements, sprintf("Page element for tour tip with class .%s should be present", $tip['data-class']));
            }
            else {
                // It's a modal.
                $modals++;
            }
            $total++;
        }
    }
}