function WebAssert::buttonNotExists

Same name and namespace in other branches
  1. 8.9.x core/tests/Drupal/Tests/WebAssert.php \Drupal\Tests\WebAssert::buttonNotExists()
  2. 10 core/tests/Drupal/Tests/WebAssert.php \Drupal\Tests\WebAssert::buttonNotExists()
  3. 11.x core/tests/Drupal/Tests/WebAssert.php \Drupal\Tests\WebAssert::buttonNotExists()

Checks that the specific button does NOT exist on the current page.

Parameters

string $button: One of id|name|label|value for the button.

\Behat\Mink\Element\TraversableElement $container: (optional) The document to check against. Defaults to the current page.

Throws

\Behat\Mink\Exception\ExpectationException When the button exists.

File

core/tests/Drupal/Tests/WebAssert.php, line 165

Class

WebAssert
Defines a class with methods for asserting presence of elements during tests.

Namespace

Drupal\Tests

Code

public function buttonNotExists($button, TraversableElement $container = NULL) {
    if (func_num_args() > 2) {
        @trigger_error('Calling ' . __METHOD__ . ' with more than two arguments is deprecated in drupal:9.1.0 and will throw an \\InvalidArgumentException in drupal:10.0.0. See https://www.drupal.org/node/3162537', E_USER_DEPRECATED);
    }
    $container = $container ?: $this->session
        ->getPage();
    $node = $container->findButton($button);
    $this->assert(NULL === $node, sprintf('A button "%s" appears on this page, but it should not.', $button));
}

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