Change Tests.prototype.all_done to require either tests or pending remotes

`Tests.prototype.all_done` used to treat the presence of at least one
test as a necessary condition for all tests to be done. This would be
false in cases where an exception is thrown inside the `setup` function,
but the code path that runs in that case doesn't use the `all_done()`
function.

However, if an exception is thrown inside the `setup` function in a
worker test, `tests.all_done()` is called in that code path, which
results in the completion message from the worker being ignored. This
change fixes this by changing the condition to require the presence of
either tests or remote contexts.

For service worker tests, however, that is not enough, since service
worker registration is asynchronous. This change lets the
`fetch_tests_from_worker` function take a promise or an async function
that returns the worker, and it guarantees that the test won't be
considered complete until the promise is resolved. The HTML boilerplate
for service worker tests is also changed in turn.

Closes #29777.

Author: Andreu Botella

resources/testharness.js

@@ -2942,7 +2942,8 @@
     };
 
     Tests.prototype.all_done = function() {
-        return this.tests.length > 0 && test_environment.all_loaded &&
+        return (this.tests.length > 0 || this.pending_remotes.length > 0) &&
+                test_environment.all_loaded &&
                 (this.num_pending === 0 || this.is_aborted) && !this.wait_for_finish &&
                 !this.processing_callbacks &&
                 !this.pending_remotes.some(function(w) { return w.running; });
@@ -3168,18 +3169,33 @@
         );
     };
 
-    Tests.prototype.fetch_tests_from_worker = function(worker) {
+    Tests.prototype.fetch_tests_from_worker = function(promiseOrWorker) {
         if (this.phase >= this.phases.COMPLETE) {
             return;
         }
 
-        var remoteContext = this.create_remote_worker(worker);
-        this.pending_remotes.push(remoteContext);
-        return remoteContext.done;
+        if (typeof promiseOrWorker === "function") {
+            promiseOrWorker = promiseOrWorker();
+        }
+
+        if (self.Promise && promiseOrWorker instanceof self.Promise) {
+            const dummy_remote = { running: true };
+            this.pending_remotes.push(dummy_remote);
+            return promiseOrWorker.then((worker) => {
+                dummy_remote.running = false;
+                var remoteContext = this.create_remote_worker(worker);
+                this.pending_remotes.push(remoteContext);
+                return remoteContext.done;
+            });
+        } else {
+            var remoteContext = this.create_remote_worker(promiseOrWorker);
+            this.pending_remotes.push(remoteContext);
+            return remoteContext.done;
+        }
     };
 
-    function fetch_tests_from_worker(port) {
-        return tests.fetch_tests_from_worker(port);
+    function fetch_tests_from_worker(promiseOrPort) {
+        return tests.fetch_tests_from_worker(promiseOrPort);
     }
     expose(fetch_tests_from_worker, 'fetch_tests_from_worker');
 

tools/serve/serve.py

@@ -311,13 +311,13 @@ class ServiceWorkersHandler(HtmlWrapperHandler):
 <script src="/resources/testharnessreport.js"></script>
 <div id=log></div>
 <script>
-(async function() {
+fetch_tests_from_worker(async function() {
   const scope = 'does/not/exist';
   let reg = await navigator.serviceWorker.getRegistration(scope);
   if (reg) await reg.unregister();
   reg = await navigator.serviceWorker.register("%(path)s%(query)s", {scope});
-  fetch_tests_from_worker(reg.installing);
-})();
+  return reg.installing;
+});
 </script>
 """
 
@@ -333,16 +333,16 @@ class ServiceWorkerModulesHandler(HtmlWrapperHandler):
 <script src="/resources/testharnessreport.js"></script>
 <div id=log></div>
 <script>
-(async function() {
+fetch_tests_from_worker(async function() {
   const scope = 'does/not/exist';
   let reg = await navigator.serviceWorker.getRegistration(scope);
   if (reg) await reg.unregister();
   reg = await navigator.serviceWorker.register(
     "%(path)s%(query)s",
     { scope, type: 'module' },
   );
-  fetch_tests_from_worker(reg.installing);
-})();
+  return reg.installing;
+});
 </script>
 """
 

tools/wptserve/tests/functional/docroot/foo.any.serviceworker.html

@@ -5,11 +5,11 @@
 <script src="/resources/testharnessreport.js"></script>
 <div id=log></div>
 <script>
-(async function() {
+fetch_tests_from_worker(async function() {
   const scope = 'does/not/exist';
   let reg = await navigator.serviceWorker.getRegistration(scope);
   if (reg) await reg.unregister();
   reg = await navigator.serviceWorker.register("/foo.any.worker.js", {scope});
-  fetch_tests_from_worker(reg.installing);
-})();
+  return reg.installing;
+});
 </script>