Moodle APIs 3.9
Moodle 3.9.13+ (Build: 20220325)
Public Member Functions | Public Attributes | Protected Member Functions | List of all members
behat_repository_upload Class Reference
Inheritance diagram for behat_repository_upload:
behat_base behat_session_interface behat_theme_classic_behat_repository_upload

Public Member Functions

 getSession ($name=null)
 Returns the Mink session. More...
 
 i_upload_and_overwrite_file_to_filemanager ($filepath, $filemanagerelement)
 Uploads a file to the specified filemanager leaving other fields in upload form default and confirms to overwrite an existing file. More...
 
 i_upload_and_overwrite_file_to_filemanager_as ($filepath, $filemanagerelement, TableNode $data)
 Uploads a file to the specified filemanager. More...
 
 i_upload_file_to_filemanager ($filepath, $filemanagerelement)
 Uploads a file to the specified filemanager leaving other fields in upload form default. More...
 
 i_upload_file_to_filemanager_as ($filepath, $filemanagerelement, TableNode $data)
 Uploads a file to the specified filemanager and confirms to overwrite an existing file. More...
 

Public Attributes

const EXTENDED_TIMEOUT = 10
 And extended timeout for specific cases. More...
 
const PAGE_READY_JS
 The JS code to check that the page is ready. More...
 
const REDUCED_TIMEOUT = 2
 Small timeout. More...
 
const TIMEOUT = 6
 The timeout for each Behat step (load page, wait for an element to load...). More...
 

Protected Member Functions

 get_filepicker_node ($filepickerelement)
 Try to get the filemanager node specified by the element. More...
 
 upload_file_to_filemanager ($filepath, $filemanagerelement, TableNode $data, $overwriteaction=false)
 Uploads a file to filemanager. More...
 

Member Function Documentation

◆ get_filepicker_node()

behat_repository_upload::get_filepicker_node (   $filepickerelement)
protected

Try to get the filemanager node specified by the element.

Parameters
string$filepickerelement
Return values
Behat::Mink::Element::NodeElement
Exceptions
ExpectationException

Reimplemented in behat_theme_classic_behat_repository_upload.

◆ getSession()

behat_session_interface::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

Implemented in behat_form_field.

◆ i_upload_and_overwrite_file_to_filemanager()

behat_repository_upload::i_upload_and_overwrite_file_to_filemanager (   $filepath,
  $filemanagerelement 
)

Uploads a file to the specified filemanager leaving other fields in upload form default and confirms to overwrite an existing file.

The paths should be relative to moodle codebase.

@When /^I upload and overwrite "(?P<filepath_string>(?:[^"]|::")*)" file to "(?P<filemanager_field_string>(?:[^"]|")*)" filemanager$/

Exceptions
DriverException
ExpectationExceptionThrown by behat_base::find
Parameters
string$filepath
string$filemanagerelement

◆ i_upload_and_overwrite_file_to_filemanager_as()

behat_repository_upload::i_upload_and_overwrite_file_to_filemanager_as (   $filepath,
  $filemanagerelement,
TableNode  $data 
)

Uploads a file to the specified filemanager.

The paths should be relative to moodle codebase.

@When /^I upload and overwrite "(?P<filepath_string>(?:[^"]|::")*)" file to "(?P<filemanager_field_string>(?:[^"]|")*)" filemanager as:$/

Exceptions
DriverException
ExpectationExceptionThrown by behat_base::find
Parameters
string$filepath
string$filemanagerelement
TableNode$dataData to fill in upload form

◆ i_upload_file_to_filemanager()

behat_repository_upload::i_upload_file_to_filemanager (   $filepath,
  $filemanagerelement 
)

Uploads a file to the specified filemanager leaving other fields in upload form default.

The paths should be relative to moodle codebase.

@When /^I upload "(?P<filepath_string>(?:[^"]|::")*)" file to "(?P<filemanager_field_string>(?:[^"]|")*)" filemanager$/

Exceptions
DriverException
ExpectationExceptionThrown by behat_base::find
Parameters
string$filepath
string$filemanagerelement

◆ i_upload_file_to_filemanager_as()

behat_repository_upload::i_upload_file_to_filemanager_as (   $filepath,
  $filemanagerelement,
TableNode  $data 
)

Uploads a file to the specified filemanager and confirms to overwrite an existing file.

The paths should be relative to moodle codebase.

@When /^I upload "(?P<filepath_string>(?:[^"]|::")*)" file to "(?P<filemanager_field_string>(?:[^"]|")*)" filemanager as:$/

Exceptions
DriverException
ExpectationExceptionThrown by behat_base::find
Parameters
string$filepath
string$filemanagerelement
TableNode$dataData to fill in upload form

◆ upload_file_to_filemanager()

behat_repository_upload::upload_file_to_filemanager (   $filepath,
  $filemanagerelement,
TableNode  $data,
  $overwriteaction = false 
)
protected

Uploads a file to filemanager.

Exceptions
DriverException
ExpectationExceptionThrown by behat_base::find
Parameters
string$filepathNormally a path relative to $CFG->dirroot, but can be an absolute path too.
string$filemanagerelement
TableNode$dataData to fill in upload form
false | string$overwriteactionfalse if we don't expect that file with the same name already exists, or button text in overwrite dialogue ("Overwrite", "Rename to ...", "Cancel")

Member Data Documentation

◆ EXTENDED_TIMEOUT

const behat_session_interface::EXTENDED_TIMEOUT = 10
inherited

And extended timeout for specific cases.

Deprecated:
since Moodle 3.7 MDL-64979 - please use get_extended_timeout() instead
Todo:
MDL-64982 This will be deleted in Moodle 3.11
See also
behat_base::get_extended_timeout()

◆ 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.

◆ REDUCED_TIMEOUT

const behat_session_interface::REDUCED_TIMEOUT = 2
inherited

Small timeout.

A reduced timeout for cases where self::TIMEOUT is too much and a simple $this->getSession()->getPage()->find() could not be enough.

Deprecated:
since Moodle 3.7 MDL-64979 - please use get_reduced_timeout() instead
Todo:
MDL-64982 This will be deleted in Moodle 3.11
See also
behat_base::get_reduced_timeout()

◆ TIMEOUT

const behat_session_interface::TIMEOUT = 6
inherited

The timeout for each Behat step (load page, wait for an element to load...).

Deprecated:
since Moodle 3.7 MDL-64979 - please use get_timeout() instead
Todo:
MDL-64982 This will be deleted in Moodle 3.11
See also
behat_base::get_timeout()

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