qunitx 0.9.0 → 0.9.1

package/package.json

@@ -1,14 +1,42 @@
 {
   "name": "qunitx",
   "type": "module",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "A universal test framework for testing any js file on node.js, browser or deno with QUnit API",
   "author": "Izel Nakri",
   "license": "MIT",
   "keywords": [
     "test",
-    "test framework",
     "testing",
+    "automated testing",
+    "test framework",
+    "ui testing",
+    "e2e",
+    "e2e testing",
+    "0 dependencies",
+    "zero dependencies",
+    "no dependencies",
+    "universal testing",
+    "universal test framework",
+    "universal test",
+    "universal",
+    "cross platform",
+    "cross platform testing",
+    "cross platform test framework",
+    "cross platform test",
+    "unit testing",
+    "unit test",
+    "unit",
+    "integration testing",
+    "integration test",
+    "integration",
+    "qa",
+    "quality assurance",
+    "tdd",
+    "bdd",
+    "assert",
+    "frontend",
+    "backend",
     "qunit",
     "node",
     "deno",

package/shims/deno/index.js

@@ -1,238 +1,27 @@
-import {
-  beforeAll,
-  afterAll,
-  describe,
-  it,
-} from "https://deno.land/std@0.192.0/testing/bdd.ts";
-import Assert from './assert.js';
-
-class TestContext {
-  name;
-
-  #module;
-  get module() {
-    return this.#module;
-  }
-  set module(value) {
-    this.#module = value;
-  }
-
-  #assert;
-  get assert() {
-    return this.#assert;
-  }
-  set assert(value) {
-    this.#assert = value;
-  }
-
-  #timeout;
-  get timeout() {
-    return this.#timeout;
-  }
-  set timeout(value) {
-    this.#timeout = value;
-  }
-
-  #steps = [];
-  get steps() {
-    return this.#steps;
-  }
-  set steps(value) {
-    this.#steps = value;
-  }
-
-  #expectedAssertionCount;
-  get expectedAssertionCount() {
-    return this.#expectedAssertionCount;
-  }
-  set expectedAssertionCount(value) {
-    this.#expectedAssertionCount = value;
-  }
-
-  #totalExecutedAssertions = 0;
-  get totalExecutedAssertions() {
-    return this.#totalExecutedAssertions;
-  }
-  set totalExecutedAssertions(value) {
-    this.#totalExecutedAssertions = value;
-  }
-
-  constructor(name, moduleContext) {
-    if (moduleContext) {
-      this.name = `${moduleContext.name} | ${name}`;
-      this.module = moduleContext;
-      this.module.tests.push(this);
-      this.assert = new Assert(moduleContext, this);
-    }
-  }
-
-  finish() {
-    if (this.totalExecutedAssertions === 0) {
-      this.assert.pushResult({
-        result: false,
-        actual: this.totalExecutedAssertions,
-        expected: '> 0',
-        message: `Expected at least one assertion to be run for test: ${this.name}`,
-      });
-    } else if (this.steps.length > 0) {
-      this.assert.pushResult({
-        result: false,
-        actual: this.steps,
-        expected: [],
-        message: `Expected assert.verifySteps() to be called before end of test after using assert.step(). Unverified steps: ${this.steps.join(', ')}`,
-      });
-    } else if (this.expectedAssertionCount && this.expectedAssertionCount !== this.totalExecutedAssertions) {
-      this.assert.pushResult({
-        result: false,
-        actual: this.totalExecutedAssertions,
-        expected: this.expectedAssertionCount,
-        message: `Expected ${this.expectedAssertionCount} assertions, but ${this.totalExecutedAssertions} were run for test: ${this.name}`,
-      });
-    }
-  }
-}
-
-class ModuleContext extends TestContext {
-  static currentModuleChain = [];
-
-  static get lastModule() {
-    return this.currentModuleChain[this.currentModuleChain.length - 1];
-  }
-
-  #tests = [];
-  get tests() {
-    return this.#tests;
-  }
-
-  #beforeEachHooks = [];
-  get beforeEachHooks() {
-    return this.#beforeEachHooks;
-  }
-
-  #afterEachHooks = [];
-  get afterEachHooks() {
-    return this.#afterEachHooks;
-  }
-
-  #moduleChain = [];
-  get moduleChain() {
-    return this.#moduleChain;
-  }
-  set moduleChain(value) {
-    this.#moduleChain = value;
-  }
-
-  constructor(name) {
-    super(name);
-
-    let parentModule = ModuleContext.currentModuleChain[ModuleContext.currentModuleChain.length - 1];
-
-    ModuleContext.currentModuleChain.push(this);
-
-    this.moduleChain = ModuleContext.currentModuleChain.slice(0);
-    this.name = parentModule ? `${parentModule.name} > ${name}` : name;
-    this.assert = new Assert(this);
+import { AssertionError as DenoAssertionError } from "https://deno.land/std@0.192.0/testing/asserts.ts";
+import '../../vendor/qunit.js';
+import Assert from '../shared/assert.js';
+import ModuleContext from '../shared/module-context.js';
+import TestContext from '../shared/test-context.js';
+import Module from './module.js';
+import Test from './test.js';
+
+export class AssertionError extends DenoAssertionError {
+  constructor(object) {
+    super(object.message);
   }
 }
 
-export const module = (moduleName, runtimeOptions, moduleContent) => {
-  let targetRuntimeOptions = moduleContent ? runtimeOptions : {};
-  let targetModuleContent = moduleContent ? moduleContent : runtimeOptions;
-  let moduleContext = new ModuleContext(moduleName);
-
-  return describe(moduleName, { concurrency: true, ...targetRuntimeOptions }, async function () {
-    let beforeHooks = [];
-    let afterHooks = [];
-
-    beforeAll(async function () {
-      Object.assign(moduleContext, moduleContext.moduleChain.reduce((result, module) => {
-        const { name, ...moduleWithoutName } = module;
-
-        return Object.assign(result, moduleWithoutName, {
-          steps: result.steps.concat(module.steps),
-          expectedAssertionCount: module.expectedAssertionCount
-            ? module.expectedAssertionCount
-            : result.expectedAssertionCount
-        });
-      }, { steps: [], expectedAssertionCount: undefined }));
-
-      for (let hook of beforeHooks) {
-        await hook.call(moduleContext, moduleContext.assert);
-      }
+Assert.QUnit = QUnit;
+Assert.AssertionError = AssertionError;
+ModuleContext.Assert = Assert;
+TestContext.Assert = Assert;
 
-      moduleContext.tests.forEach((testContext) => {
-        const { name, ...moduleContextWithoutName } = moduleContext;
+Object.freeze(Assert);
+Object.freeze(ModuleContext);
+Object.freeze(TestContext);
 
-        Object.assign(testContext, moduleContextWithoutName, {
-          steps: moduleContext.steps,
-          totalExecutedAssertions: moduleContext.totalExecutedAssertions,
-          expectedAssertionCount: moduleContext.expectedAssertionCount,
-        });
-      });
-    });
-    afterAll(async () => {
-      for (const assert of moduleContext.tests.map(testContext => testContext.assert)) {
-        await assert.waitForAsyncOps();
-      }
-
-      let targetContext = moduleContext.tests[moduleContext.tests.length - 1];
-      for (let j = afterHooks.length - 1; j >= 0; j--) {
-        await afterHooks[j].call(targetContext, targetContext.assert);
-      }
-
-      moduleContext.tests.forEach(testContext => testContext.finish());
-    });
-
-    targetModuleContent.call(moduleContext, {
-      before(beforeFn) {
-        return beforeHooks.push(beforeFn);
-      },
-      beforeEach(beforeEachFn) {
-        return moduleContext.beforeEachHooks.push(beforeEachFn);
-      },
-      afterEach(afterEachFn) {
-        return moduleContext.afterEachHooks.push(afterEachFn);
-      },
-      after(afterFn) {
-        return afterHooks.push(afterFn);
-      }
-    }, { moduleName, options: runtimeOptions });
-
-    ModuleContext.currentModuleChain.pop();
-  });
-}
-
-export const test = (testName, runtimeOptions, testContent) => {
-  let moduleContext = ModuleContext.lastModule;
-  if (!moduleContext) {
-    throw new Error(`Test '${testName}' called outside of module context.`);
-  }
-
-  let targetRuntimeOptions = testContent ? runtimeOptions : {};
-  let targetTestContent = testContent ? testContent : runtimeOptions;
-  let context = new TestContext(testName, moduleContext);
-
-  return it(testName, { concurrency: true, ...targetRuntimeOptions }, async function () {
-    let result;
-    for (let module of context.module.moduleChain) {
-      for (let hook of module.beforeEachHooks) {
-        await hook.call(context, context.assert);
-      }
-    }
-
-    result = await targetTestContent.call(context, context.assert, { testName, options: runtimeOptions });
-
-    await context.assert.waitForAsyncOps();
-
-    for (let i = context.module.moduleChain.length - 1; i >= 0; i--) {
-      let module = context.module.moduleChain[i];
-      for (let j = module.afterEachHooks.length - 1; j >= 0; j--) {
-        await module.afterEachHooks[j].call(context, context.assert);
-      }
-    }
-
-    return result;
-  });
-}
+export const module = Module;
+export const test = Test;
 
-export default { module, test, config: {} };
+export default { AssertionError: Assert.AssertionError, module, test, config: {} };

package/shims/deno/module.js

@@ -0,0 +1,71 @@
+import { describe, beforeAll, afterAll } from "https://deno.land/std@0.192.0/testing/bdd.ts";
+import ModuleContext from '../shared/module-context.js';
+
+// NOTE: node.js beforeEach & afterEach is buggy because the TestContext it has is NOT correct reference when called, it gets the last context
+// NOTE: QUnit expect() logic is buggy in nested modules
+// NOTE: after gets the last direct children test of the module, not last defined context of a module(last defined context is a module)
+
+export default function module(moduleName, runtimeOptions, moduleContent) {
+  let targetRuntimeOptions = moduleContent ? runtimeOptions : {};
+  let targetModuleContent = moduleContent ? moduleContent : runtimeOptions;
+  let moduleContext = new ModuleContext(moduleName);
+
+  return describe(moduleName, { concurrency: true, ...targetRuntimeOptions }, async function () {
+    let beforeHooks = [];
+    let afterHooks = [];
+
+    beforeAll(async function () {
+      Object.assign(moduleContext.context, moduleContext.moduleChain.reduce((result, module) => {
+        return Object.assign(result, module.context, {
+          steps: result.steps.concat(module.context.steps),
+          expectedAssertionCount: module.context.expectedAssertionCount
+            ? module.context.expectedAssertionCount
+            : result.expectedAssertionCount
+        });
+      }, { steps: [], expectedAssertionCount: undefined }));
+
+      for (let hook of beforeHooks) {
+        await hook.call(moduleContext.context, moduleContext.assert);
+      }
+
+      for (let i = 0, len = moduleContext.tests.length; i < len; i++) {
+        Object.assign(moduleContext.tests[i], moduleContext.context, {
+          steps: moduleContext.context.steps,
+          totalExecutedAssertions: moduleContext.context.totalExecutedAssertions,
+          expectedAssertionCount: moduleContext.context.expectedAssertionCount,
+        });
+      }
+    });
+    afterAll(async () => {
+      for (const assert of moduleContext.tests.map(testContext => testContext.assert)) {
+        await assert.waitForAsyncOps();
+      }
+
+      let targetContext = moduleContext.tests[moduleContext.tests.length - 1];
+      for (let j = afterHooks.length - 1; j >= 0; j--) {
+        await afterHooks[j].call(targetContext, targetContext.assert);
+      }
+
+      for (let i = 0, len = moduleContext.tests.length; i < len; i++) {
+        moduleContext.tests[i].finish();
+      }
+    });
+
+    targetModuleContent.call(moduleContext.context, {
+      before(beforeFn) {
+        beforeHooks[beforeHooks.length] = beforeFn;
+      },
+      beforeEach(beforeEachFn) {
+        moduleContext.beforeEachHooks[moduleContext.beforeEachHooks.length] = beforeEachFn;
+      },
+      afterEach(afterEachFn) {
+        moduleContext.afterEachHooks[moduleContext.afterEachHooks.length] = afterEachFn;
+      },
+      after(afterFn) {
+        afterHooks[afterHooks.length] = afterFn;
+      }
+    }, { moduleName, options: runtimeOptions });
+
+    ModuleContext.currentModuleChain.pop();
+  });
+}

package/shims/deno/test.js

@@ -0,0 +1,37 @@
+import { it } from "https://deno.land/std@0.192.0/testing/bdd.ts";
+import TestContext from '../shared/test-context.js';
+import ModuleContext from '../shared/module-context.js';
+
+export default function test(testName, runtimeOptions, testContent) {
+  let moduleContext = ModuleContext.lastModule;
+  if (!moduleContext) {
+    throw new Error(`Test '${testName}' called outside of module context.`);
+  }
+
+  let targetRuntimeOptions = testContent ? runtimeOptions : {};
+  let targetTestContent = testContent ? testContent : runtimeOptions;
+  let context = new TestContext(testName, moduleContext);
+
+  return it(testName, { concurrency: true, ...targetRuntimeOptions }, async function () {
+    let result;
+    for (let module of context.module.moduleChain) {
+      for (let hook of module.beforeEachHooks) {
+        await hook.call(context, context.assert);
+      }
+    }
+
+    result = await targetTestContent.call(context, context.assert, { testName, options: runtimeOptions });
+
+    await context.assert.waitForAsyncOps();
+
+    for (let i = context.module.moduleChain.length - 1; i >= 0; i--) {
+      let module = context.module.moduleChain[i];
+      for (let j = module.afterEachHooks.length - 1; j >= 0; j--) {
+        await module.afterEachHooks[j].call(context, context.assert);
+      }
+    }
+
+    return result;
+  });
+}
+

package/shims/node/index.js

@@ -1,237 +1,22 @@
-import { describe, it, before as beforeAll, after as afterAll } from 'node:test';
-import Assert from './assert.js';
+import { AssertionError } from 'node:assert';
+import QUnit from '../../vendor/qunit.js';
+import Assert from '../shared/assert.js';
+import ModuleContext from '../shared/module-context.js';
+import TestContext from '../shared/test-context.js';
+import Module from './module.js';
+import Test from './test.js';
 
-// NOTE: node.js beforeEach & afterEach is buggy because the TestContext it has is NOT correct reference when called, it gets the last context
-// NOTE: QUnit expect() logic is buggy in nested modules
-// NOTE: after gets the last direct children test of the module, not last defined context of a module(last defined context is a module)
+Assert.QUnit = QUnit;
+Assert.AssertionError = AssertionError;
 
-class TestContext {
-  name;
+ModuleContext.Assert = Assert;
+TestContext.Assert = Assert;
 
-  #module;
-  get module() {
-    return this.#module;
-  }
-  set module(value) {
-    this.#module = value;
-  }
+Object.freeze(Assert);
+Object.freeze(ModuleContext);
+Object.freeze(TestContext);
 
-  #assert;
-  get assert() {
-    return this.#assert;
-  }
-  set assert(value) {
-    this.#assert = value;
-  }
+export const module = Module;
+export const test = Test;
 
-  #timeout;
-  get timeout() {
-    return this.#timeout;
-  }
-  set timeout(value) {
-    this.#timeout = value;
-  }
-
-  #steps = [];
-  get steps() {
-    return this.#steps;
-  }
-  set steps(value) {
-    this.#steps = value;
-  }
-
-  #expectedAssertionCount;
-  get expectedAssertionCount() {
-    return this.#expectedAssertionCount;
-  }
-  set expectedAssertionCount(value) {
-    this.#expectedAssertionCount = value;
-  }
-
-  #totalExecutedAssertions = 0;
-  get totalExecutedAssertions() {
-    return this.#totalExecutedAssertions;
-  }
-  set totalExecutedAssertions(value) {
-    this.#totalExecutedAssertions = value;
-  }
-
-  constructor(name, moduleContext) {
-    if (moduleContext) {
-      this.name = `${moduleContext.name} | ${name}`;
-      this.module = moduleContext;
-      this.module.tests.push(this);
-      this.assert = new Assert(moduleContext, this);
-    }
-  }
-
-  finish() {
-    if (this.totalExecutedAssertions === 0) {
-      this.assert.pushResult({
-        result: false,
-        actual: this.totalExecutedAssertions,
-        expected: '> 0',
-        message: `Expected at least one assertion to be run for test: ${this.name}`,
-      });
-    } else if (this.steps.length > 0) {
-      this.assert.pushResult({
-        result: false,
-        actual: this.steps,
-        expected: [],
-        message: `Expected assert.verifySteps() to be called before end of test after using assert.step(). Unverified steps: ${this.steps.join(', ')}`,
-      });
-    } else if (this.expectedAssertionCount && this.expectedAssertionCount !== this.totalExecutedAssertions) {
-      this.assert.pushResult({
-        result: false,
-        actual: this.totalExecutedAssertions,
-        expected: this.expectedAssertionCount,
-        message: `Expected ${this.expectedAssertionCount} assertions, but ${this.totalExecutedAssertions} were run for test: ${this.name}`,
-      });
-    }
-  }
-}
-
-class ModuleContext extends TestContext {
-  static currentModuleChain = [];
-
-  static get lastModule() {
-    return this.currentModuleChain[this.currentModuleChain.length - 1];
-  }
-
-  #tests = [];
-  get tests() {
-    return this.#tests;
-  }
-
-  #beforeEachHooks = [];
-  get beforeEachHooks() {
-    return this.#beforeEachHooks;
-  }
-
-  #afterEachHooks = [];
-  get afterEachHooks() {
-    return this.#afterEachHooks;
-  }
-
-  #moduleChain = [];
-  get moduleChain() {
-    return this.#moduleChain;
-  }
-  set moduleChain(value) {
-    this.#moduleChain = value;
-  }
-
-  constructor(name) {
-    super(name);
-
-    let parentModule = ModuleContext.currentModuleChain[ModuleContext.currentModuleChain.length - 1];
-
-    ModuleContext.currentModuleChain.push(this);
-
-    this.moduleChain = ModuleContext.currentModuleChain.slice(0);
-    this.name = parentModule ? `${parentModule.name} > ${name}` : name;
-    this.assert = new Assert(this);
-  }
-}
-
-export const module = (moduleName, runtimeOptions, moduleContent) => {
-  let targetRuntimeOptions = moduleContent ? runtimeOptions : {};
-  let targetModuleContent = moduleContent ? moduleContent : runtimeOptions;
-  let moduleContext = new ModuleContext(moduleName);
-
-  return describe(moduleName, { concurrency: true, ...targetRuntimeOptions }, async function () {
-    let beforeHooks = [];
-    let afterHooks = [];
-
-    beforeAll(async function () {
-      Object.assign(moduleContext, moduleContext.moduleChain.reduce((result, module) => {
-        const { name, ...moduleWithoutName } = module;
-
-        return Object.assign(result, moduleWithoutName, {
-          steps: result.steps.concat(module.steps),
-          expectedAssertionCount: module.expectedAssertionCount
-            ? module.expectedAssertionCount
-            : result.expectedAssertionCount
-        });
-      }, { steps: [], expectedAssertionCount: undefined }));
-
-      for (let hook of beforeHooks) {
-        await hook.call(moduleContext, moduleContext.assert);
-      }
-
-      moduleContext.tests.forEach((testContext) => {
-        const { name, ...moduleContextWithoutName } = moduleContext;
-
-        Object.assign(testContext, moduleContextWithoutName, {
-          steps: moduleContext.steps,
-          totalExecutedAssertions: moduleContext.totalExecutedAssertions,
-          expectedAssertionCount: moduleContext.expectedAssertionCount,
-        });
-      });
-    });
-    afterAll(async () => {
-      for (const assert of moduleContext.tests.map(testContext => testContext.assert)) {
-        await assert.waitForAsyncOps();
-      }
-
-      let targetContext = moduleContext.tests[moduleContext.tests.length - 1];
-      for (let j = afterHooks.length - 1; j >= 0; j--) {
-        await afterHooks[j].call(targetContext, targetContext.assert);
-      }
-
-      moduleContext.tests.forEach(testContext => testContext.finish());
-    });
-
-    targetModuleContent.call(moduleContext, {
-      before(beforeFn) {
-        return beforeHooks.push(beforeFn);
-      },
-      beforeEach(beforeEachFn) {
-        return moduleContext.beforeEachHooks.push(beforeEachFn);
-      },
-      afterEach(afterEachFn) {
-        return moduleContext.afterEachHooks.push(afterEachFn);
-      },
-      after(afterFn) {
-        return afterHooks.push(afterFn);
-      }
-    }, { moduleName, options: runtimeOptions });
-
-    ModuleContext.currentModuleChain.pop();
-  });
-}
-
-export const test = (testName, runtimeOptions, testContent) => {
-  let moduleContext = ModuleContext.lastModule;
-  if (!moduleContext) {
-    throw new Error(`Test '${testName}' called outside of module context.`);
-  }
-
-  let targetRuntimeOptions = testContent ? runtimeOptions : {};
-  let targetTestContent = testContent ? testContent : runtimeOptions;
-  let context = new TestContext(testName, moduleContext);
-
-  return it(testName, { concurrency: true, ...targetRuntimeOptions }, async function () {
-    let result;
-    for (let module of context.module.moduleChain) {
-      for (let hook of module.beforeEachHooks) {
-        await hook.call(context, context.assert);
-      }
-    }
-
-    result = await targetTestContent.call(context, context.assert, { testName, options: runtimeOptions });
-
-    await context.assert.waitForAsyncOps();
-
-    for (let i = context.module.moduleChain.length - 1; i >= 0; i--) {
-      let module = context.module.moduleChain[i];
-      for (let j = module.afterEachHooks.length - 1; j >= 0; j--) {
-        await module.afterEachHooks[j].call(context, context.assert);
-      }
-    }
-
-    return result;
-  });
-}
-
-export default { module, test, config: {} };
+export default { AssertionError: Assert.AssertionError, module, test, config: {} };