[[PageOutline]] = Running Tests for WebKitGTK+ = == Dependencies == Ensure that you've followed [wiki:BuildingGtk all dependency installation instructions]. If you try to run tests without installing and updating both system and JHBuild (update-webkitgtk-libs) dependencies, it's likely that not all tests will pass. == Layout Tests (Functional Tests) == === Running the Tests === Simply run the `run-webkit-tests` script from the Tools directory. `run-webkit-tests` also supports the `--debug` argument to run the tests with the debug build of WebKitGTK+. {{{ #!sh $ ./Tools/Scripts/run-webkit-tests --gtk [--debug] }}} If you wish to run a single test you can do: {{{ #!sh $ ./Tools/Scripts/run-webkit-tests --gtk fast/forms/plaintext-mode-1.html }}} === Pixel Tests === WebKitGTK+ supports running pixel tests, but they are not enabled by default. To run them simply pass the `-p` argument to `run-webkit-tests`: {{{ #!sh $ ./Tools/Scripts/run-webkit-tests --gtk -p }}} === Running Tests in GDB === For debugging a test it may be useful to run it directly in DumpRenderTree (with gdb): {{{ #!sh $ ./WebKitBuild/Debug/Programs/DumpRenderTree -v LayoutTests/fast/forms/plaintext-mode-1.html }}} === HTTP tests === HTTP functional tests are stored at: {{{ #!sh $ LayoutTests/http/tests/ }}} Obviously, it is needed a local web server for running them. Depending on your distribution, when executing the tests, the `run-webkit-tests` script will launch the needed local web server. The configurations used for the web server can be found at: {{{ #!sh $ LayoutTests/http/conf/ }}} Sometimes, it is useful to change that configuration or to be able to just launch the web server and run some tests and checks manually. Instead of running the specific test through the `run-webkit-tests` script, we can do this calling: {{{ #!sh $ ./Tools/Scripts/run-webkit-httpd }}} == Unit Tests == The GTK+ port includes unit tests. To run the suite: {{{ #!sh $ ./Tools/Scripts/run-gtk-tests [--debug] [--verbose] }}} If you wish to run a single test you can do: {{{ #!sh $ ./Tools/Scripts/run-gtk-tests WebKitBuild/Release/Programs/WebKit2APITests/TestContextMenu }}} == Common Problems == === chroot derived problems === There are some instructions to avoid common problems derived from having a [wiki:WebKitGTK/Chroot#Runningpythonbasedtestwithmultiprocesssupport chroot based working environment]. == Further information == Further information about the functional and unit tests can be found in the genera documentation pages at the [wiki:WikiStart#LayoutTests main page] of the wiki.