added TEST_GAP_TIME

Author: DanielJDufour

ADVANCED_USAGE.md

@@ -27,4 +27,9 @@ Output will look like this:
 #### LOG_SKIP
 You can suppress logging the information about which tests were skipped.
 This can be helpful when you are skipping hundreds of tests.
-```LOG_SKIP=false npm test```
+```LOG_SKIP=false npm test```
+
+#### TEST_GAP_TIME
+You can pause in between tests.  This helps if there are side effects
+that need time to complete. Gap time is in seconds.
+```TEST_GAP_TIME=3.5 npm test```

examples/test.gap.js

@@ -0,0 +1,8 @@
+const test = require("../index.js");
+
+// sleep 3 seconds between tests
+process.env.TEST_GAP_TIME = "3";
+
+test("first", ({ eq }) => {});
+
+test("second", ({ eq }) => {});

index.js

@@ -19,6 +19,13 @@ const MINUS = COLORS.PURPLE + "-" + COLORS.OFF;
 const queue = [];
 const complete = [];
 
+const sleep = ms =>
+  new Promise(resolve => {
+    setTimeout(() => resolve(), ms);
+  });
+
+let ran = 0;
+
 const run = async ({ name, cb, caller }) => {
   let savedActual, savedExpected;
   const eq = function (actual, expected) {
@@ -38,6 +45,8 @@ const run = async ({ name, cb, caller }) => {
   };
 
   try {
+    if (ran >= 1 && process.env.TEST_GAP_TIME) await sleep(Number(process.env.TEST_GAP_TIME) * 1000);
+
     const start_time = performance.now();
     await Promise.resolve(cb({ eq }));
     if (caller !== complete[complete.length - 1]) {
@@ -109,6 +118,8 @@ const run = async ({ name, cb, caller }) => {
       process.exit(1);
     }
   }
+
+  ran++;
 };
 
 const skip = name => {

test.js

@@ -61,6 +61,12 @@ t("node ./examples/test.name.js", "\x1B[33mskipped: skip\x1B[39m\n\x1B[32msucces
 
 t("node ./examples/test.name-wildcard.js", "\x1B[33mskipped: skip\x1B[39m\n\x1B[32msuccess: only[this]\x1B[0m\n");
 
+const start_test_gap = performance.now();
+t("node ./examples/test.gap.js", "\x1B[32msuccess: first\x1B[0m\n\x1B[32msuccess: second\x1B[0m\n");
+const end_test_gap = performance.now();
+const duration_test_gap = Math.round((end_test_gap - start_test_gap) / 1000);
+assert.strictEqual(duration_test_gap, 3);
+
 const cmd2 = "node ./examples/test.only-one-arg.js";
 const log2 = $(cmd2).trim().replace(/\n/g, "");
 assert.strictEqual(log2.includes("you only supplied one argument"), true);