Changes between Version 28 and Version 29 of WebKitGtkLayoutTests

Timestamp:

Nov 6, 2013 5:52:31 AM (10 years ago)

Author:

Andres Gomez

Comment:

--

WebKitGtkLayoutTests

@@ -5 +5 @@
 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.
 
-== Running the Tests ==
+== 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+.
 {{{
-./Tools/Scripts/run-webkit-tests --gtk [--debug]
+#!sh
+$ ./Tools/Scripts/run-webkit-tests --gtk [--debug]
 }}}
 If you wish to run a single test you can do:
 {{{
-./Tools/Scripts/run-webkit-tests --gtk fast/forms/plaintext-mode-1.html
-}}}
-
-=== Unit Tests ===
-The GTK+ port includes unit tests. To run the suite:
-{{{
-./Tools/Scripts/run-gtk-tests [--debug] [--verbose]
-}}}
-If you wish to run a single test you can do:
-{{{
-./Tools/Scripts/run-gtk-tests WebKitBuild/Release/Programs/WebKit2APITests/TestContextMenu
+#!sh
+$ ./Tools/Scripts/run-webkit-tests --gtk fast/forms/plaintext-mode-1.html
 }}}
 
@@ -30 +24 @@
 WebKitGTK+ supports running pixel tests, but they are not enabled by default. To run them simply pass the `-p` argument to `run-webkit-tests`:
 {{{
-./Tools/Scripts/run-webkit-tests --gtk -p
+#!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):
 {{{
-WebKitBuild/Debug/Programs/DumpRenderTree -v LayoutTests/fast/forms/plaintext-mode-1.html
+#!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:
+
+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
+$ ./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
 }}}
 
@@ -45 +78 @@
 
 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.