[FEATURE] Add fileExport capability

.gitignore

@@ -56,3 +56,4 @@ deploy_key
 
 # Custom directories
 dist/
+test/integration/*/karma-ui5-reports*

README.md

@@ -419,6 +419,29 @@ ui5: {
 }
 ```
 
+### fileExport
+Type: `boolean` or `object`  
+Default: `false`
+
+Configures whether report files provided by tools like the UI5 Support Assistant are exported to the file system.  
+Optionally, an output directory can be set to specify the export path.
+
+Example `boolean`:
+```js
+ui5: {
+  fileExport: true
+}
+```
+
+Example `object`:
+```js
+ui5: {
+  fileExport: {
+    outputDir: "directory/to/export/files"
+  }
+}
+```
+
 ## API
 
 ### helper

lib/client/browser.js

@@ -1,8 +1,55 @@
 const istanbulLibCoverage = require("istanbul-lib-coverage");
 require("./discovery.js");
 
+const patternTestResources = /(?:^|[^?#]*\/)(?:test-)?(?:resources|webapp)\/(.*)/;
+const patternGenericTeststarter = /([^?#]+)\.qunit\.html\?testsuite=test-resources\/((?:[^/]+\/)*testsuite(?:[.a-z0-9]+)?\.qunit)&test=([^&]+)(?:&|$)/;
+const patternSpecificTeststarter = /([^?#]+)\.qunit\.html\?test=([^&]+)(?:&|$)/;
+const patternAnyTest = /([^?#]*)[?#](?:.*)/;
+
+function getTestPageName(qunitHtmlFile) {
+	let matches;
+	let result;
+
+	matches = qunitHtmlFile.match(patternTestResources);
+	if (matches) {
+		qunitHtmlFile = matches[1];
+	}
+
+	matches = qunitHtmlFile.match(patternGenericTeststarter);
+	if (matches) {
+		result = matches[2] + "--" + matches[3];
+	}
+
+	if (!result) {
+		matches = qunitHtmlFile.match(patternSpecificTeststarter);
+		if (matches) {
+			result = matches[1] + "--" + matches[2];
+		}
+	}
+
+	if (!result) {
+		matches = qunitHtmlFile.match(patternAnyTest);
+		if (matches) {
+			result = matches[1];
+		}
+	}
+
+	if (!result) {
+		result = qunitHtmlFile;
+	}
+
+	result = result.replace(/[:*?"<>|]/g, "");
+	result = result.replace(/[\\/]/g, ".");
+	result = result.replace(/\.qunit\.html/g, "");
+	result = result.replace(/\.qunit\./g, "--");
+	result = result.replace(/\.qunit--/g, "--");
+
+	return result;
+}
+
 (function(window) {
 	const karma = window.__karma__;
+	const exportFiles = [];
 
 	function reportSetupFailure(description, error) {
 		karma.info({total: 1});
@@ -166,6 +213,14 @@ require("./discovery.js");
 						// Merge test page coverage into global coverage object
 						if (!accessError) {
 							mergeCoverage(testWindow.contentWindow.__coverage__);
+
+							if (config.fileExport) {
+								const testPageName = getTestPageName(qunitHtmlFile);
+								(testWindow.contentWindow._$files || []).forEach((file) => {
+									file.name = `TEST-${testPageName}-FILE-${file.name}`;
+									exportFiles.push(file);
+								});
+							}
 						}
 
 						// Run next test or trigger completion
@@ -177,7 +232,8 @@ require("./discovery.js");
 							// Also merge coverage results from karma window
 							mergeCoverage(window.__coverage__);
 							karma.complete({
-								coverage: coverageMap ? coverageMap.toJSON() : undefined
+								coverage: coverageMap ? coverageMap.toJSON() : undefined,
+								exportFiles: config.fileExport ? exportFiles : undefined
 							});
 						}
 					}

lib/client/sap-ui-config.js

@@ -1,7 +1,18 @@
 (function(window) {
-	const config = window.__karma__.config;
+	const karma = window.__karma__;
+	const config = karma.config;
 	const ui5config = (config && config.ui5) || {};
 	const bootstrapConfig = ui5config.config || {};
 
 	window["sap-ui-config"] = bootstrapConfig;
+
+	if (ui5config.fileExport) {
+		const originalKarmaComplete = karma.complete.bind(karma);
+		karma.complete = function(result) {
+			if (window._$files) {
+				result.exportFiles = window._$files;
+			}
+			return originalKarmaComplete(result);
+		};
+	}
 })(window);

lib/errors.js

@@ -267,6 +267,35 @@ module.exports = function(config) {
 	});
 };`,
 
+		invalidFileExportReporterUsage: () => `error 21:
+The reporter "ui5--fileExport" should not be manually enabled as a karma reporter.
+You can enable the FileExportReporter in the karma-ui5 settings.
+
+module.exports = function(config) {
+	config.set({
+
+		ui5: {
+			fileExport: true
+		}
+
+	});
+};
+
+Optionally, an output directory can be set to specify the export path.
+
+module.exports = function(config) {
+	config.set({
+
+		ui5: {
+			fileExport: {
+				outputDir: "directory/to/export/files"
+			}
+		}
+
+	});
+};
+`,
+
 		failure: () => "ui5.framework failed. See error message above"
 
 	}

lib/fileExportReporter.js

@@ -0,0 +1,94 @@
+const fs = require("fs").promises;
+const path = require("path");
+const mkdirp = require("mkdirp");
+
+const defaultPath = "./karma-ui5-reports";
+
+async function getUniqueFileName(fileName) {
+	async function fileExists(path) {
+		try {
+			await fs.access(path);
+			return true;
+		} catch (err) {
+			if (err.code === "ENOENT") {
+				return false;
+			}
+			throw err;
+		}
+	}
+
+	const fileExtension = path.extname(fileName);
+	const fileNameWithoutExtension = fileName.slice(0, fileName.lastIndexOf(fileExtension));
+	for (let index = 1; await fileExists(fileName); index++) {
+		fileName = `${fileNameWithoutExtension}_${index}${fileExtension}`;
+	}
+
+	return fileName;
+}
+
+const FileExportReporter = function(baseReporterDecorator, config, logger, helper) {
+	let reporterInProcess = true;
+	let reporterCompleted = function() {};
+	const log = logger.create("reporter.ui5--fileExport");
+	const reporterConfig = config.ui5.fileExport;
+	const multiBrowsers = config.browsers && config.browsers.length > 1;
+	let outputDir = reporterConfig.outputDir;
+
+	if (!outputDir || typeof outputDir !== "string") {
+		outputDir = defaultPath;
+	}
+
+	outputDir = helper.normalizeWinPath(path.resolve(config.basePath, outputDir));
+
+	log.debug("outputDir is: " + outputDir);
+
+	baseReporterDecorator(this);
+
+	async function writeSingleFile(outputFile, content) {
+		log.info(`Writing file: ${outputFile}`);
+		await mkdirp(path.dirname(outputFile));
+		outputFile = await getUniqueFileName(outputFile);
+		try {
+			await fs.writeFile(outputFile, content);
+			log.info(`Saved file '${outputFile}'`);
+		} catch (err) {
+			log.warn("Failed to write file\n\t" + err.message);
+		}
+	}
+
+	this.onBrowserComplete = async function(browser, result) {
+		log.debug("onBrowserComplete triggered.");
+		if (!result || result.error || result.disconnected) {
+			log.debug("skipped due to incomplete test run.");
+			return;
+		}
+
+		if (!result.exportFiles) {
+			log.debug("No export files provided");
+			return;
+		}
+
+		for (const file of result.exportFiles) {
+			const pathSegments = [outputDir, file.name];
+			if (multiBrowsers) {
+				pathSegments.splice(1, 0, browser.name);
+			}
+
+			await writeSingleFile(path.join.apply(null, pathSegments), file.content);
+		}
+		reporterInProcess = false;
+		reporterCompleted();
+	};
+
+	this.onExit = function(done) {
+		if (reporterInProcess) {
+			reporterCompleted = done;
+		} else {
+			done();
+		}
+	};
+};
+
+FileExportReporter.$inject = ["baseReporterDecorator", "config", "logger", "helper"];
+
+module.exports = FileExportReporter;

lib/framework.js

@@ -120,6 +120,7 @@ class Framework {
 		this.config.middleware = config.middleware || [];
 		this.config.files = config.files || [];
 		this.config.beforeMiddleware = config.beforeMiddleware || [];
+		this.config.reporters = this.config.reporters || [];
 
 		if (!this.config.ui5.mode) {
 			this.config.ui5.mode = "html";
@@ -195,6 +196,17 @@ class Framework {
 			throw new Error(ErrorMessage.failure());
 		}
 
+		if (this.config.reporters.includes("ui5--fileExport")) {
+			this.logger.log("error", ErrorMessage.invalidFileExportReporterUsage());
+			throw new Error(ErrorMessage.failure());
+		}
+		if (this.config.ui5.fileExport === true || typeof this.config.ui5.fileExport === "object") {
+			this.config.reporters.push("ui5--fileExport");
+			if (this.config.ui5.fileExport === true) {
+				this.config.ui5.fileExport = {};
+			}
+		}
+
 		this.config.ui5.paths = this.config.ui5.paths || {
 			webapp: "webapp",
 			src: "src",
@@ -247,6 +259,8 @@ class Framework {
 		this.config.client.ui5.failOnEmptyTestPage = this.config.ui5.failOnEmptyTestPage;
 		// Pass configured urlParameters to client
 		this.config.client.ui5.urlParameters = this.config.ui5.urlParameters;
+		// Pass fileExport parameter to client
+		this.config.client.ui5.fileExport = this.config.reporters.includes("ui5--fileExport");
 
 
 		if (this.config.ui5.type === "application") {

lib/index.js

@@ -1,5 +1,6 @@
 const {ErrorMessage} = require("./errors");
 const Framework = require("./framework");
+const FileExportReporter = require("./fileExportReporter");
 
 async function init(config, logger) {
 	try {
@@ -24,5 +25,6 @@ getBeforeMiddleware.$inject = getMiddleware.$inject = ["config.ui5"];
 module.exports = {
 	"framework:ui5": ["factory", init],
 	"middleware:ui5--beforeMiddleware": ["factory", getBeforeMiddleware],
-	"middleware:ui5--middleware": ["factory", getMiddleware]
+	"middleware:ui5--middleware": ["factory", getMiddleware],
+	"reporter:ui5--fileExport": ["type", FileExportReporter]
 };

package.json

@@ -55,7 +55,8 @@
 		"@ui5/server": "^2.3.1",
 		"express": "^4.17.1",
 		"http-proxy": "^1.18.1",
-		"js-yaml": "^4.1.0"
+		"js-yaml": "^4.1.0",
+		"mkdirp": "^1.0.4"
 	},
 	"devDependencies": {
 		"@babel/core": "^7.15.5",