jasmine-browser-runner 2.1.0 → 2.2.0

package/lib/server.js

@@ -1,4 +1,4 @@
-const express = require('express'),
+const defaultExpress = require('express'),
   glob = require('glob'),
   ejs = require('ejs'),
   path = require('path'),
@@ -15,6 +15,7 @@ class Server {
    */
   constructor(options) {
     this.options = { ...options };
+    this.express = this.options.express || defaultExpress;
     this.useHtmlReporter =
       options.useHtmlReporter === undefined ? true : options.useHtmlReporter;
     this.projectBaseDir = options.projectBaseDir || path.resolve();
@@ -133,26 +134,40 @@ class Server {
    */
   start(serverOptions) {
     serverOptions = serverOptions || {};
-    const app = express();
+    const app = this.express();
 
-    app.use('/__jasmine__', express.static(this.jasmineCore.files.path));
-    app.use('/__boot__', express.static(this.jasmineCore.files.bootDir));
-    app.use('/__images__', express.static(this.jasmineCore.files.imagesDir));
-    app.use('/__support__', express.static(path.join(__dirname, 'support')));
+    app.use('/__jasmine__', this.express.static(this.jasmineCore.files.path));
+    app.use('/__boot__', this.express.static(this.jasmineCore.files.bootDir));
+    app.use(
+      '/__images__',
+      this.express.static(this.jasmineCore.files.imagesDir)
+    );
+    app.use(
+      '/__support__',
+      this.express.static(path.join(__dirname, 'support'))
+    );
     app.use(
       '/__spec__',
-      express.static(path.join(this.projectBaseDir, this.options.specDir))
+      this.express.static(path.join(this.projectBaseDir, this.options.specDir))
     );
     app.use(
       '/__src__',
-      express.static(path.join(this.projectBaseDir, this.options.srcDir))
+      this.express.static(path.join(this.projectBaseDir, this.options.srcDir))
     );
 
+    if (this.options.middleware) {
+      for (const [path, middleware] of Object.entries(
+        this.options.middleware
+      )) {
+        app.use(path, middleware);
+      }
+    }
+
     if (this.options.importMap) {
       const dir = this.options.importMap.moduleRootDir
         ? path.join(this.projectBaseDir, this.options.importMap.moduleRootDir)
         : this.projectBaseDir;
-      app.use('/__moduleRoot__', express.static(dir));
+      app.use('/__moduleRoot__', this.express.static(dir));
     }
 
     const indexTemplate = ejs.compile(

package/lib/types.js

@@ -132,6 +132,29 @@
  * @type boolean | undefined
  * @default false
  */
+/**
+ * <p>An optional map from paths to Express application middleware to mount on
+ * those paths. This can be used to serve static files, proxy requests to
+ * another server, etc.
+ * <p>Note: Requests made by jasmine-browser-runner (e.g. /, /__jasmine__/*,
+ * /__spec__/*, etc) are considered private APIs for semver purposes. If you
+ * configure middleware that modifies these requests and responses, there is a
+ * possibility that future jasmine-browser-runner releases, including minor and
+ * patch releases, may be incompatible with that middleware.
+ * @example
+ * // jasmine-browser.js
+ * const express = require('express');
+ *
+ * module.exports = {
+ *   // ...
+ *   middleware: {
+ *     '/assets': express.static('./path/to/assets')
+ *   }
+ * }
+ * @name Configuration#middleware
+ * @type object | undefined
+ * @default undefined
+ */
 
 /**
  * Describes a web browser.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jasmine-browser-runner",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Serve and run your Jasmine specs in a browser",
   "bin": "bin/jasmine-browser-runner",
   "exports": "./index.js",