Introducing new Error types:

- replaced DKIM_InternalError by DKIM_TempError, DKIM_Error or Error
- changed string building for error messages for better readability
- fixed an error in German translation

chrome/content/dkim.js

@@ -178,7 +178,7 @@ DKIM_Verifier.Display = (function() {
 	function handleException(e) {
 		try {
 			// log error
-			if (e instanceof DKIM_Verifier.DKIM_InternalError) {
+			if (e instanceof DKIM_Verifier.DKIM_TempError) {
 				log.error(e);
 			} else {
 				log.fatal(e);
@@ -207,6 +207,7 @@ DKIM_Verifier.Display = (function() {
 	 *
 	 * @param {IAuthVerifier.IAuthResult} result
 	 * @return {void}
+	 * @throws {Error}
 	 */
 	// eslint-disable-next-line complexity
 	function displayResult(result) {
@@ -248,8 +249,7 @@ DKIM_Verifier.Display = (function() {
 				highlightHeader("nosig");
 				break;
 			default:
-				throw new DKIM_Verifier.DKIM_InternalError("unknown res_num: " +
-					result.dkim[0].res_num);
+				throw new Error(`unknown res_num: ${result.dkim[0].res_num}`);
 		}
 
 		// policyAddUserExceptionButton

chrome/locale/de/dkim.properties

@@ -10,7 +10,7 @@ NOT_EMAIL = Keine E-Mail
 # DKIM_INTERNALERROR
 DKIM_INTERNALERROR							= DKIM Verifier: Interner Fehler
 DKIM_INTERNALERROR_NAME						= Interner Fehler
-DKIM_INTERNALERROR_DEFAULT					= Fehler";
+DKIM_INTERNALERROR_DEFAULT					= Fehler
 DKIM_INTERNALERROR_INCORRECT_EMAIL_FORMAT	= E-Mail ist nicht richtig formatiert
 DKIM_INTERNALERROR_INCORRECT_FROM			= Absenderadresse ist falsch formatiert
 # DKIM_INTERNALERROR - DNS

modules/ARHParser.jsm.js

@@ -15,7 +15,7 @@
 
 // options for ESLint
 /* global Components, Services */
-/* global Logging, DKIM_InternalError */
+/* global Logging, DKIM_Error */
 /* exported EXPORTED_SYMBOLS, ARHParser */
 
 "use strict";
@@ -132,6 +132,7 @@ let ARHParser = {
 	 *  
 	 *  @param {String} authresHeader Authentication-Results header
 	 *  @return {ARHHeader} Parsed Authentication-Results header
+	 *  @throws {DKIM_Error}
 	 */
 	parse: function _ARHParser_parse(authresHeader) {
 		// remove header name
@@ -148,7 +149,7 @@ let ARHParser = {
 		reg_match = match(authresHeaderRef, `${value_cp}(?:${CFWS_p}([0-9]+)${CFWS_op})?`);
 		const authserv_id = reg_match[1] || reg_match[2];
 		if (!authserv_id) {
-			throw new Error("Error matching the ARH authserv-id.");
+			throw new DKIM_Error("Error matching the ARH authserv-id.");
 		}
 		res.authserv_id = authserv_id;
 		if (reg_match[3]) {
@@ -182,6 +183,7 @@ let ARHParser = {
  *  
  *  @param {RefString} str
  *  @return {ARHResinfo|null} Parsed resinfo
+ *  @throws {DKIM_Error|Error}
  */
 function parseResinfo(str) {
 	log.trace("parse str: " + str.toSource());
@@ -210,10 +212,10 @@ function parseResinfo(str) {
 		throw exception;
 	}
 	if (!reg_match[1]) {
-		throw new Error("Error matching the ARH method.");
+		throw new DKIM_Error("Error matching the ARH method.");
 	}
 	if (!reg_match[3]) {
-		throw new Error("Error matching the ARH result.");
+		throw new DKIM_Error("Error matching the ARH result.");
 	}
 	res.method = reg_match[1];
 	if (reg_match[2]) {
@@ -247,10 +249,10 @@ function parseResinfo(str) {
 	res.propertys.policy = {};
 	while ((reg_match = match_o(str, propspec_p)) !== null) {
 		if (!reg_match[1]) {
-			throw new Error("Error matching the ARH property name.");
+			throw new DKIM_Error("Error matching the ARH property name.");
 		}
 		if (!reg_match[2]) {
-			throw new Error("Error matching the ARH property sub-name.");
+			throw new DKIM_Error("Error matching the ARH property sub-name.");
 		}		
 		let property = res.propertys[reg_match[1]];
 		if (!property) {
@@ -272,7 +274,7 @@ function parseResinfo(str) {
  * @param {string} method
  * @param {string} resultKeyword
  * @returns {void}
- * @throws {DKIM_InternalError} if result keyword is invalid for the method.
+ * @throws {DKIM_Error} if result keyword is invalid for the method.
  */
 function checkResultKeyword(method, resultKeyword) {
 	let allowedKeywords;
@@ -307,7 +309,7 @@ function checkResultKeyword(method, resultKeyword) {
 	// And don't restrict the keyword.
 
 	if (allowedKeywords && !allowedKeywords.includes(resultKeyword)) {
-		throw new DKIM_InternalError(`Result keyword "${resultKeyword}" is not allowed for method "${method}"`);
+		throw new DKIM_Error(`Result keyword "${resultKeyword}" is not allowed for method "${method}"`);
 	}
 }
 
@@ -343,13 +345,13 @@ class RefString {
  *  @param {RefString} str
  *  @param {String} pattern
  *  @return {String[]} An Array, containing the matches
- *  @throws if match no match found
+ *  @throws {DKIM_Error} if match no match found
  */
 function match(str, pattern) {
 	const reg_match = match_o(str, pattern);
 	if (reg_match === null) {
 		log.trace("str to match against:" + str.toSource());
-		throw new Error("Parsing error");
+		throw new DKIM_Error("Parsing error");
 	}
 	return reg_match;
 }

modules/AuthVerifier.jsm.js

@@ -16,7 +16,7 @@
 // options for ESLint
 /* global Components, Services, MailServices */
 /* global Logging, ARHParser */
-/* global PREF, dkimStrings, domainIsInDomain, getDomainFromAddr, tryGetFormattedString, DKIM_InternalError */
+/* global PREF, dkimStrings, domainIsInDomain, getDomainFromAddr, tryGetFormattedString */
 /* exported EXPORTED_SYMBOLS, AuthVerifier */
 
 "use strict";
@@ -239,6 +239,7 @@ var AuthVerifier = {
  * @param {nsIMsgDBHdr} msgHdr
  * @param {Object} msg
  * @return {SavedAuthResult|Null}
+ * @throws Error
  */
 // eslint-disable-next-line complexity
 function getARHResult(msgHdr, msg) {
@@ -351,7 +352,7 @@ function getARHResult(msgHdr, msg) {
 					case 2: // ignore
 						break;
 					default:
-						throw new DKIM_InternalError("invalid error.algorithm.sign.rsa-sha1.treatAs");
+						throw new Error("invalid error.algorithm.sign.rsa-sha1.treatAs");
 				}
 			}
 		}
@@ -405,6 +406,7 @@ function saveAuthResult(msgHdr, savedAuthResult) {
  * 
  * @param {nsIMsgDBHdr} msgHdr
  * @return {SavedAuthResult|Null} savedAuthResult
+ * @throws {Error}
  */
 function loadAuthResult(msgHdr) {
 	if (prefs.getBoolPref("saveResult")) {
@@ -457,8 +459,7 @@ function loadAuthResult(msgHdr) {
 				return savedAuthResult;
 			}
 
-			throw new DKIM_InternalError("AuthResult result has wrong Version (" +
-				savedAuthResult.version + ")");
+			throw new Error(`AuthResult result has wrong Version (${savedAuthResult.version})`);
 		}
 	}
 
@@ -470,6 +471,7 @@ function loadAuthResult(msgHdr) {
  * 
  * @param {ARHResinfo} arhDKIM
  * @return {dkimSigResultV2}
+ * @throws {Error}
  */
 function arhDKIM_to_dkimSigResultV2(arhDKIM) {
 	/** @type {dkimSigResultV2} */
@@ -504,8 +506,7 @@ function arhDKIM_to_dkimSigResultV2(arhDKIM) {
 			}
 			break;
 		default:
-			throw new DKIM_InternalError("invalid dkim result in arh: " +
-				arhDKIM.result);
+			throw new Error(`invalid dkim result in arh: ${arhDKIM.result}`);
 	}
 
 	let sdid = arhDKIM.propertys.header.d;
@@ -561,7 +562,7 @@ function dkimResultV1_to_dkimSigResultV2(dkimResultV1) {
  * 
  * @param {dkimSigResultV2} dkimSigResult
  * @return {AuthResultDKIM}
- * @throws DKIM_InternalError
+ * @throws {Error}
  */
 function dkimSigResultV2_to_AuthResultDKIM(dkimSigResult) { // eslint-disable-line complexity
 	/** @type {IAuthVerifier.AuthResultDKIM} */
@@ -692,7 +693,7 @@ function dkimSigResultV2_to_AuthResultDKIM(dkimSigResult) { // eslint-disable-li
 			authResultDKIM.result_str = dkimStrings.getString("NOSIG");
 			break;
 		default:
-			throw new DKIM_InternalError("unknown result: " + dkimSigResult.result);
+			throw new Error(`unknown result: ${dkimSigResult.result}`);
 	}
 
 	return authResultDKIM;

modules/DNSWrapper.jsm.js

@@ -17,7 +17,7 @@
 
 // options for ESLint
 /* global Components, Services, XPCOMUtils */
-/* global Logging, PREF, JSDNS, libunbound, DKIM_InternalError */
+/* global Logging, PREF, JSDNS, libunbound, DKIM_TempError */
 /* exported EXPORTED_SYMBOLS, DNS */
 
 "use strict";
@@ -86,12 +86,13 @@ var DNS = {
 	 * @param {String} [rrtype="TXT"]
 	 * 
 	 * @return {Promise<DNSResult>}
+	 * @throws {DKIM_TempError|Error}
 	 */
 	resolve: async function DNS_resolve(name, rrtype="A") {
 
 		// @ts-expect-error
 		if (Services.netUtils.offline) {
-			throw new DKIM_InternalError(null, "DKIM_DNSERROR_OFFLINE");
+			throw new DKIM_TempError("DKIM_DNSERROR_OFFLINE");
 		}
 
 		switch (prefs.getIntPref("resolver")) {
@@ -143,6 +144,7 @@ var DNS = {
  * @param {string} name
  * @param {string} rrtype
  * @return {Promise<DNSResult>}
+ * @throws {DKIM_TempError}
  */
 function asyncJSDNS_QueryDNS(name, rrtype) {
 	function dnsCallback(dnsResult, defer, queryError, rcode) {
@@ -159,7 +161,7 @@ function asyncJSDNS_QueryDNS(name, rrtype) {
 				result.rcode = RCODE.NoError;
 			}
 			if (result.rcode !== RCODE.NoError && queryError) {
-				throw new DKIM_InternalError(queryError, "DKIM_DNSERROR_SERVER_ERROR");
+				throw new DKIM_TempError("DKIM_DNSERROR_SERVER_ERROR");
 			}
 			result.secure = false;
 			result.bogus = false;

modules/MsgReader.jsm.js

@@ -16,7 +16,7 @@
 // options for ESLint
 /* global Components */
 /* global Logging */
-/* global Deferred, DKIM_InternalError */
+/* global Deferred, DKIM_Error */
 /* exported EXPORTED_SYMBOLS, MsgReader */
 
 "use strict";
@@ -50,7 +50,7 @@ var MsgReader = {
 	 *
 	 * @param {String} msgURI
 	 * @return {Promise<{headerPlain: string, bodyPlain: string}>}
-	 * @throws DKIM_InternalError
+	 * @throws {Error}
 	 */
 	read: function _MsgReader_read(msgURI) {
 		/** @type {IDeferred<{headerPlain: string, bodyPlain: string}>} */
@@ -98,8 +98,7 @@ var MsgReader = {
 					if (posEndHeader === -1) {
 						// in this case, the message has no body, but headers must end with a newline
 						if (!str.endsWith("\r\n")) {
-							throw new DKIM_InternalError("Message is not in correct e-mail format",
-								"DKIM_INTERNALERROR_INCORRECT_EMAIL_FORMAT");
+							throw new Error("Message is not in correct e-mail format");
 						}
 						res.headerPlain = str;
 						res.bodyPlain = "";
@@ -138,6 +137,7 @@ var MsgReader = {
 	 * @return {Map}
 	 *           key: {String} <header name>
 	 *           value: {Array[String]}
+	 * @throws {DKIM_Error}
 	 */
 	parseHeader: function _MsgReader_parseHeader(headerPlain) {
 		var headerFields = new Map();
@@ -157,8 +157,7 @@ var MsgReader = {
 				}
 				headerFields.get(hName).push(headerArray[i]+"\r\n");
 			} else {
-				throw new DKIM_InternalError("Could not split header into name and value",
-					"DKIM_INTERNALERROR_INCORRECT_EMAIL_FORMAT");
+				throw new DKIM_Error("Could not split header into name and value");
 			}
 		}
 

modules/SQLiteTreeView.jsm.js

@@ -61,7 +61,7 @@ class SQLiteTreeView {
 
 		// test that db exists
 		if (!this.file.exists()) {
-			throw new Error("SQLite File "+path+" must exist");
+			throw new Error(`SQLite File ${path} must exist`);
 		}
 
 		this.tableName = tableName.replace(/\W/g, "");
@@ -346,7 +346,7 @@ class SQLiteTreeView {
 
 			// test that table exists
 			if (!this.conn.tableExists(this.tableName)) {
-				throw new Error("Table "+this.tableName+" must exist");
+				throw new Error(`Table ${this.tableName} must exist`);
 			}
 
 			if ( treeBox.columns.count !== this.columns.length) {