You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

History

Aleksander Machniak e2bd4548ed Tests: Move logon helpers to the App component		5 years ago
..
Components	Tests: Move logon helpers to the App component	5 years ago
Contacts	Tests: Create Browser and Components for better code structure	5 years ago
Logon	Tests: Create Browser and Components for better code structure	5 years ago
Mail	Tests: Try to fix test that fails on Travis, but not on my setup	5 years ago
Settings	Tests: Create Browser and Components for better code structure	5 years ago
data	Add more in-browser tests	5 years ago
Browser.php	Tests: Move logon helpers to the App component	5 years ago
README.md	Make install.php accept long Chrome version string	5 years ago
TestCase.php	Tests: Create Browser and Components for better code structure	5 years ago
bootstrap.php	Tests: Create Browser and Components for better code structure	5 years ago
install.php	Make install.php accept long Chrome version string	5 years ago
phpunit.xml	Tests: Create Browser and Components for better code structure	5 years ago

README.md

In-Browser Tests

The idea of these testing suite is to make it as simple as possible to execute the tests. So, you don't have to run any additional services, nor download and install anything manually.

The tests are using Laravel Dusk and Chrome WebDriver. PHP server is used to serve Roundcube instance on tests run.

INSTALLATION

Installation:

Note that the suite has been tested with PHP 7.3 and 7.4.
Install Laravel Dusk with all dependencies.

composer require "laravel/dusk:~5.7.0"

Install Chrome WebDriver for the version of Chrome/Chromium in your system. Yes, you have to have Chrome/Chromium installed.

php tests/Browser/install.php [version]

Configure the test account and Roundcube instance.

Create a config file named config-test.inc.php in the Roundcube config dir. That file should provide specific db_dsnw and default_host values for testing purposes as well as the credentials of a valid IMAP user account used for running the tests with.

Add these config options used by the Browser tests:

  // Unit tests settings
  $config['tests_username'] = 'roundcube.test@example.org';
  $config['tests_password'] = '<test-account-password>';

WARNING

Please note that the configured IMAP account as well as the Roundcube database configred in db_dsnw will be wiped and filled with test data in every test run. Under no circumstances you should use credentials of a production database or email account!

Please, keep the file as simple as possible, i.e. containing only database and imap/smtp settings needed for the test user authentication. We would want to test default configuration. Especially only Elastic skin is supported.

NOTE: See .ci directory for sample config and scripts we use for in-browser tests on Travis.

EXECUTING THE TESTS

To run the test suite call phpunit from the tests/Browser directory:

  cd <roundcube-dir>/tests/Browser
  TESTS_MODE=desktop phpunit
  TESTS_MODE=phone phpunit
  TESTS_MODE=tablet phpunit