Moodle PHP Documentation 4.4
Moodle 4.4.1 (Build: 20240610) (db07c09afc5)
behat_form_filemanager Class Reference

File manager form field. More...

Inheritance diagram for behat_form_filemanager:
behat_form_field behat_session_interface

Public Member Functions

 get_attribute ($name)
 Get the value of an attribute set on this field.
 
 get_value ()
 Gets the value.
 
 getSession ($name=null)
 Returns the Mink session.
 
 key_press ($char, $modifier=null)
 Presses specific keyboard key.
 
 matches ($expectedvalue)
 Matches the provided filename/s against the current field value.
 
 set_value ($value)
 Sets the field value.
 

Public Attributes

const PAGE_READY_JS
 The JS code to check that the page is ready.
 

Protected Member Functions

 get_field_instance_for_element (NodeElement $element)
 Returns the appropriate form field object for a given node element.
 
 get_field_locator ($locatortype=false)
 Gets the field locator.
 
 get_internal_field_id ()
 Gets the field internal id used by selenium wire protocol.
 
 running_javascript ()
 Returns whether the scenario is running in a browser that can run Javascript or not.
 
 text_matches ($expectedvalue, ?string $actualvalue=null)
 Checks if the provided text matches the field value.
 
 wait_for_pending_js ()
 Waits for all the JS activity to be completed.
 

Protected Attributes

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

Detailed Description

File manager form field.

License
http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

Simple filemanager field manager to allow forms to be filled using TableNodes. It only adds files and checks the field contents in the root directory. If you want to run complex actions that involves subdirectories or other repositories than 'Upload a file' you should use steps related with behat_filepicker\i_add_file_from_repository_to_filemanager this is intended to be used with multi-field

This field manager allows you to:

  • Get: A comma-separated list of the root directory file names, including folders.
  • Set: Add a file, in case you want to add more than one file you can always set two table rows using the same locator.
  • Match: A comma-separated list of file names.
License
http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

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_instance_for_element()

behat_form_field::get_field_instance_for_element ( NodeElement $element)
protectedinherited

Returns the appropriate form field object for a given node element.

Parameters
NodeElement$elementThe node element
Return values
behat_form_field

◆ 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_value()

behat_form_filemanager::get_value ( )

Gets the value.

Return values
stringA comma-separated list of the root directory file names.

Reimplemented from behat_form_field.

◆ getSession()

behat_form_field::getSession ( $name = null)
inherited

Returns the Mink session.

Parameters
string | null$namename of the session OR active session will be used
Return values
Behat\Mink\Session

Implements behat_session_interface.

◆ 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_filemanager::matches ( $expectedvalue)

Matches the provided filename/s against the current field value.

If the filemanager contains more than one file the $expectedvalue value should include all the file names separating them by comma.

Parameters
string$expectedvalue
Return values
boolThe provided value matches the field value?

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_filemanager::set_value ( $value)

Sets the field value.

Parameters
string$value
Return values
void

Reimplemented from behat_form_field.

◆ text_matches()

behat_form_field::text_matches ( $expectedvalue,
?string $actualvalue = null )
protectedinherited

Checks if the provided text matches the field value.

Parameters
string$expectedvalue
string | null$actualvalueThe actual value. If not specified, this will be fetched from $this->get_value().
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.

Member Data Documentation

◆ PAGE_READY_JS

const behat_session_interface::PAGE_READY_JS
inherited
Initial value:
= "document.readyState === 'complete' && " .
"(typeof M !== 'object' || typeof M.util !== 'object' || " .
"typeof M.util.pending_js === 'undefined' || M.util.pending_js.length === 0)"

The JS code to check that the page is ready.

The document must be complete and either M.util.pending_js must be empty, or it must not be defined at all.


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