X-Git-Url: http://aleph1.co.uk/gitweb/?a=blobdiff_plain;ds=sidebyside;f=web%2Fcore%2Fmodules%2Fsimpletest%2Fsrc%2FAssertContentTrait.php;fp=web%2Fcore%2Fmodules%2Fsimpletest%2Fsrc%2FAssertContentTrait.php;h=5a6c8c06ef5ed68c78fec8ff82650967a607d345;hb=a2bd1bf0c2c1f1a17d188f4dc0726a45494cefae;hp=0000000000000000000000000000000000000000;hpb=57c063afa3f66b07c4bbddc2d6129a96d90f0aad;p=yaffs-website diff --git a/web/core/modules/simpletest/src/AssertContentTrait.php b/web/core/modules/simpletest/src/AssertContentTrait.php new file mode 100644 index 000000000..5a6c8c06e --- /dev/null +++ b/web/core/modules/simpletest/src/AssertContentTrait.php @@ -0,0 +1,1496 @@ +content; + } + + /** + * Sets the raw content (e.g. HTML). + * + * @param string $content + * The raw content to set. + */ + protected function setRawContent($content) { + $this->content = $content; + $this->plainTextContent = NULL; + $this->elements = NULL; + $this->drupalSettings = []; + if (preg_match('@@', $content, $matches)) { + $this->drupalSettings = Json::decode($matches[1]); + } + } + + /** + * Retrieves the plain-text content from the current raw content. + */ + protected function getTextContent() { + if (!isset($this->plainTextContent)) { + $raw_content = $this->getRawContent(); + // Strip everything between the HEAD tags. + $raw_content = preg_replace('@
(.+?)@si', '', $raw_content); + $this->plainTextContent = Xss::filter($raw_content, []); + } + return $this->plainTextContent; + } + + /** + * Removes all white-space between HTML tags from the raw content. + * + * White-space is only removed if there are no non-white-space characters + * between HTML tags. + * + * Use this (once) after performing an operation that sets new raw content, + * and when you want to use e.g. assertText() but ignore potential white-space + * caused by HTML output templates. + */ + protected function removeWhiteSpace() { + $this->content = preg_replace('@>\s+<@', '><', $this->content); + $this->plainTextContent = NULL; + $this->elements = NULL; + } + + /** + * Gets the value of drupalSettings for the currently-loaded page. + * + * drupalSettings refers to the drupalSettings JavaScript variable. + */ + protected function getDrupalSettings() { + return $this->drupalSettings; + } + + /** + * Sets the value of drupalSettings for the currently-loaded page. + * + * drupalSettings refers to the drupalSettings JavaScript variable. + */ + protected function setDrupalSettings($settings) { + $this->drupalSettings = $settings; + } + + /** + * Parse content returned from curlExec using DOM and SimpleXML. + * + * @return \SimpleXMLElement|false + * A SimpleXMLElement or FALSE on failure. + */ + protected function parse() { + if (!isset($this->elements)) { + // DOM can load HTML soup. But, HTML soup can throw warnings, suppress + // them. + $html_dom = new \DOMDocument(); + @$html_dom->loadHTML('' . $this->getRawContent()); + if ($html_dom) { + $this->pass(SafeMarkup::format('Valid HTML found on "@path"', ['@path' => $this->getUrl()]), 'Browser'); + // It's much easier to work with simplexml than DOM, luckily enough + // we can just simply import our DOM tree. + $this->elements = simplexml_import_dom($html_dom); + } + } + if ($this->elements === FALSE) { + $this->fail('Parsed page successfully.', 'Browser'); + } + + return $this->elements; + } + + /** + * Get the current URL from the cURL handler. + * + * @return string + * The current URL. + */ + protected function getUrl() { + return isset($this->url) ? $this->url : 'no-url'; + } + + /** + * Builds an XPath query. + * + * Builds an XPath query by replacing placeholders in the query by the value + * of the arguments. + * + * XPath 1.0 (the version supported by libxml2, the underlying XML library + * used by PHP) doesn't support any form of quotation. This function + * simplifies the building of XPath expression. + * + * @param string $xpath + * An XPath query, possibly with placeholders in the form ':name'. + * @param array $args + * An array of arguments with keys in the form ':name' matching the + * placeholders in the query. The values may be either strings or numeric + * values. + * + * @return string + * An XPath query with arguments replaced. + */ + protected function buildXPathQuery($xpath, array $args = []) { + // Replace placeholders. + foreach ($args as $placeholder => $value) { + // Cast MarkupInterface objects to string. + if (is_object($value)) { + $value = (string) $value; + } + // XPath 1.0 doesn't support a way to escape single or double quotes in a + // string literal. We split double quotes out of the string, and encode + // them separately. + if (is_string($value)) { + // Explode the text at the quote characters. + $parts = explode('"', $value); + + // Quote the parts. + foreach ($parts as &$part) { + $part = '"' . $part . '"'; + } + + // Return the string. + $value = count($parts) > 1 ? 'concat(' . implode(', \'"\', ', $parts) . ')' : $parts[0]; + } + + // Use preg_replace_callback() instead of preg_replace() to prevent the + // regular expression engine from trying to substitute backreferences. + $replacement = function ($matches) use ($value) { + return $value; + }; + $xpath = preg_replace_callback('/' . preg_quote($placeholder) . '\b/', $replacement, $xpath); + } + return $xpath; + } + + /** + * Performs an xpath search on the contents of the internal browser. + * + * The search is relative to the root element (HTML tag normally) of the page. + * + * @param string $xpath + * The xpath string to use in the search. + * @param array $arguments + * An array of arguments with keys in the form ':name' matching the + * placeholders in the query. The values may be either strings or numeric + * values. + * + * @return \SimpleXMLElement[]|bool + * The return value of the xpath search or FALSE on failure. For details on + * the xpath string format and return values see the SimpleXML + * documentation. + * + * @see http://php.net/manual/function.simplexml-element-xpath.php + */ + protected function xpath($xpath, array $arguments = []) { + if ($this->parse()) { + $xpath = $this->buildXPathQuery($xpath, $arguments); + $result = $this->elements->xpath($xpath); + // Some combinations of PHP / libxml versions return an empty array + // instead of the documented FALSE. Forcefully convert any falsish values + // to an empty array to allow foreach(...) constructions. + return $result ?: []; + } + return FALSE; + } + + /** + * Searches elements using a CSS selector in the raw content. + * + * The search is relative to the root element (HTML tag normally) of the page. + * + * @param string $selector + * CSS selector to use in the search. + * + * @return \SimpleXMLElement[] + * The return value of the XPath search performed after converting the CSS + * selector to an XPath selector. + */ + protected function cssSelect($selector) { + return $this->xpath((new CssSelectorConverter())->toXPath($selector)); + } + + /** + * Get all option elements, including nested options, in a select. + * + * @param \SimpleXMLElement $element + * The element for which to get the options. + * + * @return \SimpleXmlElement[] + * Option elements in select. + */ + protected function getAllOptions(\SimpleXMLElement $element) { + $options = []; + // Add all options items. + foreach ($element->option as $option) { + $options[] = $option; + } + + // Search option group children. + if (isset($element->optgroup)) { + foreach ($element->optgroup as $group) { + $options = array_merge($options, $this->getAllOptions($group)); + } + } + return $options; + } + + /** + * Passes if a link with the specified label is found. + * + * An optional link index may be passed. + * + * @param string|\Drupal\Component\Render\MarkupInterface $label + * Text between the anchor tags. + * @param int $index + * Link position counting from zero. + * @param string $message + * (optional) A message to display with the assertion. Do not translate + * messages: use strtr() to embed variables in the message text, not + * t(). If left blank, a default message will be displayed. + * @param string $group + * (optional) The group this message is in, which is displayed in a column + * in test output. Use 'Debug' to indicate this is debugging output. Do not + * translate this string. Defaults to 'Other'; most tests do not override + * this default. + * + * @return bool + * TRUE if the assertion succeeded, FALSE otherwise. + */ + protected function assertLink($label, $index = 0, $message = '', $group = 'Other') { + // Cast MarkupInterface objects to string. + $label = (string) $label; + $links = $this->xpath('//a[normalize-space(text())=:label]', [':label' => $label]); + $message = ($message ? $message : strtr('Link with label %label found.', ['%label' => $label])); + return $this->assert(isset($links[$index]), $message, $group); + } + + /** + * Passes if a link with the specified label is not found. + * + * @param string|\Drupal\Component\Render\MarkupInterface $label + * Text between the anchor tags. + * @param string $message + * (optional) A message to display with the assertion. Do not translate + * messages: use \Drupal\Component\Utility\SafeMarkup::format() to embed + * variables in the message text, not t(). If left blank, a default message + * will be displayed. + * @param string $group + * (optional) The group this message is in, which is displayed in a column + * in test output. Use 'Debug' to indicate this is debugging output. Do not + * translate this string. Defaults to 'Other'; most tests do not override + * this default. + * + * @return bool + * TRUE if the assertion succeeded, FALSE otherwise. + */ + protected function assertNoLink($label, $message = '', $group = 'Other') { + // Cast MarkupInterface objects to string. + $label = (string) $label; + $links = $this->xpath('//a[normalize-space(text())=:label]', [':label' => $label]); + $message = ($message ? $message : SafeMarkup::format('Link with label %label not found.', ['%label' => $label])); + return $this->assert(empty($links), $message, $group); + } + + /** + * Passes if a link containing a given href (part) is found. + * + * @param string $href + * The full or partial value of the 'href' attribute of the anchor tag. + * @param string $index + * Link position counting from zero. + * @param string $message + * (optional) A message to display with the assertion. Do not translate + * messages: use \Drupal\Component\Utility\SafeMarkup::format() to embed + * variables in the message text, not t(). If left blank, a default message + * will be displayed. + * @param string $group + * (optional) The group this message is in, which is displayed in a column + * in test output. Use 'Debug' to indicate this is debugging output. Do not + * translate this string. Defaults to 'Other'; most tests do not override + * this default. + * + * @return bool + * TRUE if the assertion succeeded, FALSE otherwise. + */ + protected function assertLinkByHref($href, $index = 0, $message = '', $group = 'Other') { + $links = $this->xpath('//a[contains(@href, :href)]', [':href' => $href]); + $message = ($message ? $message : SafeMarkup::format('Link containing href %href found.', ['%href' => $href])); + return $this->assert(isset($links[$index]), $message, $group); + } + + /** + * Passes if a link containing a given href (part) is not found. + * + * @param string $href + * The full or partial value of the 'href' attribute of the anchor tag. + * @param string $message + * (optional) A message to display with the assertion. Do not translate + * messages: use \Drupal\Component\Utility\SafeMarkup::format() to embed + * variables in the message text, not t(). If left blank, a default message + * will be displayed. + * @param string $group + * (optional) The group this message is in, which is displayed in a column + * in test output. Use 'Debug' to indicate this is debugging output. Do not + * translate this string. Defaults to 'Other'; most tests do not override + * this default. + * + * @return bool + * TRUE if the assertion succeeded, FALSE otherwise. + */ + protected function assertNoLinkByHref($href, $message = '', $group = 'Other') { + $links = $this->xpath('//a[contains(@href, :href)]', [':href' => $href]); + $message = ($message ? $message : SafeMarkup::format('No link containing href %href found.', ['%href' => $href])); + return $this->assert(empty($links), $message, $group); + } + + /** + * Passes if a link containing a given href is not found in the main region. + * + * @param string $href + * The full or partial value of the 'href' attribute of the anchor tag. + * @param string $message + * (optional) A message to display with the assertion. Do not translate + * messages: use \Drupal\Component\Utility\SafeMarkup::format() to embed + * variables in the message text, not t(). If left blank, a default message + * will be displayed. + * @param string $group + * (optional) The group this message is in, which is displayed in a column + * in test output. Use 'Debug' to indicate this is debugging output. Do not + * translate this string. Defaults to 'Other'; most tests do not override + * this default. + * + * @return bool + * TRUE if the assertion succeeded, FALSE otherwise. + */ + protected function assertNoLinkByHrefInMainRegion($href, $message = '', $group = 'Other') { + $links = $this->xpath('//main//a[contains(@href, :href)]', [':href' => $href]); + $message = ($message ? $message : SafeMarkup::format('No link containing href %href found.', ['%href' => $href])); + return $this->assert(empty($links), $message, $group); + } + + /** + * Passes if the raw text IS found on the loaded page, fail otherwise. + * + * Raw text refers to the raw HTML that the page generated. + * + * @param string $raw + * Raw (HTML) string to look for. + * @param string $message + * (optional) A message to display with the assertion. Do not translate + * messages: use \Drupal\Component\Utility\SafeMarkup::format() to embed + * variables in the message text, not t(). If left blank, a default message + * will be displayed. + * @param string $group + * (optional) The group this message is in, which is displayed in a column + * in test output. Use 'Debug' to indicate this is debugging output. Do not + * translate this string. Defaults to 'Other'; most tests do not override + * this default. + * + * @return bool + * TRUE on pass, FALSE on fail. + */ + protected function assertRaw($raw, $message = '', $group = 'Other') { + if (!$message) { + $message = 'Raw "' . Html::escape($raw) . '" found'; + } + return $this->assert(strpos($this->getRawContent(), (string) $raw) !== FALSE, $message, $group); + } + + /** + * Passes if the raw text is NOT found on the loaded page, fail otherwise. + * + * Raw text refers to the raw HTML that the page generated. + * + * @param string $raw + * Raw (HTML) string to look for. + * @param string $message + * (optional) A message to display with the assertion. Do not translate + * messages: use \Drupal\Component\Utility\SafeMarkup::format() to embed + * variables in the message text, not t(). If left blank, a default message + * will be displayed. + * @param string $group + * (optional) The group this message is in, which is displayed in a column + * in test output. Use 'Debug' to indicate this is debugging output. Do not + * translate this string. Defaults to 'Other'; most tests do not override + * this default. + * + * @return bool + * TRUE on pass, FALSE on fail. + */ + protected function assertNoRaw($raw, $message = '', $group = 'Other') { + if (!$message) { + $message = 'Raw "' . Html::escape($raw) . '" not found'; + } + return $this->assert(strpos($this->getRawContent(), (string) $raw) === FALSE, $message, $group); + } + + /** + * Passes if the raw text IS found escaped on the loaded page, fail otherwise. + * + * Raw text refers to the raw HTML that the page generated. + * + * @param string $raw + * Raw (HTML) string to look for. + * @param string $message + * (optional) A message to display with the assertion. Do not translate + * messages: use \Drupal\Component\Utility\SafeMarkup::format() to embed + * variables in the message text, not t(). If left blank, a default message + * will be displayed. + * @param string $group + * (optional) The group this message is in, which is displayed in a column + * in test output. Use 'Debug' to indicate this is debugging output. Do not + * translate this string. Defaults to 'Other'; most tests do not override + * this default. + * + * @return bool + * TRUE on pass, FALSE on fail. + */ + protected function assertEscaped($raw, $message = '', $group = 'Other') { + if (!$message) { + $message = 'Escaped "' . Html::escape($raw) . '" found'; + } + return $this->assert(strpos($this->getRawContent(), Html::escape($raw)) !== FALSE, $message, $group); + } + + /** + * Passes if the raw text IS NOT found escaped on the loaded page, fail + * otherwise. + * + * Raw text refers to the raw HTML that the page generated. + * + * @param string $raw + * Raw (HTML) string to look for. + * @param string $message + * (optional) A message to display with the assertion. Do not translate + * messages: use \Drupal\Component\Utility\SafeMarkup::format() to embed + * variables in the message text, not t(). If left blank, a default message + * will be displayed. + * @param string $group + * (optional) The group this message is in, which is displayed in a column + * in test output. Use 'Debug' to indicate this is debugging output. Do not + * translate this string. Defaults to 'Other'; most tests do not override + * this default. + * + * @return bool + * TRUE on pass, FALSE on fail. + */ + protected function assertNoEscaped($raw, $message = '', $group = 'Other') { + if (!$message) { + $message = 'Escaped "' . Html::escape($raw) . '" not found'; + } + return $this->assert(strpos($this->getRawContent(), Html::escape($raw)) === FALSE, $message, $group); + } + + /** + * Passes if the page (with HTML stripped) contains the text. + * + * Note that stripping HTML tags also removes their attributes, such as + * the values of text fields. + * + * @param string $text + * Plain text to look for. + * @param string $message + * (optional) A message to display with the assertion. Do not translate + * messages: use \Drupal\Component\Utility\SafeMarkup::format() to embed + * variables in the message text, not t(). If left blank, a default message + * will be displayed. + * @param string $group + * (optional) The group this message is in, which is displayed in a column + * in test output. Use 'Debug' to indicate this is debugging output. Do not + * translate this string. Defaults to 'Other'; most tests do not override + * this default. + * + * @return bool + * TRUE on pass, FALSE on fail. + * + * @see \Drupal\simpletest\AssertContentTrait::assertRaw() + */ + protected function assertText($text, $message = '', $group = 'Other') { + return $this->assertTextHelper($text, $message, $group, FALSE); + } + + /** + * Passes if the page (with HTML stripped) does not contains the text. + * + * Note that stripping HTML tags also removes their attributes, such as + * the values of text fields. + * + * @param string $text + * Plain text to look for. + * @param string $message + * (optional) A message to display with the assertion. Do not translate + * messages: use \Drupal\Component\Utility\SafeMarkup::format() to embed + * variables in the message text, not t(). If left blank, a default message + * will be displayed. + * @param string $group + * (optional) The group this message is in, which is displayed in a column + * in test output. Use 'Debug' to indicate this is debugging output. Do not + * translate this string. Defaults to 'Other'; most tests do not override + * this default. + * + * @return bool + * TRUE on pass, FALSE on fail. + * + * @see \Drupal\simpletest\AssertContentTrait::assertNoRaw() + */ + protected function assertNoText($text, $message = '', $group = 'Other') { + return $this->assertTextHelper($text, $message, $group, TRUE); + } + + /** + * Helper for assertText and assertNoText. + * + * It is not recommended to call this function directly. + * + * @param string $text + * Plain text to look for. + * @param string $message + * (optional) A message to display with the assertion. Do not translate + * messages: use \Drupal\Component\Utility\SafeMarkup::format() to embed + * variables in the message text, not t(). If left blank, a default message + * will be displayed. + * @param string $group + * (optional) The group this message is in, which is displayed in a column + * in test output. Use 'Debug' to indicate this is debugging output. Do not + * translate this string. Defaults to 'Other'; most tests do not override + * this default. Defaults to 'Other'. + * @param bool $not_exists + * (optional) TRUE if this text should not exist, FALSE if it should. + * Defaults to TRUE. + * + * @return bool + * TRUE on pass, FALSE on fail. + */ + protected function assertTextHelper($text, $message = '', $group = 'Other', $not_exists = TRUE) { + if (!$message) { + $message = !$not_exists ? SafeMarkup::format('"@text" found', ['@text' => $text]) : SafeMarkup::format('"@text" not found', ['@text' => $text]); + } + return $this->assert($not_exists == (strpos($this->getTextContent(), (string) $text) === FALSE), $message, $group); + } + + /** + * Passes if the text is found ONLY ONCE on the text version of the page. + * + * The text version is the equivalent of what a user would see when viewing + * through a web browser. In other words the HTML has been filtered out of + * the contents. + * + * @param string|\Drupal\Component\Render\MarkupInterface $text + * Plain text to look for. + * @param string $message + * (optional) A message to display with the assertion. Do not translate + * messages: use \Drupal\Component\Utility\SafeMarkup::format() to embed + * variables in the message text, not t(). If left blank, a default message + * will be displayed. + * @param string $group + * (optional) The group this message is in, which is displayed in a column + * in test output. Use 'Debug' to indicate this is debugging output. Do not + * translate this string. Defaults to 'Other'; most tests do not override + * this default. + * + * @return bool + * TRUE on pass, FALSE on fail. + */ + protected function assertUniqueText($text, $message = '', $group = 'Other') { + return $this->assertUniqueTextHelper($text, $message, $group, TRUE); + } + + /** + * Passes if the text is found MORE THAN ONCE on the text version of the page. + * + * The text version is the equivalent of what a user would see when viewing + * through a web browser. In other words the HTML has been filtered out of + * the contents. + * + * @param string|\Drupal\Component\Render\MarkupInterface $text + * Plain text to look for. + * @param string $message + * (optional) A message to display with the assertion. Do not translate + * messages: use \Drupal\Component\Utility\SafeMarkup::format() to embed + * variables in the message text, not t(). If left blank, a default message + * will be displayed. + * @param string $group + * (optional) The group this message is in, which is displayed in a column + * in test output. Use 'Debug' to indicate this is debugging output. Do not + * translate this string. Defaults to 'Other'; most tests do not override + * this default. + * + * @return bool + * TRUE on pass, FALSE on fail. + */ + protected function assertNoUniqueText($text, $message = '', $group = 'Other') { + return $this->assertUniqueTextHelper($text, $message, $group, FALSE); + } + + /** + * Helper for assertUniqueText and assertNoUniqueText. + * + * It is not recommended to call this function directly. + * + * @param string|\Drupal\Component\Render\MarkupInterface $text + * Plain text to look for. + * @param string $message + * (optional) A message to display with the assertion. Do not translate + * messages: use \Drupal\Component\Utility\SafeMarkup::format() to embed + * variables in the message text, not t(). If left blank, a default message + * will be displayed. + * @param string $group + * (optional) The group this message is in, which is displayed in a column + * in test output. Use 'Debug' to indicate this is debugging output. Do not + * translate this string. Defaults to 'Other'; most tests do not override + * this default. Defaults to 'Other'. + * @param bool $be_unique + * (optional) TRUE if this text should be found only once, FALSE if it + * should be found more than once. Defaults to FALSE. + * + * @return bool + * TRUE on pass, FALSE on fail. + */ + protected function assertUniqueTextHelper($text, $message = '', $group = 'Other', $be_unique = FALSE) { + // Cast MarkupInterface objects to string. + $text = (string) $text; + if (!$message) { + $message = '"' . $text . '"' . ($be_unique ? ' found only once' : ' found more than once'); + } + $first_occurrence = strpos($this->getTextContent(), $text); + if ($first_occurrence === FALSE) { + return $this->assert(FALSE, $message, $group); + } + $offset = $first_occurrence + strlen($text); + $second_occurrence = strpos($this->getTextContent(), $text, $offset); + return $this->assert($be_unique == ($second_occurrence === FALSE), $message, $group); + } + + /** + * Triggers a pass if the Perl regex pattern is found in the raw content. + * + * @param string $pattern + * Perl regex to look for including the regex delimiters. + * @param string $message + * (optional) A message to display with the assertion. Do not translate + * messages: use \Drupal\Component\Utility\SafeMarkup::format() to embed + * variables in the message text, not t(). If left blank, a default message + * will be displayed. + * @param string $group + * (optional) The group this message is in, which is displayed in a column + * in test output. Use 'Debug' to indicate this is debugging output. Do not + * translate this string. Defaults to 'Other'; most tests do not override + * this default. + * + * @return bool + * TRUE on pass, FALSE on fail. + */ + protected function assertPattern($pattern, $message = '', $group = 'Other') { + if (!$message) { + $message = SafeMarkup::format('Pattern "@pattern" found', ['@pattern' => $pattern]); + } + return $this->assert((bool) preg_match($pattern, $this->getRawContent()), $message, $group); + } + + /** + * Triggers a pass if the perl regex pattern is not found in raw content. + * + * @param string $pattern + * Perl regex to look for including the regex delimiters. + * @param string $message + * (optional) A message to display with the assertion. Do not translate + * messages: use \Drupal\Component\Utility\SafeMarkup::format() to embed + * variables in the message text, not t(). If left blank, a default message + * will be displayed. + * @param string $group + * (optional) The group this message is in, which is displayed in a column + * in test output. Use 'Debug' to indicate this is debugging output. Do not + * translate this string. Defaults to 'Other'; most tests do not override + * this default. + * + * @return bool + * TRUE on pass, FALSE on fail. + */ + protected function assertNoPattern($pattern, $message = '', $group = 'Other') { + if (!$message) { + $message = SafeMarkup::format('Pattern "@pattern" not found', ['@pattern' => $pattern]); + } + return $this->assert(!preg_match($pattern, $this->getRawContent()), $message, $group); + } + + /** + * Asserts that a Perl regex pattern is found in the plain-text content. + * + * @param string $pattern + * Perl regex to look for including the regex delimiters. + * @param string $message + * (optional) A message to display with the assertion. + * @param string $group + * (optional) The group this message is in, which is displayed in a column + * in test output. Use 'Debug' to indicate this is debugging output. Do not + * translate this string. Defaults to 'Other'; most tests do not override + * this default. + * + * @return bool + * TRUE on pass, FALSE on failure. + */ + protected function assertTextPattern($pattern, $message = NULL, $group = 'Other') { + if (!isset($message)) { + $message = SafeMarkup::format('Pattern "@pattern" found', ['@pattern' => $pattern]); + } + return $this->assert((bool) preg_match($pattern, $this->getTextContent()), $message, $group); + } + + /** + * Pass if the page title is the given string. + * + * @param string $title + * The string the title should be. + * @param string $message + * (optional) A message to display with the assertion. Do not translate + * messages: use \Drupal\Component\Utility\SafeMarkup::format() to embed + * variables in the message text, not t(). If left blank, a default message + * will be displayed. + * @param string $group + * (optional) The group this message is in, which is displayed in a column + * in test output. Use 'Debug' to indicate this is debugging output. Do not + * translate this string. Defaults to 'Other'; most tests do not override + * this default. + * + * @return bool + * TRUE on pass, FALSE on fail. + */ + protected function assertTitle($title, $message = '', $group = 'Other') { + // Don't use xpath as it messes with HTML escaping. + preg_match('@' . Html::escape(var_export($output, TRUE)) . '' + . '
' . Html::escape(var_export($expected, TRUE)) . '' + . '