kempo-testing-framework 1.2.4 → 1.3.4

package/src/runBrowserTests.js

@@ -1,87 +1,87 @@
-import { startServer, stopServer } from './browserTestServer.js';
-import puppeteer from 'puppeteer';
-import LOG_LEVELS from './utils/logLevels.js';
-
-export default async ({
-  testFile,
-  filter = false,
-  showBrowser = false,
-  port = 3000,
-  logLevel,
-  delayMs = 0
-}) => {
-  /*
-   * Start Test Server
-   */
-  const url = await startServer(port);
-  
-  if(logLevel >= LOG_LEVELS.VERBOSE){
-    console.log(`\x1b[90m Browser test server started at ${url}\x1b[0m`);
-  }
-  
-  const sleep = (ms) => new Promise(r => setTimeout(r, ms));
-  try {
-    /*
-     * Launch Browser and Execute Tests
-     */
-    const launchOptions = {
-      headless: !showBrowser,
-      args: ['--no-sandbox', '--disable-setuid-sandbox'],
-      defaultViewport: { width: 1600, height: 900 }
-    };
-    if (showBrowser) {
-      launchOptions.devtools = true;
-      launchOptions.args.push('--auto-open-devtools-for-tabs');
-    }
-
-    const browser = await puppeteer.launch(launchOptions);
-    const page = await browser.newPage();
-
-    // Optional pre-delay when a visible browser is requested
-    if (showBrowser && delayMs > 0) {
-      if (logLevel >= LOG_LEVELS.VERBOSE) {
-        console.log(`\x1b[90m Applying pre-test browser delay: ${delayMs}ms\x1b[0m`);
-      }
-      await sleep(delayMs);
-    }
-
-    await page.goto(`${url}?testFile=${testFile}&testFilter=${filter}&delay=${delayMs}`);
-    await page.waitForFunction(() => document.readyState === 'complete' || document.readyState === 'interactive');
-    
-    // Ensure the test page has focus when browser is visible
-    if (showBrowser) {
-      await page.bringToFront();
-      if (logLevel >= LOG_LEVELS.VERBOSE) {
-        console.log(`\x1b[90m Bringing test page to front\x1b[0m`);
-      }
-    }
-    
-    // Check for any errors first
-    const hasError = await page.evaluate(() => window.error !== undefined);
-    if (hasError) {
-      const error = await page.evaluate(() => window.error);
-      throw new Error(`Browser test error: ${error}`);
-    }
-    
-    await page.waitForFunction(() => window.results !== undefined, { timeout: 20000 });
-    const results = await page.evaluate(() => window.results);
-
-    // Optional post-delay when a visible browser is requested
-    if (showBrowser && delayMs > 0) {
-      if (logLevel >= LOG_LEVELS.VERBOSE) {
-        console.log(`\x1b[90m Applying post-test browser delay: ${delayMs}ms\x1b[0m`);
-      }
-      await sleep(delayMs);
-    }
-    
-    /*
-     * Cleanup
-     */
-    await browser.close();
-    await stopServer();
-    return results;
-  } catch(error){
-    await stopServer();
-    throw error;
-  }
-};
+import { startServer, stopServer } from './browserTestServer.js';
+import puppeteer from 'puppeteer';
+import LOG_LEVELS from './utils/logLevels.js';
+
+export default async ({
+  testFile,
+  filter = false,
+  showBrowser = false,
+  port = 3000,
+  logLevel,
+  delayMs = 0
+}) => {
+  /*
+   * Start Test Server
+   */
+  const url = await startServer(port);
+  
+  if(logLevel >= LOG_LEVELS.VERBOSE){
+    console.log(`\x1b[90m Browser test server started at ${url}\x1b[0m`);
+  }
+  
+  const sleep = (ms) => new Promise(r => setTimeout(r, ms));
+  try {
+    /*
+     * Launch Browser and Execute Tests
+     */
+    const launchOptions = {
+      headless: !showBrowser,
+      args: ['--no-sandbox', '--disable-setuid-sandbox'],
+      defaultViewport: { width: 1600, height: 900 }
+    };
+    if (showBrowser) {
+      launchOptions.devtools = true;
+      launchOptions.args.push('--auto-open-devtools-for-tabs');
+    }
+
+    const browser = await puppeteer.launch(launchOptions);
+    const page = await browser.newPage();
+
+    // Optional pre-delay when a visible browser is requested
+    if (showBrowser && delayMs > 0) {
+      if (logLevel >= LOG_LEVELS.VERBOSE) {
+        console.log(`\x1b[90m Applying pre-test browser delay: ${delayMs}ms\x1b[0m`);
+      }
+      await sleep(delayMs);
+    }
+
+    await page.goto(`${url}?testFile=${testFile}&testFilter=${filter}&delay=${delayMs}`);
+    await page.waitForFunction(() => document.readyState === 'complete' || document.readyState === 'interactive');
+    
+    // Ensure the test page has focus when browser is visible
+    if (showBrowser) {
+      await page.bringToFront();
+      if (logLevel >= LOG_LEVELS.VERBOSE) {
+        console.log(`\x1b[90m Bringing test page to front\x1b[0m`);
+      }
+    }
+    
+    // Check for any errors first
+    const hasError = await page.evaluate(() => window.error !== undefined);
+    if (hasError) {
+      const error = await page.evaluate(() => window.error);
+      throw new Error(`Browser test error: ${error}`);
+    }
+    
+    await page.waitForFunction(() => window.results !== undefined, { timeout: 20000 });
+    const results = await page.evaluate(() => window.results);
+
+    // Optional post-delay when a visible browser is requested
+    if (showBrowser && delayMs > 0) {
+      if (logLevel >= LOG_LEVELS.VERBOSE) {
+        console.log(`\x1b[90m Applying post-test browser delay: ${delayMs}ms\x1b[0m`);
+      }
+      await sleep(delayMs);
+    }
+    
+    /*
+     * Cleanup
+     */
+    await browser.close();
+    await stopServer();
+    return results;
+  } catch(error){
+    await stopServer();
+    throw error;
+  }
+};

package/src/runTestFiles.js

@@ -1,94 +1,94 @@
-import findTests from './findTests.js';
-import runNodeTests from './runTests.js';
-import runBrowserTests from './runBrowserTests.js';
-import path from 'path';
-
-/**
- * Runs test files and returns results without logging
- * @param {Object} options - Configuration options
- * @param {string} options.suiteFilter - Filter for test suites
- * @param {string} options.testFilter - Filter for individual tests
- * @param {boolean} options.shouldRunBrowser - Whether to run browser tests
- * @param {boolean} options.shouldRunNode - Whether to run node tests
- * @param {boolean} options.showBrowser - Whether to show browser during tests
- * @param {number} options.port - Port for browser tests
- * @param {number} options.logLevel - Log level for browser tests
- * @param {number} options.delayMs - Optional delay in ms to apply for browser runs
- * @param {Function} options.onNodeTestStart - Callback when a node test starts
- * @param {Function} options.onBrowserTestStart - Callback when a browser test starts
- * @param {string[]} options.specificFiles - Array of specific test files to run (overrides findTests)
- * @returns {Promise<{nodeResults: Object, browserResults: Object}>}
- */
-export default async ({
-  suiteFilter = '',
-  testFilter = '',
-  shouldRunBrowser = true,
-  shouldRunNode = true,
-  showBrowser = false,
-  port = 3000,
-  logLevel = 2,
-  delayMs = 0,
-  onNodeTestStart,
-  onBrowserTestStart,
-  specificFiles = null
-}) => {
-  let nodeTests = [];
-  let browserTests = [];
-
-  if (specificFiles) {
-    // When specific files are provided, use them directly
-    for (const file of specificFiles) {
-      if (file.endsWith('.node-test.js') && shouldRunNode) {
-        nodeTests.push(file);
-      } else if (file.endsWith('.browser-test.js') && shouldRunBrowser) {
-        browserTests.push(file);
-      } else if (file.endsWith('.test.js')) {
-        // Generic test files can be both
-        if (shouldRunNode) nodeTests.push(file);
-        if (shouldRunBrowser) browserTests.push(file);
-      }
-    }
-  } else {
-    // Use findTests for discovery
-    const result = await findTests(suiteFilter, testFilter, shouldRunBrowser, shouldRunNode);
-    nodeTests = result.nodeTests;
-    browserTests = result.browserTests;
-  }
-
-  /*
-   * Node Test Execution
-   */
-  const nodeResults = {};
-  if(nodeTests.length){
-    for(const file of nodeTests){
-      if(onNodeTestStart) onNodeTestStart(file);
-      // Convert forward slashes back to OS-specific path separators for file system operations
-      const normalizedFile = file.replace(/\//g, path.sep);
-      const module = await import(`file://${path.resolve(process.cwd(), normalizedFile)}`);
-      nodeResults[file] = await runNodeTests(module, testFilter);
-    }
-  }
-
-  /*
-   * Browser Test Execution
-   */
-  const browserResults = {};
-  if(browserTests.length){
-    for(const testFile of browserTests){
-      if(onBrowserTestStart) onBrowserTestStart(testFile);
-      browserResults[testFile] = await runBrowserTests({
-        testFile,
-        filter: testFilter, // Changed from testFilter to filter
-        showBrowser,
-        port,
-        logLevel,
-        delayMs
-      });
-    }
-  }
-
-  return {
-    nodeResults,
-    browserResults
-  };
-};
+import findTests from './findTests.js';
+import runNodeTests from './runTests.js';
+import runBrowserTests from './runBrowserTests.js';
+import path from 'path';
+
+/**
+ * Runs test files and returns results without logging
+ * @param {Object} options - Configuration options
+ * @param {string} options.suiteFilter - Filter for test suites
+ * @param {string} options.testFilter - Filter for individual tests
+ * @param {boolean} options.shouldRunBrowser - Whether to run browser tests
+ * @param {boolean} options.shouldRunNode - Whether to run node tests
+ * @param {boolean} options.showBrowser - Whether to show browser during tests
+ * @param {number} options.port - Port for browser tests
+ * @param {number} options.logLevel - Log level for browser tests
+ * @param {number} options.delayMs - Optional delay in ms to apply for browser runs
+ * @param {Function} options.onNodeTestStart - Callback when a node test starts
+ * @param {Function} options.onBrowserTestStart - Callback when a browser test starts
+ * @param {string[]} options.specificFiles - Array of specific test files to run (overrides findTests)
+ * @returns {Promise<{nodeResults: Object, browserResults: Object}>}
+ */
+export default async ({
+  suiteFilter = '',
+  testFilter = '',
+  shouldRunBrowser = true,
+  shouldRunNode = true,
+  showBrowser = false,
+  port = 3000,
+  logLevel = 2,
+  delayMs = 0,
+  onNodeTestStart,
+  onBrowserTestStart,
+  specificFiles = null
+}) => {
+  let nodeTests = [];
+  let browserTests = [];
+
+  if (specificFiles) {
+    // When specific files are provided, use them directly
+    for (const file of specificFiles) {
+      if (file.endsWith('.node-test.js') && shouldRunNode) {
+        nodeTests.push(file);
+      } else if (file.endsWith('.browser-test.js') && shouldRunBrowser) {
+        browserTests.push(file);
+      } else if (file.endsWith('.test.js')) {
+        // Generic test files can be both
+        if (shouldRunNode) nodeTests.push(file);
+        if (shouldRunBrowser) browserTests.push(file);
+      }
+    }
+  } else {
+    // Use findTests for discovery
+    const result = await findTests(suiteFilter, testFilter, shouldRunBrowser, shouldRunNode);
+    nodeTests = result.nodeTests;
+    browserTests = result.browserTests;
+  }
+
+  /*
+   * Node Test Execution
+   */
+  const nodeResults = {};
+  if(nodeTests.length){
+    for(const file of nodeTests){
+      if(onNodeTestStart) onNodeTestStart(file);
+      // Convert forward slashes back to OS-specific path separators for file system operations
+      const normalizedFile = file.replace(/\//g, path.sep);
+      const module = await import(`file://${path.resolve(process.cwd(), normalizedFile)}`);
+      nodeResults[file] = await runNodeTests(module, testFilter);
+    }
+  }
+
+  /*
+   * Browser Test Execution
+   */
+  const browserResults = {};
+  if(browserTests.length){
+    for(const testFile of browserTests){
+      if(onBrowserTestStart) onBrowserTestStart(testFile);
+      browserResults[testFile] = await runBrowserTests({
+        testFile,
+        filter: testFilter, // Changed from testFilter to filter
+        showBrowser,
+        port,
+        logLevel,
+        delayMs
+      });
+    }
+  }
+
+  return {
+    nodeResults,
+    browserResults
+  };
+};

package/src/runTests.js

@@ -1,83 +1,83 @@
-const wait = ms => new Promise(r => setTimeout(r, ms));
-
-export default async ({
-  beforeAll = async () => {},
-  beforeEach = async () => {},
-  afterEach = async () => {},
-  afterAll = async () => {},
-  default: tests
-} = {}, filter = false, delay = 0) => {
-  const testsToRun = filter ? Object.keys(tests).filter(name => name.trim().toLowerCase().includes(filter.trim().toLowerCase())) : Object.keys(tests);
-  if(!testsToRun.length) throw new Error('No tests found matching the filter');
-  
-  /*
-   * Test Results Structure
-   */
-  const results = {
-    beforeAllLogs: [],
-    tests: {},
-    afterAllLogs: []
-  };
-  
-  /*
-   * Execute beforeAll Hook
-   */
-  await beforeAll(message => {
-    results.beforeAllLogs.push({
-      message,
-      type: 'log',
-      level: 3
-    });
-  });
-  
-  /*
-   * Execute Individual Tests
-   */
-  for (const name of testsToRun) {
-    const result = {
-      logs: [],
-      passed: null
-    };
-    const log = (message, type = 'log', level = 3) => {
-      result.logs.push({
-        message,
-        type,
-        level
-      });
-    };
-    log(`== Starting Test "${name}" ==`, 'progress', 3);
-    log('== Before Each ==', 'progress', 3);
-    await beforeEach(log);
-    await tests[name]({
-      log,
-      pass: message => {
-        result.passed = true;
-        log(message, 'pass', 2); // was 3; make visible at NORMAL
-      },
-      fail: message => {
-        result.passed = false;
-        log(message, 'fail', 2);
-      }
-    });
-    await afterEach(log);
-    log('== After Each ==', 'progress', 3);
-    if(!result.passed){ // If the test failed, elevate all logs to a level 2
-      result.logs.forEach(log => log.level = 2);
-    }
-    results.tests[name] = result;
-    await wait(delay);
-  }
-  
-  /*
-   * Execute afterAll Hook
-   */
-  await afterAll(message => {
-    results.afterAllLogs.push({
-      message,
-      type: 'log',
-      level: 3
-    });
-  });
-  
-  return results;
-};
+const wait = ms => new Promise(r => setTimeout(r, ms));
+
+export default async ({
+  beforeAll = async () => {},
+  beforeEach = async () => {},
+  afterEach = async () => {},
+  afterAll = async () => {},
+  default: tests
+} = {}, filter = false, delay = 0) => {
+  const testsToRun = filter ? Object.keys(tests).filter(name => name.trim().toLowerCase().includes(filter.trim().toLowerCase())) : Object.keys(tests);
+  if(!testsToRun.length) throw new Error('No tests found matching the filter');
+  
+  /*
+   * Test Results Structure
+   */
+  const results = {
+    beforeAllLogs: [],
+    tests: {},
+    afterAllLogs: []
+  };
+  
+  /*
+   * Execute beforeAll Hook
+   */
+  await beforeAll(message => {
+    results.beforeAllLogs.push({
+      message,
+      type: 'log',
+      level: 3
+    });
+  });
+  
+  /*
+   * Execute Individual Tests
+   */
+  for (const name of testsToRun) {
+    const result = {
+      logs: [],
+      passed: null
+    };
+    const log = (message, type = 'log', level = 3) => {
+      result.logs.push({
+        message,
+        type,
+        level
+      });
+    };
+    log(`== Starting Test "${name}" ==`, 'progress', 3);
+    log('== Before Each ==', 'progress', 3);
+    await beforeEach(log);
+    await tests[name]({
+      log,
+      pass: message => {
+        result.passed = true;
+        log(message, 'pass', 2); // was 3; make visible at NORMAL
+      },
+      fail: message => {
+        result.passed = false;
+        log(message, 'fail', 2);
+      }
+    });
+    await afterEach(log);
+    log('== After Each ==', 'progress', 3);
+    if(!result.passed){ // If the test failed, elevate all logs to a level 2
+      result.logs.forEach(log => log.level = 2);
+    }
+    results.tests[name] = result;
+    await wait(delay);
+  }
+  
+  /*
+   * Execute afterAll Hook
+   */
+  await afterAll(message => {
+    results.afterAllLogs.push({
+      message,
+      type: 'log',
+      level: 3
+    });
+  });
+  
+  return results;
+};

package/src/utils/logLevels.js

@@ -1,7 +1,7 @@
-export default {
-  SILENT: 0,    // No output except final summary
-  MINIMAL: 1,   // Only test names and pass/fail status
-  NORMAL: 2,    // Test names, status, and logs from failed tests
-  VERBOSE: 3,   // All test output including logs from passing tests
-  DEBUG: 4      // Everything including framework internals
-};
+export default {
+  SILENT: 0,    // No output except final summary
+  MINIMAL: 1,   // Only test names and pass/fail status
+  NORMAL: 2,    // Test names, status, and logs from failed tests
+  VERBOSE: 3,   // All test output including logs from passing tests
+  DEBUG: 4      // Everything including framework internals
+};

package/test.html

@@ -1,31 +1,31 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Test</title>
-</head>
-<body>
-  <script type="module">
-    import runTests from './runTests.js';
-    
-    (async () => {
-      try {
-        const urlParams = new URLSearchParams(window.location.search);
-        const testFile = urlParams.get('testFile');
-        const testFilter = urlParams.get('testFilter');
-        const delay = parseInt(urlParams.get('delay') || '0', 10) || 0;
-        if(!testFile){
-          throw new Error('No test file provided');
-        }
-        const testsModule = await import(`/${testFile}`);
-        const results = await runTests(testsModule, testFilter, delay);
-        window.results = results;
-      } catch (error) {
-        console.error('Browser test error:', error);
-        window.error = error.message || String(error);
-      }
-    })();
-  </script>
-</body>
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Test</title>
+</head>
+<body>
+  <script type="module">
+    import runTests from './runTests.js';
+    
+    (async () => {
+      try {
+        const urlParams = new URLSearchParams(window.location.search);
+        const testFile = urlParams.get('testFile');
+        const testFilter = urlParams.get('testFilter');
+        const delay = parseInt(urlParams.get('delay') || '0', 10) || 0;
+        if(!testFile){
+          throw new Error('No test file provided');
+        }
+        const testsModule = await import(`/${testFile}`);
+        const results = await runTests(testsModule, testFilter, delay);
+        window.results = results;
+      } catch (error) {
+        console.error('Browser test error:', error);
+        window.error = error.message || String(error);
+      }
+    })();
+  </script>
+</body>
 </html>

package/tests/Counter.js

@@ -1,34 +1,34 @@
-class Counter extends HTMLElement {
-  constructor() {
-    super();
-    this.attachShadow({ mode: 'open' });
-    this.count = 0;
-  }
-
-  connectedCallback() {
-    this.render();
-    this.shadowRoot.querySelector('button').addEventListener('click', this.increment);
-  }
-
-  disconnectedCallback() {
-    const button = this.shadowRoot.querySelector('button');
-    if (button) {
-      button.removeEventListener('click', this.increment);
-    }
-  }
-
-  increment = () => {
-    this.count++;
-    this.render();
-  }
-
-  render() {
-    this.shadowRoot.innerHTML = `
-      <button>Increment</button>
-      <div>Count: ${this.count}</div>
-    `;
-    this.shadowRoot.querySelector('button').addEventListener('click', this.increment);
-  }
-}
-
+class Counter extends HTMLElement {
+  constructor() {
+    super();
+    this.attachShadow({ mode: 'open' });
+    this.count = 0;
+  }
+
+  connectedCallback() {
+    this.render();
+    this.shadowRoot.querySelector('button').addEventListener('click', this.increment);
+  }
+
+  disconnectedCallback() {
+    const button = this.shadowRoot.querySelector('button');
+    if (button) {
+      button.removeEventListener('click', this.increment);
+    }
+  }
+
+  increment = () => {
+    this.count++;
+    this.render();
+  }
+
+  render() {
+    this.shadowRoot.innerHTML = `
+      <button>Increment</button>
+      <div>Count: ${this.count}</div>
+    `;
+    this.shadowRoot.querySelector('button').addEventListener('click', this.increment);
+  }
+}
+
 customElements.define('my-counter', Counter);