Moodle APIs  3.8
Moodle 3.8.6 (Build: 20201109)
Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
behat_form_modvisible Class Reference
Inheritance diagram for behat_form_modvisible:
behat_form_select behat_form_field

Public Member Functions

 get_attribute ($name)
 Get the value of an attribute set on this field. More...
 
 get_value ()
 Returns the text of the currently selected options. More...
 
 key_press ($char, $modifier=null)
 Presses specific keyboard key. More...
 
 matches ($expectedvalue)
 Returns whether the provided argument matches the current value. More...
 
 set_value ($value)
 Sets the value(s) of a select element. More...
 

Protected Member Functions

 get_field_locator ($locatortype=false)
 Gets the field locator. More...
 
 get_internal_field_id ()
 Gets the field internal id used by selenium wire protocol. More...
 
 get_option_xpath ($option, $selectxpath)
 Returns the opton XPath based on it's select xpath. More...
 
 get_selected_options ($returntexts=true)
 Returns the field selected values. More...
 
 get_unescaped_options ($value)
 Cleans the list of options and returns it as a string separating options with |||. More...
 
 running_javascript ()
 Returns whether the scenario is running in a browser that can run Javascript or not. More...
 
 text_matches ($expectedvalue)
 Checks if the provided text matches the field value. More...
 
 wait_for_pending_js ()
 Waits for all the JS activity to be completed. More...
 

Protected Attributes

NodeElement $field
 The field DOM node to interact with.
 
string $fieldlocator = false
 The field's locator.
 
Session $session
 Behat session.
 

Member Function Documentation

◆ get_attribute()

behat_form_field::get_attribute (   $name)
inherited

Get the value of an attribute set on this field.

Parameters
string$nameThe attribute name
Return values
stringThe attribute value

◆ get_field_locator()

behat_form_field::get_field_locator (   $locatortype = false)
protectedinherited

Gets the field locator.

Defaults to the field label but you can specify other locators if you are interested.

Public visibility as in most cases will be hard to use this method in a generic way, as fields can be selected using multiple ways (label, id, name...).

Exceptions
coding_exception
Parameters
string$locatortype
Return values
string

◆ get_internal_field_id()

behat_form_field::get_internal_field_id ( )
protectedinherited

Gets the field internal id used by selenium wire protocol.

Only available when running_javascript().

Exceptions
coding_exception
Return values
int

◆ get_option_xpath()

behat_form_select::get_option_xpath (   $option,
  $selectxpath 
)
protectedinherited

Returns the opton XPath based on it's select xpath.

Parameters
string$option
string$selectxpath
Return values
stringxpath

◆ get_selected_options()

behat_form_select::get_selected_options (   $returntexts = true)
protectedinherited

Returns the field selected values.

Externalized from the common behat_form_field API method get_value() as matches() needs to check against both values and texts.

Parameters
bool$returntextsReturns the options texts or the options values.
Return values
string

◆ get_unescaped_options()

behat_form_select::get_unescaped_options (   $value)
protectedinherited

Cleans the list of options and returns it as a string separating options with |||.

Parameters
string$valueThe string containing the escaped options.
Return values
stringThe options

◆ get_value()

behat_form_select::get_value ( )
inherited

Returns the text of the currently selected options.

Return values
stringComma separated if multiple options are selected. Commas in option texts escaped with backslash.

Reimplemented from behat_form_field.

◆ key_press()

behat_form_field::key_press (   $char,
  $modifier = null 
)
inherited

Presses specific keyboard key.

Parameters
mixed$charcould be either char ('b') or char-code (98)
string$modifierkeyboard modifier (could be 'ctrl', 'alt', 'shift' or 'meta')

◆ matches()

behat_form_select::matches (   $expectedvalue)
inherited

Returns whether the provided argument matches the current value.

Parameters
mixed$expectedvalue
Return values
bool

Reimplemented from behat_form_field.

◆ running_javascript()

behat_form_field::running_javascript ( )
protectedinherited

Returns whether the scenario is running in a browser that can run Javascript or not.

Return values
bool

◆ set_value()

behat_form_select::set_value (   $value)
inherited

Sets the value(s) of a select element.

Seems an easy select, but there are lots of combinations of browsers and operative systems and each one manages the autosubmits and the multiple option selects in a different way.

Parameters
string$valueplain value or comma separated values if multiple. Commas in values escaped with backslash.
Return values
void

Reimplemented from behat_form_field.

◆ text_matches()

behat_form_field::text_matches (   $expectedvalue)
protectedinherited

Checks if the provided text matches the field value.

Parameters
string$expectedvalue
Return values
bool

◆ wait_for_pending_js()

behat_form_field::wait_for_pending_js ( )
protectedinherited

Waits for all the JS activity to be completed.

Return values
boolWhether any JS is still pending completion.

The documentation for this class was generated from the following file: