TODO: actually write tests lol

cmd/pkgserver/test_ui.go

@@ -91,7 +91,7 @@ func redirectUI(w http.ResponseWriter, r *http.Request) {
 func testUiRoutes(mux *http.ServeMux) {
 	mux.HandleFunc("GET /test.html", serveTestWebUI)
 	mux.HandleFunc("GET /testui/", serveTestWebUIStaticContent)
-	mux.HandleFunc("GET /test/lib", serveTestLibrary)
+	mux.HandleFunc("GET /test/lib/", serveTestLibrary)
 	mux.HandleFunc("GET /test/", serveTests)
 	mux.HandleFunc("GET /ui/", redirectUI)
 }

cmd/pkgserver/ui_test/all_tests.ts

@@ -1,2 +1,2 @@
-// Import all test files to execute their suite registrations.
-import "./test_tests.js";
+// Import all test files to register their test suites.
+import "./sample_tests.js";

cmd/pkgserver/ui_test/lib/cli.ts

@@ -5,7 +5,7 @@
 // development.
 
 import "../all_tests.js";
-import { StreamReporter, TESTS } from "./test.js";
+import { StreamReporter, GLOBAL_REGISTRAR } from "./test.js";
 
 // TypeScript doesn't like process and Deno as their type definitions aren't
 // installed, but doesn't seem to complain if they're accessed through
@@ -44,5 +44,5 @@ if (args.length === 1) {
 }
 
 let reporter = new StreamReporter({ writeln: console.log }, verbose);
-TESTS.run(reporter);
+GLOBAL_REGISTRAR.run(reporter);
 exit(reporter.succeeded() ? 0 : 1);

cmd/pkgserver/ui_test/lib/go_test_entrypoint.ts

@@ -1,3 +1,3 @@
 import "../all_tests.js";
-import { GoTestReporter, TESTS } from "./test.js";
-TESTS.run(new GoTestReporter());
+import { GoTestReporter, GLOBAL_REGISTRAR } from "./test.js";
+GLOBAL_REGISTRAR.run(new GoTestReporter());

cmd/pkgserver/ui_test/lib/test.ts

@@ -2,8 +2,8 @@
 // DSL
 
 type TestTree = TestGroup | Test;
-type TestGroup = { name: string, children: TestTree[] };
-type Test = { name: string, test: (t: TestController) => void };
+type TestGroup = { name: string; children: TestTree[] };
+type Test = { name: string; test: (t: TestController) => void };
 
 export class TestRegistrar {
     #suites: TestGroup[];
@@ -13,7 +13,7 @@ export class TestRegistrar {
     }
 
     suite(name: string, children: TestTree[]) {
-        checkDuplicates(name, children)
+        checkDuplicates(name, children);
         this.#suites.push({ name, children });
     }
 
@@ -26,18 +26,19 @@ export class TestRegistrar {
     }
 }
 
-export let TESTS = new TestRegistrar();
+export let GLOBAL_REGISTRAR = new TestRegistrar();
 
 // Register a suite in the global registrar.
 export function suite(name: string, children: TestTree[]) {
-    TESTS.suite(name, children);
+    GLOBAL_REGISTRAR.suite(name, children);
 }
 
-export function context(name: string, children: TestTree[]): TestTree {
+export function group(name: string, children: TestTree[]): TestTree {
     checkDuplicates(name, children);
     return { name, children };
 }
-export const group = context;
+export const context = group;
+export const describe = group;
 
 export function test(name: string, test: (t: TestController) => void): TestTree {
     return { name, test };
@@ -148,7 +149,7 @@ function extractExceptionString(e: any): string {
 // Reporting
 
 export interface Reporter {
-    register(suites: TestGroup[]): void
+    register(suites: TestGroup[]): void;
     update(path: string[], result: TestResult): void;
     finalize(): void;
 }
@@ -229,8 +230,8 @@ export class StreamReporter implements Reporter {
         this.#displaySection("skips", this.#skips);
         this.stream.writeln("");
         this.stream.writeln(
-            `${this.#successes.length} succeeded, ${this.#failures.length} failed`
-            + (this.#skips.length ? `, ${this.#skips.length} skipped` : "")
+            `${this.#successes.length} succeeded, ${this.#failures.length} failed` +
+                (this.#skips.length ? `, ${this.#skips.length} skipped` : ""),
         );
     }
 
@@ -293,7 +294,7 @@ export class DOMReporter implements Reporter {
     update(path: string[], result: TestResult) {
         if (path.length === 0) throw new RangeError("path is empty");
         if (result.state === "skip") {
-            assertGetElementById("skip-counter-text").classList.remove("hidden");
+            assertGetElementById("skip-counter-text").hidden = false;
         }
         const counter = assertGetElementById(`${result.state}-counter`);
         counter.innerText = (Number(counter.innerText) + 1).toString();
@@ -331,6 +332,8 @@ export class DOMReporter implements Reporter {
                 child.classList.add("failure");
                 child.classList.remove("skip");
                 child.classList.remove("success");
+                // The summary marker does not appear in the AOM, so setting its
+                // alt text is fruitless; label the summary itself instead.
                 summary.setAttribute("aria-labelledby", "failure-description");
                 break;
             case "skip":
@@ -367,23 +370,23 @@ export class DOMReporter implements Reporter {
 
 interface GoNode {
     name: string;
-    subtests: GoNode[] | null;
+    subtests?: GoNode[];
 }
 
 // Used to display results via `go test`, via some glue code from the Go side.
 export class GoTestReporter implements Reporter {
+    register(suites: TestGroup[]) {
+        console.log(JSON.stringify(suites.map(GoTestReporter.serialize)));
+    }
+
     // Convert a test tree into the one expected by the Go code.
     static serialize(node: TestTree): GoNode {
         return {
             name: node.name,
-            subtests: "children" in node ? node.children.map(GoTestReporter.serialize) : null,
+            subtests: "children" in node ? node.children.map(GoTestReporter.serialize) : undefined,
         };
     }
 
-    register(suites: TestGroup[]) {
-        console.log(JSON.stringify(suites.map(GoTestReporter.serialize)));
-    }
-
     update(path: string[], result: TestResult) {
         let state: number;
         switch (result.state) {
@@ -391,7 +394,7 @@ export class GoTestReporter implements Reporter {
             case "failure": state = 1; break;
             case "skip": state = 2; break;
         }
-        console.log(JSON.stringify({ path: path, state, logs: result.logs }));
+        console.log(JSON.stringify({ path, state, logs: result.logs }));
     }
 
     finalize() {

cmd/pkgserver/ui_test/lib/ui.html

@@ -19,7 +19,7 @@
 <main>
 <p id="counters">
     <span id="success-counter">0</span> succeeded, <span id="failure-counter">0</span>
-    failed<span id="skip-counter-text" class="hidden">, <span id="skip-counter">0</span> skipped</span>.
+    failed<span id="skip-counter-text" hidden>, <span id="skip-counter">0</span> skipped</span>.
 </p>
 
 <p hidden id="success-description">Successful test</p>
@@ -31,8 +31,8 @@
 
 <script type="module">
     import "/test/all_tests.js";
-    import { DOMReporter, TESTS } from "/test/lib/test.js";
-    TESTS.run(new DOMReporter());
+    import { DOMReporter, GLOBAL_REGISTRAR } from "/test/lib/test.js";
+    GLOBAL_REGISTRAR.run(new DOMReporter());
 </script>
 </main>
 </body>

cmd/pkgserver/ui_test/lib/ui.scss

@@ -1,3 +1,8 @@
+/*
+ * If updating the theme colors, also update them in success-closed.svg and
+ * success-open.svg!
+ */
+
 :root {
     --bg: #d3d3d3;
     --fg: black;
@@ -78,10 +83,6 @@ p.test-desc {
     }
 }
 
-.hidden {
-    display: none;
-}
-
 .italic {
     font-style: italic;
 }