Changes between Version 5 and Version 6 of Writing Layout Tests to test iOS UI features

Timestamp:

Sep 30, 2015 3:38:31 PM (8 years ago)

Author:

Simon Fraser

Comment:

--

Writing Layout Tests to test iOS UI features

@@ -66 +66 @@
 }}}
 
-The script passed in to runUIScript() is just a string. You can pass a string literal here, or, for longer scripts make script tag and get is context as text:
+The script passed in to runUIScript() is just a string. You can pass a string literal here, or, for longer scripts make script tag and get its content as text:
 {{{
 <script id="ui-script" type="text/plain">
@@ -93 +93 @@
 
 Because testRunner.runUIScript() is asynchronous, the caller has to supply a callback function. The string result returned by the UI process script is passed to this callback function as an argument. You can use this to return simple bits of data as strings, or use JSON.stringify() in the UI script, and JSON.parse() in the test script to get more complex objects across the process boundary.
+
+= UIScriptController functions =
+
+UIScriptController is the mechanism for driving behavior in the UI process, and to accessing UI state. Many of the functions will trigger UI behaviors that take time (e.g. a zoom animation, or bringing up the keyboard). Rather than blocking, these functions take a callback that is triggered in the UI script context when that operation is complete:
+
+{{{
+(function() {
+    uiController.doubleTapAtPoint(50, 50, function() {
+        console.log("Taps were dispatched");
+    });
+})();
+}}}
+
+Note that this console.log() won't show in layout test output, since it's being generated in the UI process (but it will be logged if you run webkittestrunner directly, which is useful for debugging).
+
+However, the web process needs to be told that the UI script is complete, so when your test has finished doing work in the UI process, it should call uiScriptComplete(), passing the result:
+
+{{{
+(function() {
+    uiController.doubleTapAtPoint(50, 50, function() {
+        uiController.uiScriptComplete("Taps were dispatched");
+    });
+})();
+}}}
+
+