Merge commit 'be3e8236086165e5e45a5a10783823874b3f3ebd' as 'lib/vscode'

lib/vscode/src/vs/base/common/errorMessage.ts

@@ -0,0 +1,83 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+import * as nls from 'vs/nls';
+import * as types from 'vs/base/common/types';
+import * as arrays from 'vs/base/common/arrays';
+
+function exceptionToErrorMessage(exception: any, verbose: boolean): string {
+	if (verbose && (exception.stack || exception.stacktrace)) {
+		return nls.localize('stackTrace.format', "{0}: {1}", detectSystemErrorMessage(exception), stackToString(exception.stack) || stackToString(exception.stacktrace));
+	}
+
+	return detectSystemErrorMessage(exception);
+}
+
+function stackToString(stack: string[] | string | undefined): string | undefined {
+	if (Array.isArray(stack)) {
+		return stack.join('\n');
+	}
+
+	return stack;
+}
+
+function detectSystemErrorMessage(exception: any): string {
+
+	// See https://nodejs.org/api/errors.html#errors_class_system_error
+	if (typeof exception.code === 'string' && typeof exception.errno === 'number' && typeof exception.syscall === 'string') {
+		return nls.localize('nodeExceptionMessage', "A system error occurred ({0})", exception.message);
+	}
+
+	return exception.message || nls.localize('error.defaultMessage', "An unknown error occurred. Please consult the log for more details.");
+}
+
+/**
+ * Tries to generate a human readable error message out of the error. If the verbose parameter
+ * is set to true, the error message will include stacktrace details if provided.
+ *
+ * @returns A string containing the error message.
+ */
+export function toErrorMessage(error: any = null, verbose: boolean = false): string {
+	if (!error) {
+		return nls.localize('error.defaultMessage', "An unknown error occurred. Please consult the log for more details.");
+	}
+
+	if (Array.isArray(error)) {
+		const errors: any[] = arrays.coalesce(error);
+		const msg = toErrorMessage(errors[0], verbose);
+
+		if (errors.length > 1) {
+			return nls.localize('error.moreErrors', "{0} ({1} errors in total)", msg, errors.length);
+		}
+
+		return msg;
+	}
+
+	if (types.isString(error)) {
+		return error;
+	}
+
+	if (error.detail) {
+		const detail = error.detail;
+
+		if (detail.error) {
+			return exceptionToErrorMessage(detail.error, verbose);
+		}
+
+		if (detail.exception) {
+			return exceptionToErrorMessage(detail.exception, verbose);
+		}
+	}
+
+	if (error.stack) {
+		return exceptionToErrorMessage(error, verbose);
+	}
+
+	if (error.message) {
+		return error.message;
+	}
+
+	return nls.localize('error.defaultMessage', "An unknown error occurred. Please consult the log for more details.");
+}