Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.0.x will end 8 May 2023 (12 months).
  • Bug fixes for security issues in 4.0.x will end 13 November 2023 (18 months).
  • PHP version: minimum PHP 7.3.0 Note: the minimum PHP version has increased since Moodle 3.10. PHP 7.4.x is also supported.

A class for recording the definition of Mink replacements.

Copyright: 2019 Andrew Nicols <andrew@nicols.co.uk>
License: http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
File Size: 99 lines (3 kb)
Included or required: 1 time
Referenced: 0 times
Includes or requires: 0 files

Defines 1 class

behat_component_named_replacement:: (3 methods):
  __construct()
  get_from()
  get_to()


Class: behat_component_named_replacement  - X-Ref

A class for recording the definition of Mink replacements for use in Mink selectors.

These are comprised of a source string, and a replacement.

During use the source string is converted from the string to be in the format:

%[component]/[string]%

For example:

%mod_forum/title%

Mink replacements are used in xpath translation to translate regularly used items such as title.
Here is an example from the upstream Mink project:

'%tagTextMatch%' => 'contains(normalize-space(string(.)), %locator%)'

And can be used in an xpath:

.//label[%tagTextMatch%]

This would be expanded to:

.//label[contains(normalize-space(string(.)), %locator%)]

Replacements can also be used in other replacements, as long as that replacement is defined later.

'%linkMatch%' => '(%idMatch% or %tagTextMatch% or %titleMatch% or %relMatch%)'

__construct(string $from, string $to)   X-Ref
Create the replacement.

param: string $from this is the old selector that should no longer be used.
param: string $to this is the new equivalent that should be used instead.

get_from(string $component)   X-Ref
Get the 'from' part of the replacement, formatted for the component.

return: string
param: string $component

get_to()   X-Ref
Get the 'to' part of the replacement.

return: string Target xpath