tape-six 1.10.1 → 1.12.0

package/README.md

@@ -427,6 +427,8 @@ Test output can be controlled by flags. See [Supported flags](https://github.com
 
 The most recent releases:
 
+- 1.12.0 _`tape6-server` is now pluggable, embeddable server for hermetic integration tests, runtime plugin registration, and an opt-in HTTP/2 mode._
+- 1.11.0 _Invariant host hooks for the new zero-dependency `tape-six-invariant` companion package. Workaround for a Deno 2.9.0 `node_modules/.bin` symlink regression._
 - 1.10.1 _A workaround for a Bun's bug with streams._
 - 1.10.0 _Worker control channel stops in-flight workers, draining cleanup before a force-kill._
 - 1.9.0 _New features: `t.plan(n)` emits a TAP-comment diagnostic on mismatch, `registerTesterMethod(name, fn)` registers tester plugins idempotently._

package/TESTING.md

@@ -649,7 +649,7 @@ In this example, running `tape6` on Node will execute tests matching `/tests/nod
 
 ## Browser testing
 
-Browser tests use `tape6-server`, a static file server bundled with `tape-six` that provides a web UI for running tests.
+Browser tests use `tape6-server`, a pluggable test server bundled with `tape-six` that serves static files and provides a web UI for running tests. Fixture plugins can be mounted under URL prefixes (`--plugin`, the `tape6.server.plugins` config, or `PUT /--plugins` at runtime), the core is embeddable in tests via `createTestServer()` from `tape-six/test-server.js`, and `--h2` switches to HTTP/2 (Node-only). See the [tape6-server wiki page](https://github.com/uhop/tape-six/wiki/Utility-%E2%80%90-tape6%E2%80%90server) for the plugin contract.
 
 ### Setup
 

package/bin/tape6-deno-main.js

@@ -0,0 +1,104 @@
+import process from 'node:process';
+import {fileURLToPath} from 'node:url';
+
+import {
+  getOptions,
+  initFiles,
+  initReporter,
+  showInfo,
+  printVersion,
+  printHelp,
+  printFlagOptions
+} from '../src/utils/config.js';
+
+import {getReporter, setReporter} from '../src/test.js';
+import {selectTimer} from '../src/utils/timer.js';
+
+import TestWorker from '../src/runners/deno/TestWorker.js';
+
+const rootFolder = Deno.cwd();
+
+const showSelf = () => {
+  const self = new URL(import.meta.url);
+  if (self.protocol === 'file:') {
+    console.log(fileURLToPath(self));
+  } else {
+    console.log(self);
+  }
+  Deno.exit(0);
+};
+
+const showVersion = () => {
+  printVersion('tape6-deno');
+  Deno.exit(0);
+};
+
+const showHelp = () => {
+  printHelp('tape6-deno', 'Tape6 test runner for Deno', 'tape6-deno [options] [files...]', [
+    ['--flags, -f <flags>', 'Set reporter flags (env: TAPE6_FLAGS)'],
+    ['--par, -p <n>', 'Set parallelism level (env: TAPE6_PAR)'],
+    ['--info', 'Show configuration info and exit'],
+    ['--self', 'Print the path to this script and exit'],
+    ['--help, -h', 'Show this help message and exit'],
+    ['--version, -v', 'Show version and exit']
+  ]);
+  printFlagOptions();
+  Deno.exit(0);
+};
+
+const main = async () => {
+  const currentOptions = getOptions({
+    '--self': {fn: showSelf, isValueRequired: false},
+    '--info': {isValueRequired: false},
+    '--help': {aliases: ['-h'], fn: showHelp, isValueRequired: false},
+    '--version': {aliases: ['-v'], fn: showVersion, isValueRequired: false}
+  });
+
+  const [files] = await Promise.all([
+    initFiles(currentOptions.files, rootFolder),
+    initReporter(getReporter, setReporter, currentOptions.flags),
+    selectTimer()
+  ]);
+
+  addEventListener('error', event => {
+    console.log('UNHANDLED ERROR:', event.message);
+    event.preventDefault();
+  });
+
+  if (currentOptions.optionFlags['--info'] === '') {
+    showInfo(currentOptions, files);
+    await new Promise(r => process.stdout.write('', r));
+    process.exitCode = 0;
+    return;
+  }
+
+  if (!files.length) {
+    console.log('No files found.');
+    await new Promise(r => process.stdout.write('', r));
+    process.exitCode = 1;
+    return;
+  }
+
+  const reporter = getReporter(),
+    worker = new TestWorker(reporter, currentOptions.parallel, currentOptions.flags);
+
+  reporter.report({type: 'test', test: 0});
+
+  await new Promise(resolve => {
+    worker.done = () => resolve();
+    worker.execute(files);
+  });
+
+  const hasFailed = reporter.state && reporter.state.failed > 0;
+
+  reporter.report({
+    type: 'end',
+    test: 0,
+    fail: hasFailed
+  });
+
+  await new Promise(r => process.stdout.write('', r));
+  process.exitCode = hasFailed ? 1 : 0;
+};
+
+main().catch(error => console.error('ERROR:', error));

package/bin/tape6-deno.js

@@ -1,106 +1,9 @@
 #!/usr/bin/env -S deno run --allow-all --ext=js
 
-import process from 'node:process';
-import {fileURLToPath} from 'node:url';
+// Deno 2.9.0 doesn't realpath a symlinked entry (denoland/deno#35551), so the
+// `.bin/tape6-deno` symlink would resolve the runner's ../src imports wrong.
+// Realpath this entry, then load the runner (static imports intact) beside it.
+import {fileURLToPath, pathToFileURL} from 'node:url';
 
-import {
-  getOptions,
-  initFiles,
-  initReporter,
-  showInfo,
-  printVersion,
-  printHelp,
-  printFlagOptions
-} from '../src/utils/config.js';
-
-import {getReporter, setReporter} from '../src/test.js';
-import {selectTimer} from '../src/utils/timer.js';
-
-import TestWorker from '../src/runners/deno/TestWorker.js';
-
-const rootFolder = Deno.cwd();
-
-const showSelf = () => {
-  const self = new URL(import.meta.url);
-  if (self.protocol === 'file:') {
-    console.log(fileURLToPath(self));
-  } else {
-    console.log(self);
-  }
-  Deno.exit(0);
-};
-
-const showVersion = () => {
-  printVersion('tape6-deno');
-  Deno.exit(0);
-};
-
-const showHelp = () => {
-  printHelp('tape6-deno', 'Tape6 test runner for Deno', 'tape6-deno [options] [files...]', [
-    ['--flags, -f <flags>', 'Set reporter flags (env: TAPE6_FLAGS)'],
-    ['--par, -p <n>', 'Set parallelism level (env: TAPE6_PAR)'],
-    ['--info', 'Show configuration info and exit'],
-    ['--self', 'Print the path to this script and exit'],
-    ['--help, -h', 'Show this help message and exit'],
-    ['--version, -v', 'Show version and exit']
-  ]);
-  printFlagOptions();
-  Deno.exit(0);
-};
-
-const main = async () => {
-  const currentOptions = getOptions({
-    '--self': {fn: showSelf, isValueRequired: false},
-    '--info': {isValueRequired: false},
-    '--help': {aliases: ['-h'], fn: showHelp, isValueRequired: false},
-    '--version': {aliases: ['-v'], fn: showVersion, isValueRequired: false}
-  });
-
-  const [files] = await Promise.all([
-    initFiles(currentOptions.files, rootFolder),
-    initReporter(getReporter, setReporter, currentOptions.flags),
-    selectTimer()
-  ]);
-
-  addEventListener('error', event => {
-    console.log('UNHANDLED ERROR:', event.message);
-    event.preventDefault();
-  });
-
-  if (currentOptions.optionFlags['--info'] === '') {
-    showInfo(currentOptions, files);
-    await new Promise(r => process.stdout.write('', r));
-    process.exitCode = 0;
-    return;
-  }
-
-  if (!files.length) {
-    console.log('No files found.');
-    await new Promise(r => process.stdout.write('', r));
-    process.exitCode = 1;
-    return;
-  }
-
-  const reporter = getReporter(),
-    worker = new TestWorker(reporter, currentOptions.parallel, currentOptions.flags);
-
-  reporter.report({type: 'test', test: 0});
-
-  await new Promise(resolve => {
-    worker.done = () => resolve();
-    worker.execute(files);
-  });
-
-  const hasFailed = reporter.state && reporter.state.failed > 0;
-
-  reporter.report({
-    type: 'end',
-    test: 0,
-    fail: hasFailed
-  });
-
-  await new Promise(r => process.stdout.write('', r));
-  process.exitCode = hasFailed ? 1 : 0;
-};
-
-main().catch(error => console.error('ERROR:', error));
+const here = pathToFileURL(Deno.realPathSync(fileURLToPath(import.meta.url)));
+await import(new URL('tape6-deno-main.js', here).href);

package/bin/tape6-server.js

@@ -1,28 +1,11 @@
 #!/usr/bin/env node
 
-import http from 'node:http';
-import fs from 'node:fs';
-import path from 'node:path';
 import process from 'node:process';
 import {fileURLToPath} from 'node:url';
 
-import {
-  getConfig,
-  resolveTests,
-  resolvePatterns,
-  printVersion,
-  printHelp
-} from '../src/utils/config.js';
-import {startServer} from '../src/server.js';
-
-const fsp = fs.promises;
-
-const toPosix = files =>
-  path.sep === path.win32.sep
-    ? files.map(f => f.replaceAll(path.win32.sep, path.posix.sep))
-    : files;
-
-// simple static server with no dependencies
+import {printVersion, printHelp} from '../src/utils/config.js';
+import {createTestServer} from '../src/test-server.js';
+import {detectColors, makePaint} from '../src/test-server/trace.js';
 
 const showSelf = () => {
   const self = new URL(import.meta.url);
@@ -34,17 +17,23 @@ const showSelf = () => {
   process.exit(0);
 };
 if (process.argv.includes('--help') || process.argv.includes('-h')) {
-  printHelp('tape6-server', 'Static file server for browser testing', 'tape6-server [options]', [
+  printHelp('tape6-server', 'Pluggable test server for browser testing', 'tape6-server [options]', [
+    ['--plugin path', 'Register a plugin module (repeatable)'],
+    ['--h2', 'Serve HTTPS with HTTP/2 (+ HTTP/1.1 via ALPN); Node only'],
+    ['--no-remote-plugins', 'Disable PUT/DELETE on /--plugins'],
     ['--trace', 'Enable request trace logging'],
     ['--self', 'Print the path to this script and exit'],
     ['--help, -h', 'Show this help message and exit'],
     ['--version, -v', 'Show version and exit']
   ]);
   console.log('\nEnvironment:');
-  console.log('  HOST          Server hostname (default: localhost)');
-  console.log('  PORT          Server port (default: 3000)');
-  console.log('  SERVER_ROOT   Root directory for serving files (default: cwd)');
-  console.log('  WEBAPP_PATH   Path to the web app directory');
+  console.log('  HOST            Server hostname (default: localhost)');
+  console.log('  PORT            Server port (default: 3000)');
+  console.log('  SERVER_ROOT     Root directory for serving files (default: cwd)');
+  console.log('  WEBAPP_PATH     Path to the web app directory');
+  console.log('  TAPE6_PROTOCOL  Protocol: h1 or h2 (default: h1)');
+  console.log('  TAPE6_CERT      Path to a TLS certificate (h2)');
+  console.log('  TAPE6_KEY       Path to its private key (h2)');
   process.exit(0);
 }
 if (process.argv.includes('--version') || process.argv.includes('-v')) {
@@ -53,182 +42,27 @@ if (process.argv.includes('--version') || process.argv.includes('-v')) {
 }
 if (process.argv.includes('--self')) showSelf();
 
-// MIME source: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types
-const mimeTable = {
-    css: 'text/css',
-    csv: 'text/csv',
-    eot: 'application/vnd.ms-fontobject',
-    gif: 'image/gif',
-    html: 'text/html',
-    ico: 'image/vnd.microsoft.icon',
-    jpg: 'image/jpeg',
-    js: 'text/javascript',
-    json: 'application/json',
-    otf: 'font/otf',
-    png: 'image/png',
-    svg: 'image/svg+xml',
-    ttf: 'font/ttf',
-    txt: 'text/plain',
-    webp: 'image/webp',
-    woff: 'font/woff',
-    woff2: 'font/woff2',
-    xml: 'application/xml'
-  },
-  defaultMime = 'application/octet-stream',
-  rootFolder = process.env.SERVER_ROOT || process.cwd(),
-  traceCalls = process.argv.includes('--trace'),
-  hasColors =
-    process.stdout.isTTY &&
-    (typeof process.stdout.hasColors == 'function' ? process.stdout.hasColors() : true);
-
-let webAppPath = process.env.WEBAPP_PATH;
-if (!webAppPath) {
-  const url = import.meta.url;
-  if (!/^file:\/\//i.test(url))
-    throw Error('Cannot identify the location of the web application. Use WEBAPP_PATH.');
-  webAppPath = path.relative(
-    rootFolder,
-    path.join(path.dirname(fileURLToPath(url)), '../web-app/')
-  );
-  if (path.sep === path.win32.sep)
-    webAppPath = webAppPath.replaceAll(path.win32.sep, path.posix.sep);
-}
-
-// common aliases
-const mimeAliases = {mjs: 'js', cjs: 'js', htm: 'html', jpeg: 'jpg'};
-Object.keys(mimeAliases).forEach(name => (mimeTable[name] = mimeTable[mimeAliases[name]]));
-
-// escape codes to use
-const join = (...args) => args.map(value => value || '').join(''),
-  paint = hasColors
-    ? (prefix, suffix = '\x1B[39m') =>
-        text =>
-          join(prefix, text, suffix)
-    : () => text => text,
-  grey = paint('\x1B[2;37m', '\x1B[22;39m'),
-  red = paint('\x1B[41;97m', '\x1B[49;39m'),
-  green = paint('\x1B[32m'),
-  yellow = paint('\x1B[93m'),
-  blue = paint('\x1B[44;97m', '\x1B[49;39m');
-
-const link = (url, text = url) => paint('\x1B]8;;' + url + '\x1B\\', '\x1B]8;;\x1B\\')(text);
-
-// sending helpers
-
-const sendFile = (req, res, fileName, ext, justHeaders) => {
-  if (!ext) {
-    ext = path.extname(fileName).toLowerCase();
-  }
-  let mime = ext && mimeTable[ext.substring(1)];
-  if (!mime || typeof mime != 'string') {
-    mime = defaultMime;
-  }
-  res.writeHead(200, {'Content-Type': mime});
-  if (justHeaders) {
-    res.end();
-  } else {
-    fs.createReadStream(fileName).pipe(res);
-  }
-  traceCalls && console.log(green('200') + ' ' + grey(req.method) + ' ' + grey(req.url));
-};
-
-const sendJson = (req, res, json, justHeaders) => {
-  res.writeHead(200, {'Content-Type': 'application/json'});
-  if (justHeaders) {
-    res.end();
-  } else {
-    res.end(JSON.stringify(json));
-  }
-  traceCalls && console.log(green('200') + ' ' + grey(req.method) + ' ' + grey(req.url));
-};
-
-const sendRedirect = (req, res, to, code = 307) => {
-  res.writeHead(code, {Location: to});
-  res.end();
-  traceCalls && console.log(blue(code) + ' ' + grey(req.method) + ' ' + grey(req.url));
-};
-
-const bailOut = (req, res, code = 404) => {
-  res.writeHead(code).end();
-  traceCalls && console.log(red(code) + ' ' + grey(req.method) + ' ' + grey(req.url));
-};
-
-// server
-
-const server = http.createServer(async (req, res) => {
-  const method = req.method.toUpperCase();
-  if (method !== 'GET' && method !== 'HEAD') return bailOut(req, res, 405);
-
-  const url = new URL(req.url, 'http://' + req.headers.host);
-  if (url.pathname === '/--tests') {
-    // get tests
-    return sendJson(
-      req,
-      res,
-      toPosix(await resolveTests(rootFolder, 'browser')),
-      method === 'HEAD'
-    );
-  }
-  if (url.pathname === '/--patterns') {
-    // resolve patterns
-    return sendJson(
-      req,
-      res,
-      toPosix(await resolvePatterns(rootFolder, url.searchParams.getAll('q'))),
-      method === 'HEAD'
-    );
-  }
-  if (url.pathname === '/--importmap') {
-    // get import map contents
-    const cfg = await getConfig(rootFolder);
-    return sendJson(req, res, cfg.importmap || {imports: {}}, method === 'HEAD');
-  }
-  if (url.pathname === '/favicon.ico') {
-    const faviconFile = path.join(rootFolder, webAppPath, 'favicon.ico');
-    const stat = await fsp.stat(faviconFile).catch(() => null);
-    if (stat && stat.isFile()) return sendFile(req, res, faviconFile, '.ico', method === 'HEAD');
-    return bailOut(req, res);
-  }
-  if (url.pathname === '/' || url.pathname === '/index' || url.pathname === '/index.html') {
-    // redirect to the web app
-    url.pathname = webAppPath;
-    return sendRedirect(req, res, url.href);
-  }
-
-  if (path.normalize(url.pathname).includes('..')) return bailOut(req, res, 403);
-
-  const fileName = path.join(rootFolder, url.pathname),
-    ext = path.extname(fileName).toLowerCase(),
-    stat = await fsp.stat(fileName).catch(() => null);
-  if (stat && stat.isFile()) return sendFile(req, res, fileName, ext, method === 'HEAD');
-
-  if (stat && stat.isDirectory()) {
-    if (fileName.length && fileName[fileName.length - 1] == path.sep) {
-      const altFile = path.join(fileName, 'index.html'),
-        stat = await fsp.stat(altFile).catch(() => null);
-      if (stat && stat.isFile()) return sendFile(req, res, altFile, '.html', method === 'HEAD');
-    } else {
-      url.pathname += path.posix.sep;
-      return sendRedirect(req, res, url.href);
+const plugins = [];
+let traceCalls = false,
+  h2 = false,
+  remotePlugins = true;
+{
+  const args = process.argv.slice(2);
+  for (let i = 0; i < args.length; ++i) {
+    const arg = args[i];
+    if (arg === '--trace') {
+      traceCalls = true;
+    } else if (arg === '--h2') {
+      h2 = true;
+    } else if (arg === '--no-remote-plugins') {
+      remotePlugins = false;
+    } else if (arg === '--plugin') {
+      if (++i < args.length) plugins.push(args[i]);
+    } else if (arg.startsWith('--plugin=')) {
+      plugins.push(arg.substring('--plugin='.length));
     }
-    return bailOut(req, res);
-  }
-
-  if (!ext && fileName.length && fileName[fileName.length - 1] != path.sep) {
-    const altFile = fileName + '.html',
-      stat = await fsp.stat(altFile).catch(() => null);
-    if (stat && stat.isFile()) return sendFile(req, res, altFile, '.html', method === 'HEAD');
   }
-
-  bailOut(req, res);
-});
-
-server.on('clientError', (error, socket) => {
-  if (error.code === 'ECONNRESET' || !socket.writable) return;
-  socket.end('HTTP/1.1 400 Bad Request\r\n\r\n');
-});
-
-// general setup
+}
 
 const normalizePort = val => {
   const port = parseInt(val);
@@ -240,24 +74,47 @@ const normalizePort = val => {
 const portToString = port => (typeof port === 'string' ? 'pipe' : 'port') + ' ' + port;
 
 const host = process.env.HOST || 'localhost',
-  port = normalizePort(process.env.PORT || '3000');
+  port = normalizePort(process.env.PORT || '3000'),
+  rootFolder = process.env.SERVER_ROOT || process.cwd(),
+  protocol = h2 ? 'h2' : process.env.TAPE6_PROTOCOL || undefined;
+
+const hasColors = detectColors(),
+  paint = makePaint(hasColors),
+  grey = paint('\x1B[2;37m', '\x1B[22;39m'),
+  red = paint('\x1B[41;97m', '\x1B[49;39m'),
+  yellow = paint('\x1B[93m');
+
+const link = (url, text = url) => paint('\x1B]8;;' + url + '\x1B\\', '\x1B]8;;\x1B\\')(text);
 
 try {
-  await startServer(server, {host, port});
-  const bind = portToString(port);
+  const testServer = await createTestServer({
+    rootFolder,
+    webAppPath: process.env.WEBAPP_PATH,
+    host,
+    port,
+    protocol,
+    plugins,
+    remotePlugins,
+    trace: traceCalls
+  });
+  const bind = portToString(testServer.port);
   console.log(
     grey('Listening on ') +
       yellow(host || 'all network interfaces') +
+      yellow(' (' + testServer.protocol + ')') +
       grey(' at ') +
       yellow(bind) +
       grey(', serving static files from ') +
       yellow(rootFolder)
   );
-  if (host && bind) {
+  const mounted = testServer.plugins();
+  if (mounted.length) {
     console.log(
-      grey('Open ') + link('http://' + host + ':' + port + '/') + grey(' in your browser')
+      grey('Plugins: ') +
+        yellow(mounted.map(p => p.name + (p.prefix ? ' (' + p.prefix + ')' : '')).join(', '))
     );
   }
+  console.log(grey('Open ') + link(testServer.base + '/') + grey(' in your browser'));
   console.log();
 } catch (error) {
   if (error.syscall === 'listen') {

package/index.d.ts

@@ -8,11 +8,7 @@
  * - `null` or any primitive — strict equality.
  */
 export type AssertionMatcher =
-  | (new (...args: any[]) => Error)
-  | RegExp
-  | ((value: unknown) => boolean)
-  | object
-  | null;
+  (new (...args: any[]) => Error) | RegExp | ((value: unknown) => boolean) | object | null;
 
 /**
  * Test options
@@ -436,6 +432,15 @@ export declare interface Tester {
    */
   ok(value: unknown, message?: string): void;
 
+  /**
+   * Reports an assertion from an externally captured source `marker`, so the
+   * reported location points at the caller rather than this method. Integration
+   * primitive for the `tape-six-invariant` host adapter; not a user-facing
+   * assertion. With no `operator`/`expected`/`actual` it behaves like `assert`.
+   * @param assertion - the assertion descriptor (verdict, message, marker, info)
+   */
+  reportAssertion(assertion: TesterAssertion): void;
+
   /**
    * Asserts that `value` is not truthy.
    * @param value - The value to test
@@ -1279,4 +1284,31 @@ export declare const after: typeof test.after;
  */
 export declare const registerTesterMethod: (name: string, fn: (...args: any[]) => any) => void;
 
+/**
+ * Descriptor passed to `Tester.reportAssertion`. The verdict comes from `ok`;
+ * `operator`/`expected`/`actual` are optional reporter metadata (omit them for
+ * a plain truthy assertion). Formed by integration code, not end users.
+ */
+export declare interface TesterAssertion {
+  /** Pass/fail verdict — a falsy value fails the assertion. */
+  ok: unknown;
+  /** Message shown on failure. */
+  message?: string;
+  /** An `Error` whose stack locates the assertion's source. */
+  marker?: Error;
+  /** Operator label for the reporter (defaults to `'ok'`). */
+  operator?: string;
+  /** Expected value, for the reporter's diff. */
+  expected?: unknown;
+  /** Actual value, for the reporter's diff. */
+  actual?: unknown;
+}
+
+/**
+ * Returns the innermost currently-running tester (top of the active test
+ * stack), or `null` when no test is executing. Lets ambient code — such as the
+ * `tape-six-invariant` host adapter — route assertions to the current test.
+ */
+export declare const getTester: () => Tester | null;
+
 export default test;

package/index.js

@@ -10,6 +10,7 @@ import {
   getConfiguredFlag,
   setTestRunner,
   registerNotifyCallback,
+  getTester,
   before,
   after,
   beforeAll,
@@ -29,6 +30,16 @@ import {selectTimer} from './src/utils/timer.js';
 import defer from './src/utils/defer.js';
 import TapReporter from './src/reporters/TapReporter.js';
 
+// Must be at module load, not init(): tape-six-invariant snapshots hasHost at
+// import. See dev-docs/sister-assert-library.md.
+globalThis[Symbol.for('tape6.invariant.host.v1')] ||= {
+  version: 1,
+  report(assertion) {
+    const tester = getTester();
+    if (tester) tester.reportAssertion(assertion);
+  }
+};
+
 const optionNames = {
   f: 'failureOnly',
   t: 'showTime',
@@ -271,13 +282,10 @@ const testRunner = async () => {
   if (isBrowser && typeof __tape6_reportResults == 'function') {
     __tape6_reportResults(runHasFailed ? 'failure' : 'success');
   }
-
-  // registerNotifyCallback(testRunner); // register self again
 };
 
 setTestRunner(testRunner);
 if (!getConfiguredFlag()) {
-  // if nobody is running the show
   registerNotifyCallback(testRunner);
 }
 
@@ -291,6 +299,7 @@ export {
   afterAll,
   beforeEach,
   afterEach,
+  getTester,
   test as suite,
   test as describe,
   test as it