testem 3.20.1 → 3.21.0

package/README.md

@@ -33,7 +33,7 @@ Features
 
 Installation
 ------------
-Testem needs a supported **[Node.js](https://nodejs.org/)** runtime. The required range is defined in [`package.json`](package.json) under `engines` (currently **^20.19.0**, **^22.12.0**, or **>=24.0.0**).
+Testem needs a supported **[Node.js](https://nodejs.org/)** runtime. The required range is defined in [`package.json`](package.json) under `engines` (currently **^20.19.0**, **^22.12.0**, **^24.0.0**, or **>= 26.0.0**).
 
 **Recommended:** install Testem **both** as a **dev dependency** (so your project pins a version) **and** **globally** (so the `testem` command is always available on your `PATH`):
 
@@ -278,7 +278,7 @@ This calls for the `testem.json` configuration file (you can also alternatively
 
 ```json
 {
-  "framework": "jasmine",
+  "framework": "jasmine2",
   "src_files": [
     "hello.js",
     "hello_spec.js"
@@ -286,6 +286,8 @@ This calls for the `testem.json` configuration file (you can also alternatively
 }
 ```
 
+The default `framework` is still `"jasmine"` (Jasmine 1.x). That default is **deprecated** and will be removed in the next version of Testem. New projects should use `"jasmine2"` with `jasmine-core` (see [Browser framework dependencies](#browser-framework-dependencies)).
+
 The `src_files` can also be unix glob patterns.
 
 ```json
@@ -312,6 +314,48 @@ You can also ignore certain files using `src_files_ignore`.
 
 Read [more details](docs/config_file.md) about the config options.
 
+Browser framework dependencies
+------------------------------
+
+Built-in `mocha`, `mocha+chai`, `qunit`, and `jasmine2` runners **prefer** files from `/node_modules/` in the project `cwd`. If those packages are not installed, Testem still loads the previous CDN URLs (Mocha 2.3.4, Chai 3.4.1, QUnit 1.20.0, Jasmine 2.4.1). Installing the packages is optional on this version and required in the next major version.
+
+| `framework` | Install for modern versions |
+|---|---|
+| `jasmine2` | `jasmine-core` |
+| `qunit` | `qunit` |
+| `mocha` | `mocha` |
+| `mocha+chai` | `mocha` and `chai` |
+
+Run `npm install` in the project directory. In a monorepo, or when `cwd` is not the install root, map the path with `routes`:
+
+```json
+{
+  "routes": {
+    "/node_modules": "../node_modules"
+  }
+}
+```
+
+The `mocha+chai` runner loads local Chai when Mocha is also local. Chai 4 uses the UMD build `chai/chai.js` as a classic script. Chai 5+ (`"type": "module"`) is imported as an ES module, then your spec files load as classic scripts (`var expect = chai.expect` still works).
+
+`jasmine2` uses `jasmine-core` 5 `boot0.js`/`boot1.js` when those files are present, and `boot.js` for jasmine-core 3/4. Incomplete installs fall back to the CDN pin.
+
+### Jasmine 1.x deprecation
+
+`framework: "jasmine"` (the default) still runs Jasmine 1.3.1 from CDN. Testem logs a deprecation warning on the server, and the Jasmine 1 adapter logs a warning in the browser (including custom `test_page`s that still load Jasmine 1).
+
+**The next version of Testem will not support Jasmine 1.** Migrate with:
+
+```json
+{
+  "framework": "jasmine2"
+}
+```
+
+```bash
+npm install --save-dev jasmine-core
+```
+
 Custom Test Pages
 -----------------
 
@@ -330,7 +374,7 @@ Next, the test page you use needs to have the adapter code installed on them, as
 
 ### Include Snippet
 
-Include this snippet directly after your `jasmine.js`, `qunit.js` or `mocha.js` scripts to enable *Testem* with your test page.
+Include this snippet directly after your `jasmine.js`, `qunit.js` or `mocha.js` scripts to enable *Testem* with your test page. Prefer loading those frameworks from `/node_modules/...` (see [examples/qunit_lazy](examples/qunit_lazy) and [examples/vite](examples/vite)); CDN URLs still work.
 
 ```html
 <script src="/testem.js"></script>
@@ -340,9 +384,11 @@ Or if you are using require.js or another loader, just make sure you load `/test
 
 '/testem.js' here is dynamically generated to be used client-side and it should not be confused with server-side 'testem.js'.
 
-### Dynamic Substitution
+### Dynamic Substitution (deprecated)
+
+Naming `test_page` with a `.mustache` extension to interpolate `serve_files` / `css_files` is **deprecated** and will be removed in Testem 4. Prefer a static HTML page and include `<script src="/testem.js"></script>` as shown above.
 
-To enable dynamic substitutions within the JavaScript files in your custom test page, you must
+On Testem 3.x the old form still works:
 
 1. name your test page using `.mustache` as the extension
 2. use `{{#serve_files}}` to loop over the set of JavaScript files to be served, and then reference its `src` property to access their path (or `{{#css_files}}` for stylesheets)
@@ -357,6 +403,28 @@ Example:
     <link rel="stylesheet" href="{{src}}">
     {{/css_files}}
 
+To migrate, rename the page to `.html`, list the same scripts and styles as tags, and point `test_page` at that file. `serve_files` can stay in config for watching or compilation; it no longer needs to be injected.
+
+Before:
+
+```html
+{{#serve_files}}
+<script src="{{src}}"></script>
+{{/serve_files}}
+{{#css_files}}
+<link rel="stylesheet" href="{{src}}">
+{{/css_files}}
+```
+
+After, if config has `"serve_files": ["test-bundle.js"]` and `"css_files": ["app.css"]`:
+
+```html
+<script src="test-bundle.js"></script>
+<link rel="stylesheet" href="app.css">
+```
+
+Keep `/testem.js` and your test framework scripts in the same order as a normal custom page. If you interpolated other config keys (`{{port}}`, custom options), bake those values into the HTML or generate the page in `before_tests`.
+
 ### Multiple Test Pages
 
 You can also specify multiple test pages to run by passing an array to the `test_page` option.
@@ -576,7 +644,7 @@ Simply add a `proxies` section to the `testem.json` configuration file.
 ```
 
 This functionality is implemented as a *transparent proxy*, hence a request to
-`http://localhost:7357/api/posts.json` will be proxied to `http://localhost:4200/api/posts.json` without removing the `/api` prefix. Setting the `secure` option to `false` as in the above `/xmlapi` configuration block will ignore TLS certificate validation and allow tests to successfully reach that URL even if testem was launched over HTTP. Other available options can be found here: https://github.com/http-party/node-http-proxy#options
+`http://localhost:7357/api/posts.json` will be proxied to `http://localhost:4200/api/posts.json` without removing the `/api` prefix. Setting the `secure` option to `false` as in the above `/xmlapi` configuration block will ignore TLS certificate validation and allow tests to successfully reach that URL even if testem was launched over HTTP. Other available options can be found here: https://github.com/unjs/httpxy#options
 
 To limit the functionality to only certain content types, use "onlyContentTypes".
 
@@ -585,7 +653,9 @@ Preprocessors (Babel, TypeScript, LESS, Sass, Browserify, CoffeeScript, etc)
 
 If you need to run a preprocessor (or indeed any shell command before the start of the tests) use the `before_tests` option, such as
 
-    "before_tests": "coffee -c *.coffee"
+    "before_tests": "coffee -c hello.coffee tests.coffee"
+
+On Windows, list files explicitly in string hooks like this—cmd.exe does not expand `*` for external programs (see [Available hooks](docs/config_file.md#available-hooks) and the [coffeescript example](examples/coffeescript)). Testem's own `src_files` / `watch_files` globs are expanded by Testem, not by the hook shell.
 
 or, with Babel (see the [Babel example](https://github.com/testem/testem/tree/master/examples/babel)):
 

package/lib/api.js

@@ -25,7 +25,7 @@ const Server = require('./server');
   launch_in_dev:        [Array]   list of launchers to use for dev runs
   launch_in_ci:         [Array]   list of launchers to use for CI runs
   timeout:              [Number]  timeout for a browser
-  framework:            [String]  test framework to use
+  framework:            [String]  test framework to use (jasmine [deprecated Jasmine 1.x], jasmine2, qunit, mocha, mocha+chai, custom, tap)
   url:                  [String]  url server runs at (http://{host}:{port}/)
   src_files:            [Array]   list of files or file patterns to use
   src_files_ignore:     [Array]   list of files or file patterns to exclude from usage

package/lib/reporters/dot_reporter.js

@@ -1,7 +1,7 @@
 
 
+const { inspect } = require('util');
 const indent = require('../utils/strutils').indent;
-const printf = require('printf');
 const displayutils = require('../utils/displayutils');
 
 module.exports = class DotReporter {
@@ -78,20 +78,20 @@ module.exports = class DotReporter {
         return;
       }
 
-      printf(this.out, '%*d) [%s] %s\n', idx + 1, 3, data.launcher, result.name);
+      this.out.write(`${String(idx + 1).padStart(3)}) [${data.launcher}] ${result.name}\n`);
 
       if (error.message) {
-        printf(this.out, '     %s\n', error.message);
+        this.out.write(`     ${error.message}\n`);
       }
 
       if ('expected' in error && 'actual' in error) {
-        printf(this.out, '\n' +
-               '     expected: %s%O\n' +
-               '       actual: %O\n', (error.negative ? 'NOT ' : ''), error.expected, error.actual);
+        this.out.write('\n' +
+               `     expected: ${error.negative ? 'NOT ' : ''}${inspect(error.expected)}\n` +
+               `       actual: ${inspect(error.actual)}\n`);
       }
 
       if (error.stack) {
-        printf(this.out, '\n%s', indent(error.stack, 5));
+        this.out.write(`\n${indent(error.stack, 5)}`);
       }
 
       this.out.write('\n\n');

package/lib/runner_pages/custom.js

@@ -0,0 +1,18 @@
+const { scriptTags, styleTags } = require('./html');
+
+module.exports = function renderCustomRunner({
+  scripts, styles, footer_scripts
+}) {
+  return `<!doctype html>
+<html>
+<head>
+  <title>Test'em</title>
+  <script src="/testem.js"></script>
+  ${scriptTags(scripts)}
+  ${styleTags(styles)}
+</head>
+<body>
+</body>
+${scriptTags(footer_scripts)}
+</html>`;
+};

package/lib/runner_pages/directory.js

@@ -0,0 +1,12 @@
+const { escapeHtml } = require('./html');
+
+module.exports = function renderDirectoryListing({ files }) {
+  const items = (files || []).map(name => {
+    const safe = escapeHtml(name);
+    return `<li><a href="${safe}">${safe}</a></li>`;
+  }).join('');
+  return `<h1>Files In This Directory</h1>
+<ul>
+${items}
+</ul>`;
+};

package/lib/runner_pages/html.js

@@ -0,0 +1,45 @@
+function escapeHtml(value) {
+  return String(value)
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;');
+}
+
+function attrSuffix(attrs) {
+  return (attrs || []).map(attr => ` ${attr}`).join('');
+}
+
+function scriptTags(files) {
+  return (files || [])
+    .map(file => `<script src="${file.src}"${attrSuffix(file.attrs)}></script>`)
+    .join('');
+}
+
+function asHrefList(hrefs) {
+  if (hrefs === undefined || hrefs === null || hrefs === '') {
+    return [];
+  }
+  return Array.isArray(hrefs) ? hrefs : [hrefs];
+}
+
+function styleTags(hrefs) {
+  return asHrefList(hrefs)
+    .map(href => `<link rel="stylesheet" href="${escapeHtml(href)}">`)
+    .join('');
+}
+
+function loadScriptCalls(files) {
+  return (files || []).map(file => {
+    const extra = (file.attrs || []).map(attr => `, '${attr}'`).join('');
+    return `await loadScript('${file.src}'${extra});`;
+  }).join('\n');
+}
+
+module.exports = {
+  escapeHtml,
+  attrSuffix,
+  scriptTags,
+  styleTags,
+  loadScriptCalls
+};

package/lib/runner_pages/index.js

@@ -0,0 +1,19 @@
+const pages = {
+  jasmine: require('./jasmine'),
+  jasmine2: require('./jasmine2'),
+  qunit: require('./qunit'),
+  mocha: require('./mocha'),
+  'mocha+chai': require('./mocha_chai'),
+  custom: require('./custom'),
+  tap: require('./tap')
+};
+
+function renderRunner(framework, data) {
+  const render = pages[framework];
+  return render ? render(data) : null;
+}
+
+module.exports = {
+  renderRunner,
+  renderDirectoryListing: require('./directory')
+};

package/{views/jasminerunner.mustache → lib/runner_pages/jasmine.js}

@@ -1,4 +1,9 @@
-<!doctype html>
+const { scriptTags, styleTags } = require('./html');
+
+module.exports = function renderJasmineRunner({
+  scripts, styles, footer_scripts
+}) {
+  return `<!doctype html>
 <html>
 <head>
   <title>Test'em</title>
@@ -16,14 +21,15 @@
     })();
   </script>
 
-  {{#scripts}}<script src="{{{src}}}"{{#attrs}} {{&.}}{{/attrs}}></script>{{/scripts}}
+  ${scriptTags(scripts)}
 
   <link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/jasmine/1.3.1/jasmine.css">
 
-  {{#styles}}<link rel="stylesheet" href="{{.}}">{{/styles}}
+  ${styleTags(styles)}
 </head>
 <body>
   <div id="jasmine_content"></div>
 </body>
-{{#footer_scripts}}<script src="{{{src}}}"{{#attrs}} {{&.}}{{/attrs}}></script>{{/footer_scripts}}
-</html>
+${scriptTags(footer_scripts)}
+</html>`;
+};

package/lib/runner_pages/jasmine2.js

@@ -0,0 +1,38 @@
+const { scriptTags, styleTags } = require('./html');
+
+module.exports = function renderJasmine2Runner({
+  jasmineJs,
+  jasmineHtml,
+  jasmineCss,
+  jasmineBoot,
+  jasmineCoreV5,
+  scripts,
+  styles,
+  footer_scripts
+}) {
+  const boot = jasmineCoreV5
+    ? `<script src="/node_modules/jasmine-core/lib/jasmine-core/boot0.js"></script>
+  <script src="/node_modules/jasmine-core/lib/jasmine-core/boot1.js"></script>`
+    : `<script src="${jasmineBoot || ''}"></script>`;
+
+  return `<!doctype html>
+<html>
+<head>
+  <title>Test'em</title>
+  <script src="${jasmineJs}"></script>
+  <script src="${jasmineHtml}"></script>
+  ${boot}
+  <script src="/testem.js"></script>
+
+  ${scriptTags(scripts)}
+
+  <link rel="stylesheet" href="${jasmineCss}">
+
+  ${styleTags(styles)}
+</head>
+<body>
+  <div id="jasmine_content"></div>
+</body>
+${scriptTags(footer_scripts)}
+</html>`;
+};

package/lib/runner_pages/mocha.js

@@ -0,0 +1,25 @@
+const { scriptTags, styleTags } = require('./html');
+
+module.exports = function renderMochaRunner({
+  mochaCss, mochaJs, scripts, styles, footer_scripts
+}) {
+  return `<!doctype html>
+<html>
+<head>
+<title>Test'em</title>
+<link rel="stylesheet" href="${mochaCss}">
+<script src="${mochaJs}"></script>
+<script src="/testem.js"></script>
+<script>mocha.setup('bdd')</script>
+${scriptTags(scripts)}
+${styleTags(styles)}
+</head>
+<body>
+<div id="mocha"></div>
+${scriptTags(footer_scripts)}
+<script>
+mocha.run()
+</script>
+</body>
+</html>`;
+};

package/lib/runner_pages/mocha_chai.js

@@ -0,0 +1,83 @@
+const { scriptTags, styleTags, loadScriptCalls } = require('./html');
+
+const LOAD_SCRIPT_HELPER = `function applyScriptAttr(el, attr) {
+  attr = String(attr).trim();
+  var eq = attr.indexOf('=');
+  if (eq === -1) {
+    el.setAttribute(attr, '');
+    return;
+  }
+  var name = attr.slice(0, eq);
+  var value = attr.slice(eq + 1).replace(/^["']|["']$/g, '');
+  el.setAttribute(name, value);
+}
+function loadScript(src) {
+  var attrs = Array.prototype.slice.call(arguments, 1);
+  return new Promise(function(resolve, reject) {
+    var s = document.createElement('script');
+    s.src = src;
+    attrs.forEach(function(attr) { applyScriptAttr(s, attr); });
+    s.onload = resolve;
+    s.onerror = reject;
+    document.body.appendChild(s);
+  });
+}`;
+
+function renderUmd({
+  mochaCss, mochaJs, chaiJs, scripts, styles, footer_scripts
+}) {
+  return `<!doctype html>
+<html>
+<head>
+<title>Test'em</title>
+<link rel="stylesheet" href="${mochaCss}">
+<script src="${mochaJs}"></script>
+<script src="${chaiJs}"></script>
+<script src="/testem.js"></script>
+<script>mocha.setup('bdd')</script>
+${scriptTags(scripts)}
+${styleTags(styles)}
+</head>
+<body>
+<div id="mocha"></div>
+${scriptTags(footer_scripts)}
+<script>
+mocha.run()
+</script>
+</body>
+</html>`;
+}
+
+function renderEsm({
+  mochaCss, mochaJs, chaiJs, scripts, styles, footer_scripts
+}) {
+  const awaits = [loadScriptCalls(scripts), loadScriptCalls(footer_scripts)]
+    .filter(Boolean)
+    .join('\n');
+
+  return `<!doctype html>
+<html>
+<head>
+<title>Test'em</title>
+<link rel="stylesheet" href="${mochaCss}">
+<script src="${mochaJs}"></script>
+<script src="/testem.js"></script>
+<script>mocha.setup('bdd')</script>
+${styleTags(styles)}
+</head>
+<body>
+<div id="mocha"></div>
+<script type="module">
+import * as chai from '${chaiJs}';
+globalThis.chai = chai;
+${LOAD_SCRIPT_HELPER}
+${awaits}
+globalThis.mocha.run();
+</script>
+</body>
+</html>`;
+}
+
+module.exports = function renderMochaChaiRunner(data) {
+  return data.chaiLocal ? renderEsm(data) : renderUmd(data);
+};

package/lib/runner_pages/qunit.js

@@ -0,0 +1,22 @@
+const { scriptTags, styleTags } = require('./html');
+
+module.exports = function renderQunitRunner({
+  qunitJs, qunitCss, scripts, styles, footer_scripts
+}) {
+  return `<!doctype html>
+<html>
+<head>
+<title>Test'em</title>
+<script src="${qunitJs}"></script>
+<script src="/testem.js"></script>
+${scriptTags(scripts)}
+<link rel="stylesheet" href="${qunitCss}"/>
+${styleTags(styles)}
+</head>
+<body>
+<div id="qunit"></div>
+<div id="qunit-fixture"></div>
+</body>
+${scriptTags(footer_scripts)}
+</html>`;
+};

package/{views/taprunner.mustache → lib/runner_pages/tap.js}

@@ -1,4 +1,7 @@
-<!doctype html>
+const { scriptTags } = require('./html');
+
+module.exports = function renderTapRunner({ scripts, footer_scripts }) {
+  return `<!doctype html>
 <html>
 <head>
 <title>Test'em</title>
@@ -11,11 +14,12 @@
 var log = document.getElementById('log')
 Testem.handleConsoleMessage = function(msg){
   Testem.emit('tap', msg)
-  log.appendChild(document.createTextNode(msg + '\n'))
+  log.appendChild(document.createTextNode(msg + '\\n'))
   return false
 }
 </script>
-{{#scripts}}<script src="{{{src}}}"{{#attrs}} {{&.}}{{/attrs}}></script>{{/scripts}}
-{{#footer_scripts}}<script src="{{{src}}}"{{#attrs}} {{&.}}{{/attrs}}></script>{{/footer_scripts}}
+${scriptTags(scripts)}
+${scriptTags(footer_scripts)}
 </body>
-</html>
+</html>`;
+};

package/lib/server/index.js

@@ -19,8 +19,22 @@ var EventEmitter = require('events').EventEmitter;
 var Mustache = require('consolidate').mustache;
 var http = require('http');
 var https = require('https');
-var httpProxy = require('http-proxy');
 const { fromCallback, each } = require('../utils/promises');
+const { resolveRunnerFrameworkAssets } = require('../utils/runner_framework_assets');
+const { warnJasmine1Framework } = require('../utils/jasmine1_deprecation');
+const { warnMustacheTestPage } = require('../utils/mustache_test_page_deprecation');
+const { convertToPosix } = require('../utils/posix');
+const { renderRunner, renderDirectoryListing } = require('../runner_pages');
+
+function browserScriptEntry(file) {
+  if (!file || !file.src) {
+    return file;
+  }
+  return {
+    src: convertToPosix(file.src),
+    attrs: file.attrs
+  };
+}
 
 class Server extends EventEmitter {
   constructor(config) {
@@ -35,7 +49,12 @@ class Server extends EventEmitter {
     this.nextSocketId = 0;
   }
 
-  start() {
+  async start() {
+    if (!this.createProxyServer) {
+      const { createProxyServer } = await import('httpxy');
+      this.createProxyServer = createProxyServer;
+    }
+
     this.createExpress();
 
     // Start the server!
@@ -227,13 +246,22 @@ class Server extends EventEmitter {
     return false;
   }
 
+  sendProxyError(res, err) {
+    const message = (err && (err.message || err.code)) || 'Proxy error';
+    log.error(message);
+    // WebSocket upgrades pass a raw socket with no Express res.
+    if (res && res.status && !res.headersSent) {
+      res.status(500).json({ error: message });
+    }
+  }
+
   configureProxy(app) {
     var proxies = this.config.get('proxies');
     if (proxies) {
-      this.proxy = new httpProxy.createProxyServer({ changeOrigin: true });
+      this.proxy = this.createProxyServer({ changeOrigin: true });
 
       this.proxy.on('error', (err, req, res) => {
-        res && res.status && res.status(500).json(err);
+        this.sendProxyError(res, err);
       });
 
       Object.keys(proxies).forEach((url) => {
@@ -241,7 +269,9 @@ class Server extends EventEmitter {
           // set up proxy for WebSocket
           this.server.on('upgrade', (req, socket, head) => {
             if (req.url.startsWith(url)) {
-              this.proxy.ws(req, socket, head, proxies[url]);
+              var wsOpts = Object.assign({}, proxies[url]);
+              delete wsOpts.onlyContentTypes;
+              this.proxy.ws(req, socket, wsOpts, head).catch(() => {});
             }
           });
           return;
@@ -252,15 +282,21 @@ class Server extends EventEmitter {
         let wIdx = 0;
         const proxyPath =
           url.replace(/\*/g, () => `:_proxyW${wIdx++}`).replace(/\/$/, '') + '{/*_proxyRest}';
-        app.all(proxyPath, (req, res, next) => {
+        app.all(proxyPath, async (req, res, next) => {
           var opts = proxies[url];
           if (this.shouldProxy(req, opts)) {
-            if (opts.host) {
-              opts.target = `http://${opts.host}:${opts.port}`;
-              delete opts.host;
-              delete opts.port;
+            var proxyOpts = Object.assign({}, opts);
+            if (proxyOpts.host) {
+              proxyOpts.target = `http://${proxyOpts.host}:${proxyOpts.port}`;
+              delete proxyOpts.host;
+              delete proxyOpts.port;
+            }
+            delete proxyOpts.onlyContentTypes;
+            try {
+              await this.proxy.web(req, res, proxyOpts);
+            } catch (err) {
+              this.sendProxyError(res, err);
             }
-            this.proxy.web(req, res, opts);
           } else {
             next();
           }
@@ -273,20 +309,23 @@ class Server extends EventEmitter {
     var config = this.config;
     var framework = config.get('framework') || 'jasmine';
     var css_files = config.get('css_files');
-    var templateFile = {
-      jasmine: 'jasminerunner',
-      jasmine2: 'jasmine2runner',
-      qunit: 'qunitrunner',
-      mocha: 'mocharunner',
-      'mocha+chai': 'mochachairunner',
-      custom: 'customrunner',
-      tap: 'taprunner'
-    }[framework] + '.mustache';
-    res.render(`${__dirname}/../../views/${templateFile}`, {
-      scripts: files,
+    if (framework === 'jasmine') {
+      warnJasmine1Framework();
+    }
+    var frameworkAssets = resolveRunnerFrameworkAssets(
+      config.cwd(),
+      config.get('routes') || config.get('route')
+    );
+    var html = renderRunner(framework, Object.assign({
+      scripts: (files || []).map(browserScriptEntry),
       styles: css_files,
-      footer_scripts: footerScripts
-    });
+      footer_scripts: (footerScripts || []).map(browserScriptEntry)
+    }, frameworkAssets));
+    if (html === null) {
+      res.status(500).send('Failed to lookup view "' + framework + '"');
+      return;
+    }
+    res.type('html').send(html);
   }
 
   renderDefaultTestPage(req, res) {
@@ -394,6 +433,7 @@ class Server extends EventEmitter {
       res.write('403 Forbidden');
       res.end();
     } else if (ext === '.mustache') {
+      warnMustacheTestPage();
       config.getTemplateData((err, data) => {
         res.render(filePath, data);
         this.emit('file-requested', filePath);
@@ -410,8 +450,7 @@ class Server extends EventEmitter {
           this.emit('file-requested', filePath);
           if (stat.isDirectory()) {
             return fs.promises.readdir(filePath).then(files => {
-              var dirListingPage = `${__dirname}/../../views/directorylisting.mustache`;
-              res.render(dirListingPage, { files: files });
+              res.type('html').send(renderDirectoryListing({ files: files }));
             });
           }
           res.sendFile(filePath, sendOptions);

package/lib/utils/jasmine1_deprecation.js

@@ -0,0 +1,27 @@
+const log = require('../log');
+
+const JASMINE1_FRAMEWORK_WARNING =
+  'Testem: framework "jasmine" (Jasmine 1.x) is deprecated and will be removed in the next version of Testem. Use "framework": "jasmine2" with the jasmine-core package, or load Jasmine 2+ on a custom test_page.';
+
+let warned = false;
+
+function warnJasmine1Framework() {
+  if (warned) {
+    return;
+  }
+  warned = true;
+  log.warn(JASMINE1_FRAMEWORK_WARNING);
+  process.emitWarning(JASMINE1_FRAMEWORK_WARNING, {
+    code: 'TESTEM_JASMINE1_DEPRECATED'
+  });
+}
+
+function resetJasmine1FrameworkWarning() {
+  warned = false;
+}
+
+module.exports = {
+  JASMINE1_FRAMEWORK_WARNING,
+  warnJasmine1Framework,
+  resetJasmine1FrameworkWarning
+};

package/lib/utils/mustache_test_page_deprecation.js

@@ -0,0 +1,27 @@
+const log = require('../log');
+
+const MUSTACHE_TEST_PAGE_WARNING =
+  'Testem: naming test_page with a .mustache extension is deprecated and will be removed in Testem 4. Use a static HTML page and include <script src="/testem.js"></script>.';
+
+let warned = false;
+
+function warnMustacheTestPage() {
+  if (warned) {
+    return;
+  }
+  warned = true;
+  log.warn(MUSTACHE_TEST_PAGE_WARNING);
+  process.emitWarning(MUSTACHE_TEST_PAGE_WARNING, {
+    code: 'TESTEM_MUSTACHE_TEST_PAGE_DEPRECATED'
+  });
+}
+
+function resetMustacheTestPageWarning() {
+  warned = false;
+}
+
+module.exports = {
+  MUSTACHE_TEST_PAGE_WARNING,
+  warnMustacheTestPage,
+  resetMustacheTestPageWarning
+};

package/lib/utils/report-file.js

@@ -2,7 +2,6 @@
 
 const fs = require('fs');
 const path = require('path');
-const mkdirp = require('mkdirp');
 const PassThrough = require('stream').PassThrough;
 module.exports = class ReportFile {
   constructor(reportFile) {
@@ -10,25 +9,20 @@ module.exports = class ReportFile {
 
     this.outputStream = new PassThrough();
 
-    mkdirp.sync(path.dirname(path.resolve(reportFile)));
+    fs.mkdirSync(path.dirname(path.resolve(reportFile)), { recursive: true });
 
     this.outputStream = fs.createWriteStream(reportFile, { flags: 'w+' });
 
-    let alreadyEnded = false;
-    function finish(data) {
-      if (!alreadyEnded) {
-        alreadyEnded = true;
-        this.outputStream.end(data);
-      }
-    }
-
-    this.outputStream.on('end', finish);
-    this.outputStream.on('error', finish);
-
     this.closePromise = new Promise((resolve, reject) => {
       this.outputStream.on('finish', resolve);
       this.outputStream.on('error', reject);
     });
+
+    // The stream can fail long before anything calls close() - opening an
+    // unwritable report file rejects on the next tick. Attach a no-op handler
+    // so that rejection is not reported as unhandled; close() still returns
+    // closePromise, so the error is surfaced to the caller.
+    this.closePromise.catch(() => {});
   }
 
   close() {

package/lib/utils/runner_framework_assets.js

@@ -0,0 +1,154 @@
+const fs = require('fs');
+const path = require('path');
+
+const CDN = {
+  mochaJs: '//cdnjs.cloudflare.com/ajax/libs/mocha/2.3.4/mocha.js',
+  mochaCss: '//cdnjs.cloudflare.com/ajax/libs/mocha/2.3.4/mocha.css',
+  chaiJs: '//cdnjs.cloudflare.com/ajax/libs/chai/3.4.1/chai.js',
+  jasmineJs: '//cdnjs.cloudflare.com/ajax/libs/jasmine/2.4.1/jasmine.js',
+  jasmineHtml: '//cdnjs.cloudflare.com/ajax/libs/jasmine/2.4.1/jasmine-html.js',
+  jasmineBoot: '//cdnjs.cloudflare.com/ajax/libs/jasmine/2.4.1/boot.js',
+  jasmineCss: '//cdnjs.cloudflare.com/ajax/libs/jasmine/2.4.1/jasmine.css',
+  qunitJs: '//code.jquery.com/qunit/qunit-1.20.0.js',
+  qunitCss: '//code.jquery.com/qunit/qunit-1.20.0.css'
+};
+
+const JASMINE_JS = 'jasmine-core/lib/jasmine-core/jasmine.js';
+const JASMINE_HTML = 'jasmine-core/lib/jasmine-core/jasmine-html.js';
+const JASMINE_CSS = 'jasmine-core/lib/jasmine-core/jasmine.css';
+const JASMINE_BOOT0 = 'jasmine-core/lib/jasmine-core/boot0.js';
+const JASMINE_BOOT1 = 'jasmine-core/lib/jasmine-core/boot1.js';
+const JASMINE_BOOT = 'jasmine-core/lib/jasmine-core/boot.js';
+
+function nodeModulesUrl(relPath) {
+  return '/node_modules/' + relPath.replace(/\\/g, '/');
+}
+
+function nodeModulesDirs(cwd, routes) {
+  const dirs = [path.resolve(cwd, 'node_modules')];
+  const routesObj = routes || {};
+  ['/node_modules', '/node_modules/'].forEach(prefix => {
+    if (!(prefix in routesObj)) {
+      return;
+    }
+    [].concat(routesObj[prefix]).forEach(target => {
+      dirs.push(path.resolve(cwd, target));
+    });
+  });
+  return dirs;
+}
+
+function existsInNodeModules(dirs, relPath) {
+  return dirs.some(dir => fs.existsSync(path.join(dir, relPath)));
+}
+
+function findInNodeModules(dirs, relPath) {
+  for (let i = 0; i < dirs.length; i++) {
+    const full = path.join(dirs[i], relPath);
+    if (fs.existsSync(full)) {
+      return full;
+    }
+  }
+  return null;
+}
+
+function resolveAsset(dirs, relPath, fallbackUrl) {
+  if (existsInNodeModules(dirs, relPath)) {
+    return nodeModulesUrl(relPath);
+  }
+  return fallbackUrl;
+}
+
+function isChaiEsm(dirs) {
+  const pkgPath = findInNodeModules(dirs, 'chai/package.json');
+  if (!pkgPath) {
+    return false;
+  }
+  try {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+    return pkg.type === 'module';
+  } catch {
+    return false;
+  }
+}
+
+function resolveChai(dirs, mochaLocal) {
+  if (!mochaLocal) {
+    return { chaiLocal: false, chaiJs: CDN.chaiJs };
+  }
+  if (existsInNodeModules(dirs, 'chai/chai.js')) {
+    return { chaiLocal: false, chaiJs: nodeModulesUrl('chai/chai.js') };
+  }
+  if (existsInNodeModules(dirs, 'chai/index.js') && isChaiEsm(dirs)) {
+    return { chaiLocal: true, chaiJs: nodeModulesUrl('chai/index.js') };
+  }
+  return { chaiLocal: false, chaiJs: CDN.chaiJs };
+}
+
+function resolveJasmine(dirs) {
+  const hasCore = existsInNodeModules(dirs, JASMINE_JS) &&
+    existsInNodeModules(dirs, JASMINE_HTML) &&
+    existsInNodeModules(dirs, JASMINE_CSS);
+  const jasmineCoreV5 = hasCore &&
+    existsInNodeModules(dirs, JASMINE_BOOT0) &&
+    existsInNodeModules(dirs, JASMINE_BOOT1);
+  const jasmineLegacy = hasCore &&
+    existsInNodeModules(dirs, JASMINE_BOOT) &&
+    !jasmineCoreV5;
+
+  if (jasmineCoreV5) {
+    return {
+      jasmineCoreV5: true,
+      jasmineJs: nodeModulesUrl(JASMINE_JS),
+      jasmineHtml: nodeModulesUrl(JASMINE_HTML),
+      jasmineCss: nodeModulesUrl(JASMINE_CSS),
+      jasmineBoot: null
+    };
+  }
+  if (jasmineLegacy) {
+    return {
+      jasmineCoreV5: false,
+      jasmineJs: nodeModulesUrl(JASMINE_JS),
+      jasmineHtml: nodeModulesUrl(JASMINE_HTML),
+      jasmineCss: nodeModulesUrl(JASMINE_CSS),
+      jasmineBoot: nodeModulesUrl(JASMINE_BOOT)
+    };
+  }
+  return {
+    jasmineCoreV5: false,
+    jasmineJs: CDN.jasmineJs,
+    jasmineHtml: CDN.jasmineHtml,
+    jasmineCss: CDN.jasmineCss,
+    jasmineBoot: CDN.jasmineBoot
+  };
+}
+
+function resolveRunnerFrameworkAssets(cwd, routes) {
+  cwd = cwd || process.cwd();
+  const dirs = nodeModulesDirs(cwd, routes);
+
+  const mochaJs = resolveAsset(dirs, 'mocha/mocha.js', CDN.mochaJs);
+  const mochaCss = resolveAsset(dirs, 'mocha/mocha.css', CDN.mochaCss);
+  const mochaLocal = mochaJs.indexOf('/node_modules/') === 0;
+  const chai = resolveChai(dirs, mochaLocal);
+  const jasmine = resolveJasmine(dirs);
+
+  return {
+    mochaJs,
+    mochaCss,
+    chaiLocal: chai.chaiLocal,
+    chaiJs: chai.chaiJs,
+    jasmineCoreV5: jasmine.jasmineCoreV5,
+    jasmineJs: jasmine.jasmineJs,
+    jasmineHtml: jasmine.jasmineHtml,
+    jasmineBoot: jasmine.jasmineBoot,
+    jasmineCss: jasmine.jasmineCss,
+    qunitJs: resolveAsset(dirs, 'qunit/qunit/qunit.js', CDN.qunitJs),
+    qunitCss: resolveAsset(dirs, 'qunit/qunit/qunit.css', CDN.qunitCss)
+  };
+}
+
+module.exports = {
+  CDN,
+  resolveRunnerFrameworkAssets
+};

package/package.json

@@ -7,7 +7,7 @@
     "unittest",
     "browser"
   ],
-  "version": "3.20.1",
+  "version": "3.21.0",
   "author": "Toby Ho <airportyh@gmail.com>",
   "repository": {
     "type": "git",
@@ -17,7 +17,7 @@
     "url": "https://github.com/testem/testem/issues"
   },
   "engines": {
-    "node": "^20.19.0 || ^22.12.0 || >=24.0.0"
+    "node": "^20.19.0 || ^22.12.0 || ^24.0.0 || >= 26.0.0"
   },
   "license": "MIT",
   "dependencies": {
@@ -31,20 +31,18 @@
     "execa": "^9.6.1",
     "express": "^5.2.1",
     "glob": "^13.0.6",
-    "http-proxy": "^1.18.1",
-    "js-yaml": "^4.1.1",
+    "httpxy": "^0.5.5",
+    "js-yaml": "^5.3.0",
     "lodash": "^4.18.1",
     "minimatch": "^10.2.5",
-    "mkdirp": "^3.0.1",
     "mustache": "^4.2.0",
-    "toasted-notifier": "^10.1.0",
-    "printf": "^0.6.1",
     "proc-log": "^6.1.0",
     "rimraf": "^6.1.3",
     "socket.io": "^4.8.3",
     "spawn-args": "^0.2.0",
     "styled_string": "0.0.1",
-    "tap-parser": "^18.3.0"
+    "tap-parser": "^18.3.0",
+    "toasted-notifier": "^10.1.0"
   },
   "files": [
     "lib",
@@ -52,8 +50,7 @@
     "README.md",
     "testem.js",
     "assets",
-    "package.json",
-    "views"
+    "package.json"
   ],
   "scripts": {
     "test": "mocha tests/*_tests.js tests/**/*_tests.js",
@@ -68,30 +65,23 @@
     "@eslint/eslintrc": "^3.3.5",
     "@eslint/js": "^10.0.1",
     "chai": "^6.2.2",
-    "chai-files": "^1.4.0",
-    "chai-shallow-deep-equal": "^1.4.6",
     "cheerio": "^1.2.0",
     "dirty-chai": "^3.0.0",
-    "esbuild": "^0.27.4",
-    "esbuild-plugins-node-modules-polyfill": "^1.8.1",
+    "esbuild": "^0.28.2",
+    "esbuild-plugins-node-modules-polyfill": "^1.8.3",
     "eslint": "^10.2.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-chai-expect": "^4.0.0",
-    "eslint-plugin-mocha": "^11.2.0",
+    "eslint-plugin-mocha": "^12.0.2",
     "fresh-tape": "^5.9.1",
-    "mocha": "^11.7.5",
-    "saucie": "^4.0.1",
+    "jasmine-core": "^5.1.0",
+    "mocha": "^12.0.0",
+    "qunit": "^2.26.0",
+    "saucie": "^4.1.0",
     "sinon": "^21.0.3",
     "sinon-chai": "^4.0.1",
     "socket.io-client": "^4.8.3"
   },
-  "overrides": {
-    "mocha": {
-      "diff": "^8.0.3",
-      "minimatch": "^9.0.7",
-      "serialize-javascript": "^7.0.5"
-    }
-  },
   "bin": {
     "testem": "./testem.js"
   },

package/public/testem/jasmine_adapter.js

@@ -7,11 +7,17 @@ Testem's adapter for Jasmine. It works by adding a custom reporter.
 
 */
 
-/* globals emit, jasmine */
+/* globals emit, jasmine, console */
 /* exported jasmineAdapter */
 'use strict';
 
 function jasmineAdapter() {
+  if (!jasmineAdapter._deprecationWarned) {
+    jasmineAdapter._deprecationWarned = true;
+    if (typeof console !== 'undefined' && console.warn) {
+      console.warn('Testem: the Jasmine 1.x adapter is deprecated and will be removed in the next version of Testem. Upgrade to Jasmine 2+ (jasmine-core) so Testem can use the jasmine2 adapter.');
+    }
+  }
 
   var results = {
     failed: 0,

package/public/testem/testem_client.js

@@ -80,7 +80,7 @@ function appendTestemIframeOnLoad(callback) {
 var testFrameworkDidInit = false;
 function hookIntoTestFramework(socket) {
   if (testFrameworkDidInit) {
-    return;
+    return true;
   }
 
   var found = true;

package/views/customrunner.mustache

@@ -1,12 +0,0 @@
-<!doctype html>
-<html>
-<head>
-  <title>Test'em</title>
-  <script src="/testem.js"></script>
-  {{#scripts}}<script src="{{{src}}}"{{#attrs}} {{&.}}{{/attrs}}></script>{{/scripts}}
-  {{#styles}}<link rel="stylesheet" href="{{.}}">{{/styles}}
-</head>
-<body>
-</body>
-{{#footer_scripts}}<script src="{{{src}}}"{{#attrs}} {{&.}}{{/attrs}}></script>{{/footer_scripts}}
-</html>

package/views/directorylisting.mustache

@@ -1,4 +0,0 @@
-<h1>Files In This Directory</h1>
-<ul>
-{{#files}}<li><a href="{{.}}">{{.}}</a></li>{{/files}}
-</ul>

package/views/jasmine2runner.mustache

@@ -1,20 +0,0 @@
-<!doctype html>
-<html>
-<head>
-  <title>Test'em</title>
-  <script src="//cdnjs.cloudflare.com/ajax/libs/jasmine/2.4.1/jasmine.js"></script>
-  <script src="//cdnjs.cloudflare.com/ajax/libs/jasmine/2.4.1/jasmine-html.js"></script>
-  <script src="//cdnjs.cloudflare.com/ajax/libs/jasmine/2.4.1/boot.js"></script>
-  <script src="/testem.js"></script>
-
-  {{#scripts}}<script src="{{{src}}}"{{#attrs}} {{&.}}{{/attrs}}></script>{{/scripts}}
-
-  <link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/jasmine/2.4.1/jasmine.css">
-
-  {{#styles}}<link rel="stylesheet" href="{{.}}">{{/styles}}
-</head>
-<body>
-  <div id="jasmine_content"></div>
-</body>
-{{#footer_scripts}}<script src="{{{src}}}"{{#attrs}} {{&.}}{{/attrs}}></script>{{/footer_scripts}}
-</html>

package/views/mochachairunner.mustache

@@ -1,19 +0,0 @@
-<!doctype html>
-<html>
-<head>
-<title>Test'em</title>
-<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/mocha/2.3.4/mocha.css">
-<script src="//cdnjs.cloudflare.com/ajax/libs/mocha/2.3.4/mocha.js"></script>
-<script src="//cdnjs.cloudflare.com/ajax/libs/chai/3.4.1/chai.js"></script>
-<script src="/testem.js"></script>
-<script>mocha.setup('bdd')</script>
-{{#scripts}}<script src="{{{src}}}"{{#attrs}} {{&.}}{{/attrs}}></script>{{/scripts}}
-</head>
-<body>
-<div id="mocha"></div>
-{{#footer_scripts}}<script src="{{{src}}}"{{#attrs}} {{&.}}{{/attrs}}></script>{{/footer_scripts}}
-<script>
-mocha.run()
-</script>
-</body>
-</html>

package/views/mocharunner.mustache

@@ -1,19 +0,0 @@
-<!doctype html>
-<html>
-<head>
-<title>Test'em</title>
-<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/mocha/2.3.4/mocha.css">
-<script src="//cdnjs.cloudflare.com/ajax/libs/mocha/2.3.4/mocha.js"></script>
-<script src="/testem.js"></script>
-<script>mocha.setup('bdd')</script>
-{{#scripts}}<script src="{{{src}}}"{{#attrs}} {{&.}}{{/attrs}}></script>{{/scripts}}
-{{#styles}}<link rel="stylesheet" href="{{.}}">{{/styles}}
-</head>
-<body>
-<div id="mocha"></div>
-{{#footer_scripts}}<script src="{{{src}}}"{{#attrs}} {{&.}}{{/attrs}}></script>{{/footer_scripts}}
-<script>
-mocha.run()
-</script>
-</body>
-</html>

package/views/qunitrunner.mustache

@@ -1,16 +0,0 @@
-<!doctype html>
-<html>
-<head>
-<title>Test'em</title>
-<script src="//code.jquery.com/qunit/qunit-1.20.0.js"></script>
-<script src="/testem.js"></script>
-{{#scripts}}<script src="{{{src}}}"{{#attrs}} {{&.}}{{/attrs}}></script>{{/scripts}}
-<link rel="stylesheet" href="//code.jquery.com/qunit/qunit-1.20.0.css"/>
-{{#styles}}<link rel="stylesheet" href="{{.}}">{{/styles}}
-</head>
-<body>
-<div id="qunit"></div>
-<div id="qunit-fixture"></div>
-</body>
-{{#footer_scripts}}<script src="{{{src}}}"{{#attrs}} {{&.}}{{/attrs}}></script>{{/footer_scripts}}
-</html>