silverstripe-framework/tests/behat/src/CmsFormsContext.php

449 lines
14 KiB
PHP
Raw Normal View History

<?php
2017-01-20 03:57:50 +01:00
namespace SilverStripe\Framework\Tests\Behaviour;
use BadMethodCallException;
2017-01-20 03:57:50 +01:00
use Behat\Behat\Context\Context;
2016-01-25 16:17:57 +01:00
use Behat\Mink\Exception\ElementHtmlException;
use Behat\Gherkin\Node\TableNode;
use Behat\Mink\Session;
2017-01-20 03:57:50 +01:00
use SilverStripe\BehatExtension\Context\MainContextAwareTrait;
use SilverStripe\BehatExtension\Utility\StepHelper;
2013-09-15 01:50:10 +02:00
use Symfony\Component\DomCrawler\Crawler;
2016-11-29 13:45:41 +01:00
use Behat\Mink\Element\NodeElement;
use SilverStripe\SiteConfig\SiteConfig;
/**
* CmsFormsContext
*
* Context used to define steps related to forms inside CMS.
*/
2017-01-20 03:57:50 +01:00
class CmsFormsContext implements Context
{
2017-01-20 03:57:50 +01:00
use MainContextAwareTrait;
use StepHelper;
/**
* Get Mink session from MinkContext
*
* @param string $name
* @return Session
*/
public function getSession($name = null)
{
return $this->getMainContext()->getSession($name);
}
/**
* Returns fixed step argument (with \\" replaced back to ").
* Copied from {@see MinkContext}
*
* @param string $argument
* @return string
*/
protected function fixStepArgument($argument)
{
return str_replace('\\"', '"', $argument);
}
2014-09-12 05:09:12 +02:00
/**
* @Then /^I should( not? |\s*)see an edit page form$/
*/
public function stepIShouldSeeAnEditPageForm($negative)
{
$page = $this->getSession()->getPage();
$form = $page->find('css', '#Form_EditForm');
if (trim($negative)) {
assertNull($form, 'I should not see an edit page form');
} else {
assertNotNull($form, 'I should see an edit page form');
}
}
2014-09-12 05:09:12 +02:00
/**
* @When /^I fill in the "(?P<field>(?:[^"]|\\")*)" HTML field with "(?P<value>(?:[^"]|\\")*)"$/
* @When /^I fill in "(?P<value>(?:[^"]|\\")*)" for the "(?P<field>(?:[^"]|\\")*)" HTML field$/
*/
public function stepIFillInTheHtmlFieldWith($field, $value)
{
$inputField = $this->getHtmlField($field);
$value = $this->fixStepArgument($value);
$this->getSession()->evaluateScript(sprintf(
"jQuery('#%s').entwine('ss').getEditor().setContent('%s')",
$inputField->getAttribute('id'),
addcslashes($value, "'")
));
}
/**
* @When /^I append "(?P<value>(?:[^"]|\\")*)" to the "(?P<field>(?:[^"]|\\")*)" HTML field$/
*/
public function stepIAppendTotheHtmlField($field, $value)
{
$inputField = $this->getHtmlField($field);
$value = $this->fixStepArgument($value);
$this->getSession()->evaluateScript(sprintf(
"jQuery('#%s').entwine('ss').getEditor().insertContent('%s')",
$inputField->getAttribute('id'),
addcslashes($value, "'")
));
}
/**
* @Then /^the "(?P<locator>(?:[^"]|\\")*)" HTML field should(?P<negative> not? |\s*)contain "(?P<html>.*)"$/
*/
public function theHtmlFieldShouldContain($locator, $negative, $html)
{
$element = $this->getHtmlField($locator);
$actual = $element->getValue();
$regex = '/' . preg_quote($html, '/') . '/ui';
$failed = false;
if (trim($negative)) {
if (preg_match($regex, $actual)) {
$failed = true;
}
} else {
if (!preg_match($regex, $actual)) {
$failed = true;
}
}
if ($failed) {
$message = sprintf(
'The string "%s" should%sbe found in the HTML of the element matching name "%s". Actual content: "%s"',
$html,
$negative,
$locator,
$actual
);
throw new ElementHtmlException($message, $this->getSession(), $element);
}
}
2013-04-09 09:39:06 +02:00
2014-03-30 08:51:38 +02:00
// @codingStandardsIgnoreStart
2013-09-15 01:50:10 +02:00
/**
* Checks formatting in the HTML field, by analyzing the HTML node surrounding
* the text for certain properties.
2014-08-15 08:53:05 +02:00
*
2013-09-15 01:50:10 +02:00
* Example: Given "my text" in the "Content" HTML field should be right aligned
* Example: Given "my text" in the "Content" HTML field should not be bold
*
* @todo Use an actual DOM parser for more accurate assertions
2014-08-15 08:53:05 +02:00
*
2014-09-12 05:09:12 +02:00
* @Given /^"(?P<text>([^"]*))" in the "(?P<field>(?:[^"]|\\")*)" HTML field should(?P<negate>(?: not)?) be (?P<formatting>(.*))$/
2013-09-15 01:50:10 +02:00
*/
public function stepContentInHtmlFieldShouldHaveFormatting($text, $field, $negate, $formatting) {
$inputField = $this->getHtmlField($field);
2013-09-15 01:50:10 +02:00
$crawler = new Crawler($inputField->getValue());
$matchedNode = null;
foreach($crawler->filterXPath('//*') as $node) {
if(
$node->firstChild
&& $node->firstChild->nodeType == XML_TEXT_NODE
&& stripos($node->firstChild->nodeValue, $text) !== FALSE
) {
$matchedNode = $node;
}
}
assertNotNull($matchedNode);
$assertFn = $negate ? 'assertNotEquals' : 'assertEquals';
if($formatting == 'bold') {
call_user_func($assertFn, 'strong', $matchedNode->nodeName);
} else if($formatting == 'left aligned') {
if($matchedNode->getAttribute('style')) {
2014-08-15 08:53:05 +02:00
call_user_func($assertFn, 'text-align: left;', $matchedNode->getAttribute('style'));
2013-09-15 01:50:10 +02:00
}
} else if($formatting == 'right aligned') {
2014-08-15 08:53:05 +02:00
call_user_func($assertFn, 'text-align: right;', $matchedNode->getAttribute('style'));
2013-09-15 01:50:10 +02:00
}
}
2014-03-30 08:51:38 +02:00
// @codingStandardsIgnoreEnd
2013-09-15 01:50:10 +02:00
/**
* Selects the first textual match in the HTML editor. Does not support
* selection across DOM node boundaries.
*
* @When /^I select "(?P<text>([^"]*))" in the "(?P<field>(?:[^"]|\\")*)" HTML field$/
*/
public function stepIHighlightTextInHtmlField($text, $field)
{
$inputField = $this->getHtmlField($field);
$inputFieldId = $inputField->getAttribute('id');
$text = addcslashes($text, "'");
2013-09-14 18:32:29 +02:00
$js = <<<JS
2013-09-14 18:32:29 +02:00
// TODO <IE9 support
// TODO Allow text matches across nodes
2014-08-15 08:53:05 +02:00
var editor = jQuery('#$inputFieldId').entwine('ss').getEditor(),
doc = editor.getInstance().getDoc(),
2013-09-14 18:32:29 +02:00
sel = editor.getInstance().selection,
rng = document.createRange(),
matched = false;
editor.getInstance().focus();
2013-09-14 18:32:29 +02:00
jQuery(doc).find('body *').each(function() {
if(!matched) {
for(var i=0;i<this.childNodes.length;i++) {
if(!matched && this.childNodes[i].nodeValue && this.childNodes[i].nodeValue.match('$text')) {
rng.setStart(this.childNodes[i], this.childNodes[i].nodeValue.indexOf('$text'));
rng.setEnd(this.childNodes[i], this.childNodes[i].nodeValue.indexOf('$text') + '$text'.length);
sel.setRng(rng);
editor.getInstance().nodeChanged();
matched = true;
break;
}
}
2013-09-14 18:32:29 +02:00
}
});
JS;
$this->getSession()->executeScript($js);
}
2013-09-14 18:32:29 +02:00
/**
* @Given /^I should( not? |\s*)see a "([^"]*)" field$/
*/
public function iShouldSeeAField($negative, $text)
{
$page = $this->getSession()->getPage();
$els = $page->findAll('named', array('field', "'$text'"));
$matchedEl = null;
/** @var NodeElement $el */
foreach ($els as $el) {
if ($el->isVisible()) {
$matchedEl = $el;
}
}
2013-12-02 18:35:21 +01:00
if (trim($negative)) {
assertNull($matchedEl);
} else {
assertNotNull($matchedEl);
}
}
/**
* Click on the element with the provided CSS Selector
*
* @When /^I press the "([^"]*)" HTML field button$/
*/
public function iClickOnTheHtmlFieldButton($button)
{
$xpath = "//*[@aria-label='" . $button . "']";
$session = $this->getSession();
$element = $session->getPage()->find('xpath', $xpath);
if (null === $element) {
throw new \InvalidArgumentException(sprintf('Could not find element with xpath %s', $xpath));
}
$element->click();
}
/*
2017-12-14 02:18:41 +01:00
* @example Given the CMS settings has the following data
* | Title | My site title |
* | Theme | My site theme |
* @Given /^the CMS settings have the following data$/
*/
public function theCmsSettingsHasData(TableNode $fieldsTable)
{
$fields = $fieldsTable->getRowsHash();
$siteConfig = SiteConfig::get()->first();
foreach ($fields as $field => $value) {
$siteConfig->$field = $value;
}
$siteConfig->write();
$siteConfig->flushCache();
}
2017-07-28 03:34:49 +02:00
/**
* Select a value in the tree dropdown field
*
* NOTE: This is react specific, may need to move to its own react section later
*
* @When /^I select "([^"]*)" in the "([^"]*)" tree dropdown$/
*/
public function iSelectValueInTreeDropdown($text, $selector)
{
$page = $this->getSession()->getPage();
/** @var NodeElement $parentElement */
2017-07-28 03:34:49 +02:00
$parentElement = null;
$this->retryThrowable(function () use (&$parentElement, &$page, $selector) {
$parentElement = $page->find('css', $selector);
assertNotNull($parentElement, sprintf('"%s" element not found', $selector));
$page = $this->getSession()->getPage();
});
$this->retryThrowable(function () use ($parentElement, $selector) {
$dropdown = $parentElement->find('css', '.Select-arrow');
assertNotNull($dropdown, sprintf('Unable to find the dropdown in "%s"', $selector));
$dropdown->click();
});
$this->retryThrowable(function () use ($text, $parentElement, $selector) {
$element = $parentElement->find('xpath', sprintf('//*[count(*)=0 and contains(.,"%s")]', $text));
assertNotNull($element, sprintf('"%s" not found in "%s"', $text, $selector));
$element->click();
});
}
2017-07-28 03:34:49 +02:00
/**
* Locate an HTML editor field
*
* @param string $locator Raw html field identifier as passed from
* @return NodeElement
*/
protected function getHtmlField($locator)
{
$locator = $this->fixStepArgument($locator);
$page = $this->getSession()->getPage();
$element = $page->find('css', 'textarea.htmleditor[name=\'' . $locator . '\']');
assertNotNull($element, sprintf('HTML field "%s" not found', $locator));
return $element;
}
/**
* @Given /^the "([^"]*)" field ((?:does not have)|(?:has)) property "([^"]*)"$/
*/
public function assertTheFieldHasProperty($name, $cond, $property)
{
$name = $this->fixStepArgument($name);
$property = $this->fixStepArgument($property);
$context = $this->getMainContext();
$fieldObj = $context->assertSession()->fieldExists($name);
// Check property
$hasProperty = $fieldObj->hasAttribute($property);
switch ($cond) {
case 'has':
assert($hasProperty, "Field $name does not have property $property");
break;
case 'does not have':
assert(!$hasProperty, "Field $name should not have property $property");
break;
default:
throw new BadMethodCallException("Invalid condition");
}
}
/**
* @When /^I switch to the "([^"]*)" iframe$/
* @param string $id iframe id property
*/
public function stepSwitchToTheFrame($id)
{
$this->getMainContext()->getSession()->getDriver()->switchToIFrame($id);
}
/**
* @When /^I am not in an iframe$/
*/
public function stepSwitchToParentFrame()
{
$this->getMainContext()->getSession()->getDriver()->switchToIFrame(null);
}
/**
* @When /^my session expires$/
*/
public function stepMySessionExpires()
{
// Destroy cookie to detach session
$this->getMainContext()->getSession()->setCookie('PHPSESSID', null);
}
/**
* @When /^I should see the "([^"]*)" button in the "([^"]*)" gridfield for the "([^"]*)" row$/
* @param string $buttonLabel
* @param string $gridFieldName
* @param string $rowName
*/
public function assertIShouldSeeTheGridFieldButtonForRow($buttonLabel, $gridFieldName, $rowName)
{
$button = $this->getGridFieldButton($gridFieldName, $rowName, $buttonLabel);
assertNotNull($button, sprintf('Button "%s" not found', $buttonLabel));
}
/**
* @When /^I should not see the "([^"]*)" button in the "([^"]*)" gridfield for the "([^"]*)" row$/
* @param string $buttonLabel
* @param string $gridFieldName
* @param string $rowName
*/
public function assertIShouldNotSeeTheGridFieldButtonForRow($buttonLabel, $gridFieldName, $rowName)
{
$button = $this->getGridFieldButton($gridFieldName, $rowName, $buttonLabel);
2017-10-30 05:30:41 +01:00
assertNull($button, sprintf('Button "%s" found', $buttonLabel));
}
/**
* @When /^I click the "([^"]*)" button in the "([^"]*)" gridfield for the "([^"]*)" row$/
* @param string $buttonLabel
* @param string $gridFieldName
* @param string $rowName
*/
public function stepIClickTheGridFieldButtonForRow($buttonLabel, $gridFieldName, $rowName)
{
$button = $this->getGridFieldButton($gridFieldName, $rowName, $buttonLabel);
assertNotNull($button, sprintf('Button "%s" not found', $buttonLabel));
$button->click();
}
/**
* Finds a button in the gridfield row
*
* @param $gridFieldName
* @param $rowName
* @param $buttonLabel
* @return $button
*/
protected function getGridFieldButton($gridFieldName, $rowName, $buttonLabel)
{
$page = $this->getSession()->getPage();
$gridField = $page->find('xpath', sprintf('//*[@data-name="%s"]', $gridFieldName));
assertNotNull($gridField, sprintf('Gridfield "%s" not found', $gridFieldName));
$name = $gridField->find('xpath', sprintf('//*[count(*)=0 and contains(.,"%s")]', $rowName));
if (!$name) {
return null;
}
if ($dropdownButton = $name->getParent()->find('css', '.action-menu__toggle')) {
$dropdownButton->click();
}
$button = $name->getParent()->find('named', array('link_or_button', $buttonLabel));
return $button;
}
/**
* @When /^I click the "([^"]*)" option in the "([^"]*)" listbox$/
* @param $optionLabel
* @param $fieldName
*/
public function stepIClickTheListBoxOption($optionLabel, $fieldName)
{
$page = $this->getSession()->getPage();
$listBox = $page->find('xpath', sprintf('//*[@name="%s[]"]', $fieldName));
assertNotNull($listBox, sprintf('The listbox %s is not found', $fieldName));
$option = $listBox->getParent()
->find('css', '.chosen-choices')
->find('xpath', sprintf('//*[count(*)=0 and contains(.,"%s")]', $optionLabel));
assertNotNull($option, sprintf('Option %s is not found', $optionLabel));
$button = $option->getParent()->find('css', 'a');
$button->click();
}
}