<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle. If not, see <http://www.gnu.org/licenses/>.
/**
* TinyMCE custom steps definitions.
*
* @package editor_tiny
* @category test
* @copyright 2022 Andrew Lyons <andrew@nicols.co.uk>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
use Behat\Behat\Hook\Scope\BeforeScenarioScope;
use Behat\Mink\Exception\DriverException;
use Behat\Mink\Exception\ExpectationException;
// NOTE: no MOODLE_INTERNAL test here, this file may be required by behat before including /config.php.
require_once(__DIR__ . '/../../../../behat/behat_base.php');
require_once(__DIR__ . '/editor_tiny_helpers.php');
/**
* TinyMCE custom behat step definitions.
*
* @package editor_tiny
* @category test
* @copyright 2022 Andrew Lyons <andrew@nicols.co.uk>
*/
class behat_editor_tiny extends behat_base implements \core_behat\settable_editor {
use editor_tiny_helpers;
/**
* Set Tiny as default editor before executing Tiny tests.
*
* This step is required to ensure that TinyMCE is set as the current default editor as it may
* not always be the default editor.
*
* Any Scenario, or Feature, which has the `editor_tiny` tag, or any `tiny_*` tag will have
* this step executed before the Scenario.
*
* @BeforeScenario
* @param BeforeScenarioScope $scope The Behat Scope
*/
public function set_default_editor_flag(BeforeScenarioScope $scope): void {
// This only applies to a scenario which matches the editor_tiny, or an tiny subplugin.
$callback = function (string $tag): bool {
return $tag === 'editor_tiny' || substr($tag, 0, 5) === 'tiny_';
};
if (!self::scope_tags_match($scope, $callback)) {
// This scope does not require TinyMCE. Exit now.
return;
}
// TinyMCE is a JavaScript editor so require JS here.
$this->require_javascript();
$this->execute('behat_general::the_default_editor_is_set_to', ['tiny']);
}
/**
* Click on a button for the specified TinyMCE editor.
*
* @When /^I click on the "(?P<button_string>(?:[^"]|\\")*)" button for the "(?P<locator_string>(?:[^"]|\\")*)" TinyMCE editor$/
*
* @param string $button The label of the button
* @param string $locator The locator for the editor
*/
public function i_click_on_button(string $button, string $locator): void {
$this->require_tiny_tags();
$container = $this->get_editor_container_for_locator($locator);
$this->execute('behat_general::i_click_on_in_the', [$button, 'button', $container, 'NodeElement']);
}
/**
* Confirm that the button state of the specified button/editor combination matches the expectation.
*
* @Then /^the "(?P<button_string>(?:[^"]|\\")*)" button of the "(?P<locator_string>(?:[^"]|\\")*)" TinyMCE editor has state "(?P<state_string>(?:[^"]|\\")*)"$/
*
* @param string $button The text name of the button
* @param string $locator The locator string for the editor
* @param string $state The state of the button
* @throws ExpectationException Thrown if the button state is not correct
*/
public function button_state_is(string $button, string $locator, string $state): void {
$this->require_tiny_tags();
$container = $this->get_editor_container_for_locator($locator);
$button = $this->find_button($button, false, $container);
$buttonstate = $button->getAttribute('aria-pressed');
if ($buttonstate !== $state) {
throw new ExpectationException("Button '{$button}' is in state '{$buttonstate}' not '{$state}'", $this->getSession());
}
}
/**
* Click on a button for the specified TinyMCE editor.
*
* @When /^I click on the "(?P<menuitem_string>(?:[^"]|\\")*)" menu item for the "(?P<locator_string>(?:[^"]|\\")*)" TinyMCE editor$/
*
* @param string $menuitem The label of the menu item
* @param string $locator The locator for the editor
*/
public function i_click_on_menuitem_in_menu(string $menuitem, string $locator): void {
$this->require_tiny_tags();
$container = $this->get_editor_container_for_locator($locator);
$menubar = $container->find('css', '[role="menubar"]');
$menus = array_map(function(string $value): string {
return trim($value);
}, explode('>', $menuitem));
// Open the menu bar.
$mainmenu = array_shift($menus);
$this->execute('behat_general::i_click_on_in_the', [$mainmenu, 'button', $menubar, 'NodeElement']);
foreach ($menus as $menuitem) {
// Find the menu that was opened.
$openmenu = $this->find('css', '.tox-selected-menu');
// Move the mouse to the first item in the list.
// This is required because WebDriver takes the shortest path to the next click location,
// which will mean crossing across other menu items.
$firstlink = $openmenu->find('css', "[role^='menuitem'] .tox-collection__item-icon");
$firstlink->mouseover();
// Now match by title where the role matches any menuitem, or menuitemcheckbox, or menuitem*.
$link = $openmenu->find('css', "[title='{$menuitem}'][role^='menuitem']");
$this->execute('behat_general::i_click_on', [$link, 'NodeElement']);
}
}
/**
* Select the element type/index for the specified TinyMCE editor.
*
* @When /^I select the "(?P<textlocator_string>(?:[^"]|\\")*)" element in position "(?P<position_int>(?:[^"]|\\")*)" of the "(?P<locator_string>(?:[^"]|\\")*)" TinyMCE editor$/
* @param string $textlocator The type of element to select (for example `p` or `span`)
* @param int $position The zero-indexed position
* @param string $locator The editor to select within
*/
public function select_text(string $textlocator, int $position, string $locator): void {
$this->require_tiny_tags();
$editor = $this->get_textarea_for_locator($locator);
$editorid = $editor->getAttribute('id');
// Ensure that a name is set on the iframe relating to the editorid.
$js = <<<EOF
< const element = instance.dom.select("${textlocator}")[${position}];
> const element = instance.dom.select("{$textlocator}")[{$position}];
instance.selection.select(element);
EOF;
$this->execute_javascript_for_editor($editorid, $js);
}
/**
* Upload a file in the file picker using the repository_upload plugin.
*
* Note: This step assumes we are already in the file picker.
* Note: This step is for use by TinyMCE and will be removed once an appropriate step is added to core.
* See MDL-76001 for details.
*
* @Given /^I upload "(?P<filepath_string>(?:[^"]|\\")*)" to the file picker for TinyMCE$/
*/
public function i_upload_a_file_in_the_filepicker(string $filepath): void {
if (!$this->has_tag('javascript')) {
throw new DriverException('The file picker is only available with javascript enabled');
}
if (!$this->has_tag('_file_upload')) {
throw new DriverException('File upload tests must have the @_file_upload tag on either the scenario or feature.');
}
if (!$this->has_tag('editor_tiny')) {
throw new DriverException('This step is intended for use in TinyMCE. Please vote for MDL-76001');
}
$filepicker = $this->find('dialogue', get_string('filepicker', 'core_repository'));
$this->execute('behat_general::i_click_on_in_the', [
get_string('pluginname', 'repository_upload'), 'link',
$filepicker, 'NodeElement',
]);
$reporegion = $filepicker->find('css', '.fp-repo-items');
$fileinput = $this->find('field', get_string('attachment', 'core_repository'), false, $reporegion);
$filepath = $this->normalise_fixture_filepath($filepath);
$fileinput->attachFile($filepath);
$this->execute('behat_general::i_click_on_in_the', [
get_string('upload', 'repository'), 'button',
$reporegion, 'NodeElement',
]);
}
/**
* Select in the editor.
*
* @param string $locator
* @param string $type
* @param string $editorlocator
*
* @Given /^I select the "(?P<locator_string>(?:[^"]|\\")*)" "(?P<type_string>(?:[^"]|\\")*)" in the "(?P<editorlocator_string>(?:[^"]|\\")*)" TinyMCE editor$/
*/
public function select_in_editor(string $locator, string $type, string $editorlocator): void {
$this->require_tiny_tags();
$editor = $this->get_textarea_for_locator($editorlocator);
$editorid = $editor->getAttribute('id');
// Get the iframe name for this editor.
$iframename = $this->get_editor_iframe_name($editorlocator);
// Switch to it.
$this->execute('behat_general::switch_to_iframe', [$iframename]);
// Find the element.
$element = $this->find($type, $locator);
$xpath = $element->getXpath();
// Switch back to the main window.
$this->execute('behat_general::switch_to_the_main_frame', []);
// Select the Node using the xpath.
$js = <<<EOF
const editorDocument = instance.getDoc();
const element = editorDocument.evaluate(
< "${xpath}",
> "{$xpath}",
editorDocument,
null,
XPathResult.FIRST_ORDERED_NODE_TYPE,
null
).singleNodeValue;
instance.selection.select(element);
EOF;
$this->execute_javascript_for_editor($editorid, $js);
}
/**
* Expand all of the TinyMCE toolbars.
*
* @Given /^I expand all toolbars for the "(?P<editorlocator_string>(?:[^"]|\\")*)" TinyMCE editor$/
*
* @param string $locator
*/
public function expand_all_toolbars(string $editorlocator): void {
$this->require_tiny_tags();
$editor = $this->get_editor_container_for_locator($editorlocator);
try {
$button = $this->find('button', get_string('tiny:more...', 'editor_tiny'), false, $editor);
} catch (ExpectationException $e) {
// No more button, so no need to expand.
return;
}
if ($button->getAttribute(('aria-pressed')) === 'false') {
$this->execute('behat_general::i_click_on', [$button, 'NodeElement']);
}
}
/**
* Switch to the TinyMCE iframe using a selector.
*
* @param string $editorlocator
*
* @When /^I switch to the "(?P<editorlocator_string>(?:[^"]|\\")*)" TinyMCE editor iframe$/
*/
public function switch_to_tiny_iframe(string $editorlocator): void {
$this->require_tiny_tags();
// Get the iframe name for this editor.
$iframename = $this->get_editor_iframe_name($editorlocator);
// Switch to it.
$this->execute('behat_general::switch_to_iframe', [$iframename]);
}
}