Error.create-Funktion
Aktualisiert: November 2007
Erstellt ein Error-Objekt, das zusätzliche Fehlerinformationen enthalten kann.
var err = Error.create(message, errorInfo);
Argumente
message
(Optional) Eine Fehlermeldungszeichenfolge.errorInfo
(Optional) Eine Instanz eines JavaScript-Objekts, das erweiterte Informationen über den Fehler enthält. Das Objekt muss über ein name-Feld verfügen, das eine Zeichenfolge enthält, die den Fehler identifiziert. Das Objekt kann auch Felder enthalten, um den Fehler vollständig zu beschreiben.
Rückgabewert
Ein Error-Objekt.
Hinweise
Verwenden Sie die create-Funktion zum Erstellen eines Error-Objekts, das zusätzliche Fehlerinformationen enthalten kann. Mit dem message-Argument können Sie Informationen an den Fehler anfügen, die bei Auftreten des Fehlers in einer Anwendung angezeigt werden können, oder Details für das Nachverfolgen von Fehlern bereitstellen. Mithilfe des errorInfo-Arguments können Sie dem durch die Funktion erstellten Error-Objekt Fehlerinformationen als Felder hinzufügen. Dies ermöglicht es Ihnen, benutzerdefinierte Fehlerinformationen festzulegen, in denen der Fehler ausführlicher beschrieben wird. Das von Ihnen bereitgestellte JavaScript-Objekt muss über ein Feld mit dem Namen name verfügen, das eine Zeichenfolge zur Identifizierung des Fehlers enthält. Im errorInfo-Objekt können Sie zusätzliche Felder mit einem beliebigen Typ und Namen bereitstellen, was bei der benutzerdefinierten Ausnahmebehandlung von Vorteil ist.
Beispiel
Im folgenden Beispiel wird gezeigt, wie mithilfe der create-Funktion ein neues Error-Objekt erstellt wird. Es werden drei Fehler erstellt. Der erste Fehler ist eine Sys.ArgumentTypeException-Ausnahme. Der zweite Fehler stellt eine Meldungszeichenfolge bereit, die im message-Argument übergeben wird. Der dritte Fehler stellt eine Fehlermeldungszeichenfolge und ein Objekt bereit, die im errorInfo-Argument übergeben werden. Das errorInfo-Objekt stellt das erforderliche name-Feld bereit, durch das der Fehler identifiziert wird, sowie ein zusätzliches Feld, in dem der Fehler beschrieben wird.
function throwAnError(input)
{
if (input === undefined)
{
// Throw a standard exception type.
var err = Error.argumentNull("input", "A parameter was undefined.");
throw err;
}
else if (input === "Test1")
{
// Throw a generic error with a message.
var messageVar = "A test message.";
var err = Error.create(messageVar)
throw err;
}
else if (input === "Test2")
{
// Throw a generic error with a message and associated errorInfo object.
var messageVar = "This error contains an additional custom errorInfo object";
var errorInfoObj = { name: "SomeNamespace.SomeExceptionName", someErrorID: "436" };
var err = Error.create(messageVar, errorInfoObj);
throw err;
}
alert("No error occured.");
}
throwAnError("Test2");
Siehe auch
Konzepte
Übersicht über das Debuggen und die Ablaufverfolgung von AJAX-Anwendungen