name-Eigenschaft
Aktualisiert: November 2007
Gibt den Namen eines Fehlers zurück.
errorObj.name
Argumente
- errorObj
Erforderlich. Instanz eines Error-Objekts.
Hinweise
Die name-Eigenschaft gibt den Namen oder den Ausnahmetyp eines Fehlers zurück. Wenn ein Laufzeitfehler auftritt, wird für die name-Eigenschaft einer der folgenden systemeigenen Ausnahmetypen festgelegt:
Ausnahmetyp |
Bedeutung |
|---|---|
Error |
Dies ist ein benutzerdefinierter Fehler, der mit dem Error-Objektkonstruktor erstellt wurde. |
ConversionError |
Dieser Fehler tritt immer dann auf, wenn versucht wird, ein Objekt in etwas zu konvertieren, in das es nicht konvertiert werden kann. |
RangeError |
Dieser Fehler tritt auf, wenn bei einer Funktion ein Argument angegeben wird, das den zulässigen Bereich überschritten hat. Beispielsweise tritt dieser Fehler auf, wenn Sie versuchen, ein Array-Objekt mit einer Länge zu erstellen, die keine gültige positive ganze Zahl ist. |
ReferenceError |
Dieser Fehler tritt auf, wenn ein ungültiger Verweis entdeckt wurde. Der Fehler wird beispielsweise ausgegeben, wenn ein erwarteter Verweis null ist. |
RegExpError |
Dieser Fehler tritt auf, wenn bei einem regulären Ausdruck ein Kompilierungsfehler auftritt. Nachdem der reguläre Ausdruck kompiliert wurde, kann dieser Fehler jedoch nicht auftreten. Beispielsweise tritt der Fehler auf, wenn ein regulärer Ausdruck mit einem Muster deklariert wird, das eine ungültige Syntax aufweist, oder wenn er mit anderen Flags als i, g oder m deklariert wird bzw. das gleiche Flag mehr als einmal enthält. |
SyntaxError |
Dieser Fehler tritt auf, wenn Quelltext analysiert wird und nicht die richtige Syntax besitzt. Beispielsweise tritt der Fehler auf, wenn die eval-Funktion mit einem Argument aufgerufen wird, das kein gültiger Programmtext ist. |
TypeError |
Dieser Fehler tritt immer dann auf, wenn der tatsächliche Typ eines Operanden nicht mit dem erwarteten Typ übereinstimmt. Ein Beispiel für das Auftreten dieses Fehlers ist ein Funktionsaufruf für etwas, das kein Objekt ist oder den Aufruf nicht unterstützt. |
URIError |
Dieser Fehler tritt auf, wenn ein ungültiger Uniform Resource Indicator (URI) entdeckt wird. Beispielsweise tritt dieser Fehler auf, wenn in einer zu codierenden oder zu decodierenden Zeichenfolge ein ungültiges Zeichen gefunden wird. |
Beispiel
Das folgende Beispiel bewirkt, dass eine Ausnahme ausgelöst wird. Zusätzlich werden der Fehler und die Beschreibung des Fehlers angezeigt.
function getAge(age) {
if(age < 0)
throw new Error("An age cannot be negative.")
print("Age is "+age+".");
}
// Pass the getAge an invalid argument.
try {
getAge(-5);
} catch(e) {
print(e.name);
print(e.description);
}
Ausgabe dieses Codes:
Error
An age cannot be negative.