Changes between Version 28 and Version 29 of WebKitGtkLayoutTests


Ignore:
Timestamp:
Nov 6, 2013 5:52:31 AM (9 years ago)
Author:
Andres Gomez
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WebKitGtkLayoutTests

    v28 v29  
    55Ensure 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.
    66
    7 == Running the Tests ==
     7== Layout Tests (Functional Tests) ==
     8
     9=== Running the Tests ===
    810
    911Simply 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+.
    1012{{{
    11 ./Tools/Scripts/run-webkit-tests --gtk [--debug]
     13#!sh
     14$ ./Tools/Scripts/run-webkit-tests --gtk [--debug]
    1215}}}
    1316If you wish to run a single test you can do:
    1417{{{
    15 ./Tools/Scripts/run-webkit-tests --gtk fast/forms/plaintext-mode-1.html
    16 }}}
    17 
    18 === Unit Tests ===
    19 The GTK+ port includes unit tests. To run the suite:
    20 {{{
    21 ./Tools/Scripts/run-gtk-tests [--debug] [--verbose]
    22 }}}
    23 If you wish to run a single test you can do:
    24 {{{
    25 ./Tools/Scripts/run-gtk-tests WebKitBuild/Release/Programs/WebKit2APITests/TestContextMenu
     18#!sh
     19$ ./Tools/Scripts/run-webkit-tests --gtk fast/forms/plaintext-mode-1.html
    2620}}}
    2721
     
    3024WebKitGTK+ supports running pixel tests, but they are not enabled by default. To run them simply pass the `-p` argument to `run-webkit-tests`:
    3125{{{
    32 ./Tools/Scripts/run-webkit-tests --gtk -p
     26#!sh
     27$ ./Tools/Scripts/run-webkit-tests --gtk -p
    3328}}}
    3429
    3530=== Running Tests in GDB ===
     31
    3632For debugging a test it may be useful to run it directly in DumpRenderTree (with gdb):
    3733{{{
    38 WebKitBuild/Debug/Programs/DumpRenderTree -v LayoutTests/fast/forms/plaintext-mode-1.html
     34#!sh
     35$ ./WebKitBuild/Debug/Programs/DumpRenderTree -v LayoutTests/fast/forms/plaintext-mode-1.html
     36}}}
     37
     38=== HTTP tests ===
     39
     40HTTP functional tests are stored at:
     41{{{
     42#!sh
     43$ LayoutTests/http/tests/
     44}}}
     45
     46Obviously, 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:
     47{{{
     48#!sh
     49$ LayoutTests/http/conf/
     50}}}
     51
     52Sometimes, 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:
     53
     54Obviously, 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:
     55{{{
     56#!sh
     57$ ./Tools/Scripts/run-webkit-httpd
     58}}}
     59
     60
     61== Unit Tests ==
     62
     63The GTK+ port includes unit tests. To run the suite:
     64{{{
     65#!sh
     66$ ./Tools/Scripts/run-gtk-tests [--debug] [--verbose]
     67}}}
     68If you wish to run a single test you can do:
     69{{{
     70#!sh
     71$ ./Tools/Scripts/run-gtk-tests WebKitBuild/Release/Programs/WebKit2APITests/TestContextMenu
    3972}}}
    4073
     
    4578
    4679There are some instructions to avoid common problems derived from having a [wiki:WebKitGTK/Chroot#Runningpythonbasedtestwithmultiprocesssupport chroot based working environment].
     80
     81
     82== Further information ==
     83
     84Further 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.