Final comments added

Author: ctjlewis

utils/js/runtimeTests.js

@@ -54,15 +54,19 @@ describe('Runtime tests', () => {
       } else return msg;
     };
 
+    // file.ext -> file
     const testName = path.basename(testFile);
+    // A promise that will resolve when JSDOM is done executing.
     const testIsFinished = new FutureEvent();
+    // A virtual console which will receive messages from JSDOM's `console.log`.
     const virtualConsole = new VirtualConsole()
         .on('log', (msg) => {
           logs.push(chalkMsg(msg));
           if (/Tests complete/i.test(msg)) testIsFinished.ready(allLogs());
           else if (/Tests failed/i.test(msg)) testIsFinished.cancel(allLogs());
         });
 
+    // Load the generated test file for consumption by the JSDOM environment.
     const testDocument = fs.readFileSync(
         path.resolve(
             __dirname,
@@ -94,10 +98,13 @@ describe('Runtime tests', () => {
       });
 
       try {
+        // Wait for test to finish.
         await testIsFinished;
       } catch (e) {
+        // If there was an error, print it.
         fail(`Failed test in suite ${testName}: \n${e}\n`);
       }
+      // Otherwise, everything passed.
       console.log(`Passed all tests in suite ${testName}`);
     });
   }