diff options
| author | Marc Alexander <admin@m-a-styles.de> | 2018-02-21 20:55:20 +0100 |
|---|---|---|
| committer | Marc Alexander <admin@m-a-styles.de> | 2018-02-21 20:55:20 +0100 |
| commit | 1c920859dbecd12f1ad12b96249a39e4fa155a91 (patch) | |
| tree | e3268d996da1beb023af74233c268b2a7c0c7c3f | |
| parent | 89e29bb8468d53f1fb98f70af4cdc346491aec7e (diff) | |
| parent | 94c168291c155db0bbf60c16e574758ed7373633 (diff) | |
| download | forums-1c920859dbecd12f1ad12b96249a39e4fa155a91.tar forums-1c920859dbecd12f1ad12b96249a39e4fa155a91.tar.gz forums-1c920859dbecd12f1ad12b96249a39e4fa155a91.tar.bz2 forums-1c920859dbecd12f1ad12b96249a39e4fa155a91.tar.xz forums-1c920859dbecd12f1ad12b96249a39e4fa155a91.zip | |
Merge pull request #5089 from marc1706/ticket/15516
[ticket/15516] Add instructions for running UI tests
| -rw-r--r-- | tests/RUNNING_TESTS.md | 25 |
1 files changed, 23 insertions, 2 deletions
diff --git a/tests/RUNNING_TESTS.md b/tests/RUNNING_TESTS.md index c9941d61e5..12ae7fa687 100644 --- a/tests/RUNNING_TESTS.md +++ b/tests/RUNNING_TESTS.md @@ -143,14 +143,14 @@ If you want all tests, run: Functional tests ------------------ +================ Functional tests test software the way a user would. They simulate a user browsing the website, but they do these steps in an automated way. phpBB allows you to write such tests. Running -======= +------- Running the tests requires your phpBB3 repository to be accessible through a local web server. You will need to supply the URL to the webserver in @@ -170,6 +170,27 @@ If you only want the functional tests, run: This will change your board's config.php file, but it makes a backup at config_dev.php, so you can restore it after the test run is complete. +UI tests +======== + +UI tests are functional tests that also support running JavaScript in a +headless browser. These should be used when functionality that is only +executed using JS needs to be tested. They require a running +[PhantomJS WebDriver instance](http://phantomjs.org/). The executable can +either be downloaded from [PhantomJS](http://phantomjs.org/download.html) +or alternatively be installed with npm: + + $ npm install -g phantomjs-prebuilt + +You might have to run the command as superuser / administrator on some +systems. Afterwards, a new WebDriver instance can be started via command +line: + + $ phantomjs --webdriver=127.0.0.1:8910 + +Port 8910 is the default port that will be used by UI tests to connect +to the WebDriver instance. + More Information ================ |